GUI initialization and information class.

Initialize GUI in current thread. Automatically called from PMThread.

You can construct and destruct objects of this class.

Source:

pm_gui.h:40

Author:

Dmitry A.Steklenev

Version:

$Revision: 1.6 $

Entity	Inherited From	Type	Scope	Short Description
PMGUI		constructor	public	Constructs the GUI object and initializes the GUI facilities for use by an application.
PMGUI		constructor	public	Constructs the GUI object from an existing GUI environment.
~PMGUI		destructor	public	Destroys the GUI object.
tid		static method	public	Returns the current thread identifier.
pid		static method	public	Returns the current process identifier.
hab		static method	public	Returns the anchor block handle of the current thread.
hmq		static method	public	Returns the message queue handle of the current thread.
metric		static method	public	Returns a system metric.
dpi		static method	public	Returns a current screen resolution.
module_handle		static method	public	Returns the current module handle.
module_name		static method	public	Returns the current module name.
program_name		static method	public	Returns the current program name.
program_path		static method	public	Returns the current program startup path.
run		static method	public	Dispatches messages.

Constructs the GUI object and initializes the GUI facilities for use by an application.

Source:

pm_gui.h:48

Code:

public PMGUI (

)

Constructs the GUI object from an existing GUI environment.

Source:

pm_gui.h:55

Code:

public PMGUI (

HAB hab )

Destroys the GUI object.

Releases all of associated GUI resources if the object was not created from an existing environment.

Source:

pm_gui.h:64

Code:

public ~ PMGUI ( )

Returns the current thread identifier.

Source:

pm_gui.h:67

Code:

public static TID tid (

)

Returns the current process identifier.

Source:

pm_gui.h:69

Code:

public static PID pid (

)

Returns the anchor block handle of the current thread.

Source:

pm_gui.h:71

Code:

public static HAB hab (

)

Returns the message queue handle of the current thread.

Source:

pm_gui.h:73

Code:

public static HMQ hmq (

)

Returns a system metric.

Allows the application to ask for details about the user interface element sizes.

Source:

pm_gui.h:292

Param:

id

