DwtInquireNextPasteCount(3Dwt) DwtInquireNextPasteCount(3Dwt)
Name
DwtInquireNextPasteCount - Returns the number of data item formats available for the next paste item in the clipboard.
Syntax
int DwtInquireNextPasteCount(display, window, count,
max_format_name_length)
Display *display;
Window window;
int *count;
int *max_format_name_length;
Arguments
display Specifies a pointer to the Display structure that was returned in a previous call to XOpenDisplay. For information on XOpenDis-
play and the Display structure, see the Guide to the Xlib Library: C Language Binding.
window Specifies the window ID that relates the application window to the clipboard. The same application instance should pass the same
window ID to each clipboard function that it calls.
count Returns the number of data item formats available for the next-paste item in the clipboard. If no formats are available, this
argument equals zero. The count includes the formats that were passed by name.
max_format_name_length
Specifies the maximum length of all format names for the next-paste item in the clipboard.
Description
The DwtInquireNextPasteCount function returns the number of data item formats available for the next-paste item in the clipboard. This
function also returns the maximum name length for all formats in which the next-paste item is stored.
Return Values
This function returns one of these status return constants:
ClipboardSuccess The function is success-
ful.
ClipboardLocked The function failed
because the clipboard was
locked by another appli-
cation. The application
can continue to call the
function with the same
parameters until the
clipboard is unlocked.
Optionally, the applica-
tion can ask if the user
wants to keep trying or
to give up on the opera-
tion.
ClipboardNoData Information could not be
obtained from an applica-
tion using the ICCCM
clipboard selection mech-
anism. This return value
indicates that the data
was not available in the
requested format.
See Also
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding
DwtInquireNextPasteCount(3Dwt)