| Prev | Next | Start of Chapter | Next Chapter | Contents | Glossary | Index | Comments | (6 out of 6)

Displaying and Undisplaying Menu Bars

Menu bars appear and disappear only in response to API calls.

To display a menu bar:

gms-display-menu-bar
(handle: integer, menu-index: integer)

Displays the menu bar referenced by menu-index at the top of the G2 window referenced by handle.

To undisplay a menu bar:

gms-hide-menu-bar
(handle: integer)

Undisplays the menu bar currently displayed in the G2 window referenced by handle. If no menu bar is visible, the call has no effect.

To redisplay a menu bar:

gms-redisplay-menu-bar
(handle: integer)

Redisplays the menu bar most recently displayed in the G2 window referenced by handle. If no menu bar was ever displayed in the window, the call has no effect.

To obtain the menu bar of a G2 window:

gms-get-menu-bar-index
(handle: integer)
-> menu-index: integer

Returns the index of the menu bar currently on display in the G2 window referenced by handle, or -1 if no such menu bar exists.

To obtain the current height of the menu bar of a G2 window:

gms-get-current-menu-bar-height
(handle: integer)

Returns the number of pixels in a menu bar on the G2 window. If no menu bar is visible, get-current-menu-bar-height returns 0. Use the current menu bar height to determine, for example, where to place a dialog just below the current menu bar without obscuring the menu bar.

| Prev | Next | Start of Chapter | Next Chapter | Contents | Glossary | Index | Comments | (6 out of 6)

Copyright © 1997 Gensym Corporation, Inc.