Metric-value identity: SV_BEGINDRAG Mouse begin drag (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_BEGINDRAGKB Keyboard begin drag (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_BEGINSELECT Mouse begin swipe select (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_BEGINSELECTKB Keyboard begin swipe select (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_CICONTEXTLINES Maximum number of lines that the icon text may occupy for a minimized window. SV_CONTEXTHELP Mouse control for pop-up menu (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_CONTEXTHELPKB Keyboard control for pop-up menu (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_CONTEXTMENU Mouse request pop-up menu (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_CONTEXTMENUKB Keyboard request pop-up menu (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_CMOUSEBUTTONS The number of buttons on the pointing device (zero if no pointing device is installed). SV_CTIMERS Count of available timers. SV_CURSORLEVEL The cursor hide level. SV_CURSORRATE Cursor blink rate, in milliseconds. SV_CXBORDER Width of the nominal-width border. SV_CXBYTEALIGN Horizontal count of pels for alignment. SV_CXDBLCLK Width of the pointing device double-click sensitive area. The default is the system-font character width. SV_CXDLGFRAME Width of the dialog-frame border. SV_CXFULLSCREEN Width of the client area when the window is full screen. SV_CXHSCROLLARROW Width of the horizontal scroll-bar arrow bit maps. SV_CXHSLIDER Width of the horizontal scroll-bar thumb. SV_CXICON Icon width. SV_CXICONTEXTWIDTH Maximum number of characters per line allowed in the icon text for a minimized window. SV_CXMINMAXBUTTON Width of the minimize/maximize buttons. SV_CXMOTIONSTART The number of pels that a pointing device must be moved in the horizontal direction, while the button is depressed, before a WM_BUTTONxMOTIONSTR message is sent. SV_CXPOINTER Pointer width. SV_CXSCREEN Width of the screen. SV_CXSIZEBORDER Width of the sizing border. SV_CXVSCROLL Width of the vertical scroll-bar. SV_CYBORDER Height of the nominal-width border. SV_CYBYTEALIGN Vertical count of pels for alignment. SV_CYDBLCLK Height of the pointing device double-click sensitive area. The default is half the height of the system font character height. SV_CYDLGFRAME Height of the dialog-frame border. SV_CYFULLSCREEN Height of the client area when the window is full screen (excluding menu height). SV_CYHSCROLL Height of the horizontal scroll-bar. SV_CYICON Icon height. SV_CYMENU Height of the single-line menu height. SV_CYMINMAXBUTTON Height of the minimize/maximize buttons. SV_CYMOTIONSTART The number of pels that a pointing device must be moved in the vertical direction, while the button is depressed, before a WM_BUTTONxMOTIONSTR message is sent. SV_CYPOINTER Pointer height. SV_CYSCREEN Height of the screen. SV_CYSIZEBORDER Height of the sizing border. SV_CYTITLEBAR Height of the caption. SV_CYVSCROLLARROW Height of the vertical scroll-bar arrow bit maps. SV_CYVSLIDER Height of the vertical scroll-bar thumb. SV_DBLCLKTIME Pointing device double-click time, in milliseconds. SV_DEBUG FALSE indicates this is not a debug system. SV_ENDDRAG Mouse end drag (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_ENDDRAGKB Keyboard end drag (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_ENDSELECT Mouse select or end swipe select (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_ENDSELECTKB Keybaord select or end swipe select (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_ERRORDURATION Duration for error alarms generated by WinAlarm. SV_ERRORFREQ Frequency for error alarms generated by WinAlarm. SV_EXTRAKEYBEEP When TRUE, the press of a key that does not exist on the Enhanced keyboard causes the system to generate a beep. SV_FIRSTSCROLLRATE The delay (in milliseconds) before autoscrolling starts, when using a scroll bar. SV_INSERTMODE TRUE if the system is in insert mode (for edit and multi-line edit controls); FALSE if in overtype mode. SV_KBDALTERED Hardware ID of the newly attached keyboard. SV_LOCKSTARTINPUT TRUE when the type ahead function is enabled; FALSE when the type ahead function is disabled. SV_MENUROLLDOWNDELAY The delay in milliseconds before displaying a pull down referred to from a submenu item, when the button is already down as the pointer moves onto the submenu item. SV_MENUROLLUPDELAY The delay in milliseconds before hiding a pull down referred to from a submenu item, when the button is already down as the pointer moves off the submenu item. SV_MONOICONS When TRUE preference is given to black and white icons when selecting which icon resource definition to use on the screen. Black and white icons may have more clarity than color icons on LCD and Plasma display screens. SV_MOUSEPRESENT When TRUE a mouse pointing device is attached to the system. SV_NOTEDURATION Duration for note alarms generated by WinAlarm. SV_NOTEFREQ Frequency for note alarms generated by WinAlarm. SV_OPEN Mouse open (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_OPENKB Keyboard open (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_POINTERLEVEL Pointer hide level. If the pointer level is zero, the pointer is visible. If it is greater than zero, the pointer is not visible. The WinShowPointer call is invoked to increment and decrement the SV_POINTERLEVEL, but its value cannot become negative. SV_PRINTSCREEN TRUE when the Print Screen function is enabled; FALSE when the Print Screen function is disabled. SV_SCROLLRATE The delay (in milliseconds) between scroll operations, when using a scroll bar. SV_SETLIGHTS When TRUE, the appropriate light is set when the keyboard state table is set. SV_SINGLESELECT Mouse select (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_TASKLISTMOUSEACCESS Determines whether the task list is displayed when mouse buttons 1 and 2 are pressed simultaneously, or when mouse button 2 is pressed by itself, or for no mouse gesture. SV_TEXTEDIT Mouse begin direct name edit (low word=mouse message id (WM_*), high word=keyboard control code (KC_*)). SV_TEXTEDITKB Keyboard begin direct name edit (low word=virtual key code (VK_*), high word=keyboard control code (KC_*)). SV_TRACKRECTLEVEL The hide level of the tracking rectangle (zero if visible, greater than zero if not). SV_SWAPBUTTON TRUE if pointing device buttons are swapped. Normally, the pointing device buttons are set for right-handed use. Setting this value changes them for left-handed use. SV_WARNINGDURATION Duration for warning alarms generated by WinAlarm. SV_WARNINGFREQ Frequency for warning alarms generated by WinAlarm.

Code:

public static LONG metric (

LONG id )

Returns a current screen resolution.

Source:

pm_gui.h:295

Code:

public static LONG dpi (

)

Returns the current module handle.

Source:

pm_gui.h:298

Code:

public static HMODULE module_handle (

)

Returns the current module name.

Source:

pm_gui.h:307

Returns:

The fully-qualified drive, path, file name, and extension of the current module.

Code:

public static char * module_name (	char * result ,
	int size )

Returns the current program name.

Source:

pm_gui.h:316

Returns:

The fully-qualified drive, path, file name, and extension of the current executed application.

Code:

public static char * program_name (	char * result ,
	int size )

Returns the current program startup path.

Source:

pm_gui.h:326

Returns:

The fully-qualified drive and path (including the trailing slash) of the directory out of which the current executed application is started.

Code:

public static char * program_path (	char * result ,
	int size )

Dispatches messages.

Source:

pm_gui.h:329

Code:

public static void run (

)