DlgDelete

Delete text selection from current editText item

#include <Dialogs.h> Dialog Manager

void DlgDelete(theDialog );

DialogPtr theDialog ; identifies dialog window

DlgDelete deletes the currently-selected text in the current editText item of

a dialog. It is a quick way to process a delete or clear command (B) event

for a dialog.

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

the item to which the delete 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 TEDelete 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, this call is functionally equivalent to:

DialogPeek theDlgPeek;

theDlgPeek = (DialogPeek) theDialog;

if ( theDlgPeek -> editField > 0 ) {

TEDelete( 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, P, 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 (10):