Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
Motif and Common Desktop Environment: Style Guide Reference > Motif and CDE Reference Topics (A - F)

Direct Editing

» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

Direct Editing — Reference

Description

Direct editing is a mode of interaction in which the contents of a normally noneditable textual label is made available for editing.

When to Use

Recommended

Support a direct editing mode if the user wants to modify a textual label.

Recommended

Support direct editing of any label that names a selectable element.

Guidelines

Recommended

While in direct editing mode, show focus emphasis on the label being edited.

Recommended

Treat the textual label as a text-entry field when operating on it in direct editing mode.

Entering Direct Editing Mode
Required

If direct editing mode is supported for a textual label, enter the mode when the user clicks the SELECT button on the label or when the user double-clicks the SELECT button, if (single) clicking the SELECT button is already used for some other purpose (for example, margin selection).

Required

If direct editing mode is supported for a textual label, provide some means for keyboard users to edit the label as well (for example, by choosing an action from a menu that displays a window in which such labels can be edited via a text-entry field).

Required

Use a persistent selection to select the entire text of the label when entering direct editing mode.

Recommended

If you support direct editing of a label that names a selectable element, associate a pop-up menu with the element, include a Properties choice in the pop-up menu, and include a text-entry field in the properties window through which the label can be changed.

Recommended

When focus is on a static text control, provide a means to enter direct editing mode from the keyboard, for example, by including a Rename choice on a pop-up menu that initiates direct editing.

Exiting from Direct Editing Mode
Required

Exit from direct editing mode when the user presses Enter or keypadEnter.

Required

Exit from direct editing mode and undo any changes made to the text being edited when the user presses Cancel.

Required

When the user exits from direct editing mode, deselect the text in the label.

Required

When the user exits from direct editing mode without explicitly moving focus elsewhere, and the focus remains in the window or is moved back to it, place the active cursor as follows:

  • If a static text control is being directly edited, place the active cursor on it.

  • If the label being directly edited is associated with all or part of another element (for example, an icon) that can be cursored with an element cursor, move the active cursor to that element.

  • If the label being directly edited is a group heading, navigate to the group.

  • If none of the previous statements apply, the active cursor should return to where it was before entering direct editing mode.

Required

During direct editing, mouse buttons have their usual effect, and all operations on other controls except those that transfer data to the label cause direct editing mode to exit.

Required

During direct editing, keyboard-based window navigation should exit from direct editing mode and move focus to the window indicated.

Required

During direct editing, control navigation should not be supported.

Required

During direct editing, tab-group navigation should exit from direct editing mode and allow navigation elsewhere, but only in the following cases:

  • When a static text control is being directly edited, tab group navigation should allow navigation in the same way as when the control ordinarily has focus.

  • If the label being directly edited is associated with all or part of another element (for example, an icon) that can be cursored with an element cursor, tab navigation should tab away from that element.

  • If the label being directly edited is a group heading, allow tab navigation to tab away from the group.

Essential Related Topics

For more information, see the Label and Selection reference pages.

Supplemental Related Topics

For more information, see the Choice, Push Button (Control), and Text-Entry Field (Control) reference pages.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© Hewlett-Packard Development Company, L.P.