.. highlightlang:: us

.. index:: EdCut

.. _edcut:

EdCut
=====

.. us.tag  EdCut ENGLISH EdSet

:ref:`EdCut` deletes the current editor selection and copies the deleted text to
the clipboard.

.. function::  bool = EdCut(hEdit)

.. us.return

**Return Value**

If the function succeeds, the return value is TRUE (1); otherwise it is FALSE (0).

.. us.params

**Parameters**

.. uparam:: hEdit

   Identifies the editor.

.. us.comment

**Comment**

The deletion performed by :ref:`EdCut` can be undone by calling the :ref:`EdUndo`
function.

To delete the current selection without placing the deleted text into the
clipboard, call the :ref:`EdClear` function.

.. seealso::
   :ref:`overview-editors`,
   :ref:`EdUndo`,
   :ref:`EdClear`,
   :ref:`EdCreate`,
   :ref:`EdSetSel`

:sub:`id-712207`