DtEditorCutToClipboard(library call)   DtEditorCutToClipboard(library call)




 NAME    [Toc]    [Back]
      DtEditorCutToClipboard - copy the primary selection in a DtEditor
      widget to the clipboard and delete the selected text

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Editor.h>
      Boolean DtEditorCutToClipboard(
      Widget widget);

 DESCRIPTION    [Toc]    [Back]
      The DtEditorCutToClipboard function copies the primary selected text
      in the DtEditor widget, specified by the widget, argument 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    [Toc]    [Back]
      Upon successful completion, the DtEditorCutToClipboard function
      returns True; otherwise, if the primary selection is NULL, or if the
      widget doesn't own the primary selection, or if the function is unable
      to gain ownership of the clipboard selection, it returns False.

 SEE ALSO    [Toc]    [Back]
      Dt/Editor.h - DtEditor(5), DtEditor(3), DtEditorClearSelection(3),
      DtEditorCopyToClipboard(3), DtEditorDeleteSelection(3),
      DtEditorDeselect(3), DtEditorPasteFromClipboard(3),
      DtEditorSelectAll(3), DtEditorUndoEdit(3).


                                    - 1 -       Formatted:  January 24, 2005