XmDataFieldPaste - Man Page

A DataField function that inserts the clipboard selection

Synopsis

#include <Xm/DataF​.h>
Boolean XmDataFieldPaste(
Widget widget);

Description

XmDataFieldPaste 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​.

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​. 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​.

widget

Specifies the DataField widget ID​.

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

Return

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