PhClipboardPasteString()

Paste string-only data from the clipboard

Synopsis:

char *PhClipboardPasteString( unsigned short ig );

Library:

ph

Description:

This function is a simple cover function for pasting string-only data from the clipboard. The function calls PhClipboardRead(), and requests data of type TEXT.

Each input group has its own private clipboard, which can be selected through the ig parameter. To determine the current input group, call PhInputGroup(), passing to it the event that triggered the clipboard operation (e.g. cbinfo->event).

This function allocates the resultant string with strdup(). Your application must free() this memory after use.

Returns:

A pointer to the text string extracted from the clipboard, or NULL if there was no available data or an error occurred.

Classification:

Photon

See also:

PhClipboardCopyString(), PhClipboardHdr, PhClipboardPasteString(), PhClipboardRead, PhClipboardWrite

strdup(), free() in the QNX Neutrino Library Reference