NAME

DtEditorCutToClipboard − copy the primary selection in a DtEditor widget to the clipboard and delete the selected text

SYNOPSIS

#include <Dt/Editor.h>
Boolean DtEditorCutToClipboard(Widget widget);

DESCRIPTION

The DtEditorCutToClipboard() function copies the primary selected text in the DtEditor widget, specified by widget, to the clipboard and then deletes the primary selected text. Text can be selected and deselected programmatically with DtEditorSelectAll(3) and DtEditorDeselect(3). 

The widget argument specifies the DtEditor widget ID. 

For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3). 

RETURN VALUE

???? Component owner: this is the required wording format for RETURN VALUE; I’ve altered your original - please be sure to check this ????
Upon successful completion, the DtEditorCutToClipboard() function returns False if the primary selection is NULL, if the widget doesn’t own the primary selection, or if the function is unable to gain ownership of the clipboard selection; otherwise, it returns True. 

SEE ALSO

DtEditor(5), DtEditor(3), DtEditorClearSelection(3), DtEditorCopyToClipboard(3), DtEditorDeleteSelection(3), DtEditorDeselect(3), DtEditorPasteFromClipboard(3), DtEditorSelectAll(3), DtEditorUndoEdit(3). 
 
 
 
 
 
 
 

  —  3 May 1994