wait_for_text


Description:

public string? wait_for_text ()

Requests the contents of the clipboard as text and converts the result to UTF-8 if necessary.

This function waits for the data to be received using the main loop, so events, timeouts, etc, may be dispatched during the wait.

Parameters:

this

a Clipboard

Returns:

a newly-allocated UTF-8 string which must be freed with g_free, or null if retrieving the selection data failed. (This could happen for various reasons, in particular if the clipboard was empty or if the contents of the clipboard could not be converted into text form.)