XmTextPaste - Man Page

A Text function that inserts the clipboard selection

Synopsis

#include <Xm/Text​.h>
Boolean XmTextPaste(
Widget widget);

Description

XmTextPaste inserts the clipboard selection at the insertion cursor of the destination widget​. If XmNpendingDelete is True and the insertion cursor is inside the current selection, the clipboard selection replaces the selected text​.

This routine calls the widget​'s XmNvalueChangedCallback and verification callbacks, either XmNmodifyVerifyCallback or XmNmodifyVerifyCallbackWcs, or both​. If both verification callback lists are registered, the procedures of the XmNmodifyVerifyCallback list are executed first and the resulting data is passed to the XmNmodifyVerifyCallbackWcs callbacks​. If the XmNcursorPosition resource is greater than or is the same value as the position where the selection is to be inserted, the XmNmotionVerifyCallback is called​.

This routine calls the widget​'s XmNdestinationCallback procedures with the selection member of the XmDestinationCallbackStruct set to CLIPBOARD and with the operation member set to XmCOPY​.

widget

Specifies the Text widget ID​.

For a complete definition of Text and its associated resources, see XmText(3)​.

Return

This function returns False if no transfers take place​. Otherwise, it returns True​.