DlgCut

Cut selected text from current editText item

#include <Dialogs.h> Dialog Manager

void DlgCut(theDialog );

DialogPtr theDialog ; identifies dialog window with text to cut

DlgCut copies the current selection of the current editText item of a dialog

into the TextEdit scrap and removes it from the edit record and the screen. It

is a quick way to process a cut command (X) for a dialog.

theDialog is the address of a DialogRecord. It identifies the dialog containing

the item to which the cut operation should be applied.

Notes: If the current dialog contains no editText items, or if none is active, this

function does nothing. Otherwise, it performs a TECut on the

currently-selected text.

The item number-1 of the active editText field is kept in the editField field

of the DialogRecord and a handle to its TERec is kept in the textH field.

Thus, DlgCut is functionally equivalent to:

DialogPeek theDlgPeek;

theDlgPeek = (DialogPeek) theDialog;

if ( theDlgPeek -> editField > 0 ) {

TECut( theDlgPeek->textH );

}

In a modal dialog, DlgCut, DlgCopy, DlgPaste, and DlgDelete are

typically performed in a filter function (see ModalDialog). In a modeless

dialog, you should check for X, C, V, and B by examining the event

record after calling IsDialogEvent and when present, use the DlgXxx calls

You do not need to support cut-and-paste in editText items, but since it is

easy to do, it is recommended.

Referenced by (12):