Managing UI Geometry: 3.4 Positioning and Sizing Windows: Window Look and Feel

Up: GEOS SDK TechDocs | Up | Prev: 3.3 On-Screen Behavior
HINT_WINDOW_NO_TITLE_BAR, HINT_WINDOW_NO_SYS_MENU, HINT_WINDOW_MINIMIZE_TITLE_BAR, HINT_WINDOW_ALWAYS_DRAW_WITH_FOCUS

HINT_WINDOW_NO_TITLE_BAR instructs the specific UI to remove the title bar from a windowed object (dialog box, GenPrimary or GenDisplay). Use this hint with extreme prejudice as most of a window's functionality will not be accessible without a title bar.

HINT_WINDOW_NO_SYS_MENU instructs the specific UI to remove the system menu (or close button) from a windowed object. Again, do not use this hint unless necessary, as it overrides important features of windowed objects.

HINT_WINDOW_MINIMIZE_TITLE_BAR instructs the specific UI to minimize the area that the window's title bar occupies, if possible. (This hint is designed for use in smaller PDA-style devices.) Note that this hint usually takes away any system menus that may normally be included with the title bar. As a result, make sure that you provide another means to dismiss the window. Also note that if a window containing this hint is disabled, the window will be dismissed by the system.

HINT_WINDOW_ALWAYS_DRAW_WITH_FOCUS instructs the specific UI to draw the window as if it always contains the focus, including "high-lighting" the window's title bar, if possible. Only use this hint if it is absolutely necessary because it may confuse the user and it violates the predominant focus paradigm.


Up: GEOS SDK TechDocs | Up | Prev: 3.3 On-Screen Behavior