The Menu Button

Presence

The menu button appears when
  • the object is top level, or
  • it is a popup whose `head attribute is 1 (the default);
its presence is not otherwise controllable.

Function

Pressing the left or right mouse button on the menu button displays the window manager menu, which allows the user to restore the widget's size from full screen, move the widget, resize it, make it an icon, make it fill the entire screen, or lower, raise, or close it.

If Move is selected, the mouse pointer is shown as double-pointed crossed arrows in the center of the widget and the widget moves with the pointer;  the move is completed when a (pressed) mouse button is released.

Size appears on the menu only if the `resizeable attribute is 1 (the default).  When it is selected, the mouse pointer is shown as double-pointed crossed arrows in the center of the widget.  If they are moved to touch a frame segment or, in particular, a resize corner, they are converted to an arrow and either a bar or a right angle, and moving the mouse moves the corresponding edge or edges.  The resizing is finished when a (pressed) mouse button is released.

If Close is selected, the variable is freed unless the `exit attribute has been set to either 0, making close a no-op, or a callback function that will handle the request.

Size

Menu button size is controlled by the window manager; there is no A+ interface for it.

Color

Menu button color is controlled by the window manager; there is no A+ interface for it.


doc@aplusdev.org© Copyright 1995–2008 Morgan Stanley Dean Witter & Co. All rights reserved.