NAME
XmuConvertStandardSelection − convert to standard selection target types.
SYNOPSIS
#include <X11/Xmu/StdSel.h>
Boolean XmuConvertStandardSelection(w, time, selection, target, type, value, length, format)
Widget w;
Time time;
Atom ∗selection, ∗target, ∗type;
caddr_t ∗value;
unsigned long ∗length;
int ∗format;
Inputs
wSpecifies the widget that currently owns the selection.
timeSpecifies the time at which the selection was established.
selectionThis argument is unused.
targetSpecifies the target type for the conversion.
Outputs
typeReturns the property type of the converted value.
valueReturns the converted value.
lengthReturns the number of elements in the converted value.
formatReturns the size in bits of the elements of the converted value.
Returns
True if the conversion was successful; False otherwise.
DESCRIPTION
XmuConvertStandardSelection() converts the selection to the following standard targets: CLASS, CLIENT_WINDOW, DECNET_ADDRESS, HOSTNAME, IP_ADDRESS, NAME, OWNER_OS, TARGETS, TIMESTAMP, and USER. It returns True if the conversion was successful, and False if it failed.
XmuConvertStandardSelection() allocates memory for the returned value. The client should free this memory by calling XtFree().
USAGE
XmuConvertStandardSelection() converts to the "housekeeping" target types that do not have anything to do with the actual value of the selection. It is particularly useful within an XtConvertSelectionProc registered with a call to XtOwnSelection(). The returned type, value, length, and format can be used directly by that conversion procedure. Note that when this function is used to convert the TARGETS target, it returns only the list of targets that it supports itself. The selection conversion procedure that called it will have to append its own supported targets to this list.