[ Previous | Next | Contents | Glossary | Home | Search ]
Motif and CDE 2.1 Style Guide Reference

Size (Choice)

Reference

Description

Size is an action choice that allows a user to change the size of a window or of specified elements.

When to Use

Required
Include the Size choice on the window menu if and only if the size of the window can be changed.

Recommended
Include the Size choice on the Edit menu to allow elements to be resized without requiring use of the mouse buttons.

Guidelines

Required
If the Size choice is included on the Window menu (in the menu bar) do not make it available on the window menu.

Required
If sizing borders or handles are not automatically displayed for an element or group of elements when they are selected, display them when the user chooses Size, and remove them when the Size operation is completed.

Required
When the user selects Size from a pop-up menu on a sizing border or handle, begin sizing the corner or edge to which it corresponds.

Required
When sizing handles are used and the user selects Size from a menu, other than one popped up on a handle, wait until the user does one of the following:

  1. Clicks the SELECT button or presses SELECT and moves the pointer on a sizing handle, which initiates sizing of the corresponding corner or edge

  2. Presses a directional key

    3. Required
    When sizing borders are used and the user selects Size from a menu, other than one popped up on a border, and either the pointer position after choosing Size is not within the area bounded by the sizing border or pointer warping is not enabled, then wait until the user does one of the following:

    1. Moves the pointer into the area bounded by the sizing borders

    2. Presses a directional key

      3. Required
      When sizing borders are used and the user selects Size from a menu, other than one popped up on a border, warp the pointer to the center of the area bounded by the sizing border when the following is true:

      1. The pointer position after choosing Size is not within the area bounded by the sizing border

      2. Pointer warping is enabled

        3. Required
        When the pointer is within the area bounded by the sizing border but the corner or edge to be used for sizing is not yet determined, then the first border touched by the pointer determines the corner or edge to be used for sizing.

        Required
        If the corner or edge to be resized is not determined, then when the user presses a directional key, determine the edge to be resized (for example, when the user presses ^, choose the top edge, and so on), but do not move the edge.

        Required
        If an edge to be resized has been determined, when the user presses a directional key corresponding to the orthogonal direction, begin resizing the corner between them, but do not move it. (For example, if the left edge is being resized and the user types ^, begin resizing the top-left corner).

        Required
        If the user chooses a corner or a horizontal edge for resizing and presses < (or >), move the edge or corner one pixel to the left (or right); if augmented by the Ctrl key, move the edge or corner by multiple pixels. The same should also apply for vertical movement. If warping is enabled, the pointer should move with the corner or edge.

        Required
        If the user presses Enter or keypadEnter, complete the sizing operation. If the user presses Cancel, cancel it. If the user presses Help, suspend the sizing and provide help, if available.

        Required
        If the user is performing a size operation and releases the SELECT button (if it is pressed) or clicks the SELECT button (if it is not pressed), move the corner or edge being resized to the pointer location and complete the sizing operation.

        Recommended
        If you provide a Size choice for a window, also provide a sizing border that allows a user to change its size.

        Essential Related Topics

        For more information, see the Window Menu reference page.

        Supplemental Related Topics

        For more information, see the Direct Manipulation, Maximize (Choice), Minimize (Choice), and Restore (Choice) reference pages.

        [ Previous | Next | Contents | Glossary | Home | Search ]