Gamma/Photon : Using Gamma™ with the Photon microGUI®, Version 3.4
	Widget Classes

`PtWindow`

PtWindow — A window managed by the Photon Window Manager.

Synopsis

class PtWindow PtContainer
{
    cursor_override;          // integer  (Pt_ARG_WINDOW_CURSOR_OVERRIDE)    
    default_action;           // PtWidget 
    force_front;              // integer 
    help_root;                // string  (Pt_ARG_WINDOW_HELP_ROOT)    
    icon_window;              // PtWidget  (Pt_ARG_ICON_WINDOW)    
    managed_flags;            // flag  (Pt_ARG_WINDOW_MANAGED_FLAGS)    
    max_height;               // short  (Pt_ARG_MAX_HEIGHT)    
    max_width;                // short  (Pt_ARG_MAX_WIDTH)    
    min_height;               // short  (Pt_ARG_MIN_HEIGHT)    
    min_width;                // short  (Pt_ARG_MIN_WIDTH)    
    notify_flags;             // flag  (Pt_ARG_WINDOW_NOTIFY_FLAGS)    
    render_flags;             // flag  (Pt_ARG_WINDOW_RENDER_FLAGS)    
    state;                    // flag  (Pt_ARG_WINDOW_STATE)    
    title;                    // string  (Pt_ARG_WINDOW_TITLE)    
    title_color;              // color  (Pt_ARG_WINDOW_TITLE_COLOR)    
    window_active_color;      // color  (Pt_ARG_WINDOW_ACTIVE_COLOR)    
    window_inactive_color;    // color  (Pt_ARG_WINDOW_INACTIVE_COLOR)    
}

Base Classes

PtWidget <-- PtBasic <-- PtContainer <-- PtWindow

Derived Classes

PtIcon

Description

This widget is a Photon window, with a title bar, resizing buttons, and basic control menu.

For detailed information, please refer to PtWindow in the Photon documentation.

Instance Variables

cursor_override

A number specifying whether or not the cursor of this window overrides the cursors of its children. Default, 0, means no. Any other value means yes.

default_action

This variable is not yet documented in detail.

force_front

This variable is not yet documented in detail.

help_root

A string that comprises the root path for this window's help topic. Default is "".

icon_window

A PtWidget for the icon of the window. If set to nil, the window will use a child PtIcon, otherwise a default icon.

managed_flags

This instance variable allows for Window Manager interactions, and may be a combination of zero or more of the following flags:

Constant	Description
`Ph_WM_CLOSE`	Allows the window manager to close the window.
`Ph_WM_FOCUS`	Allows the window manager to handle focus on the window.
`Ph_WM_MENU`	Allows the window to generate a 'window' menu.
`Ph_WM_TOFRONT`	Sends the window to the front.
`Ph_WM_TOBACK`	Sends the window to the back.
`Ph_WM_HIDE`	Allows the window to be hidden.
`Ph_WM_CONSWITCH`	Moves the window to keep it visible when the virtual console is switched.
`Ph_WM_RESIZE`	Allows the window to be resized.
`Ph_WM_MOVE`	Allows the window to be moved.
`Ph_WM_ICON`	Iconifies the window.
`Ph_WM_MAX`	Maximizes the window.
`Ph_WM_BACKDROP`	Makes the window into the backdrop.
`Ph_WM_HELP`	Allows context-sensitive help.
`Ph_WM_RESTORE`	De-iconifies the window, or un-maximizes the window.
`Ph_WM_FFRONT`	Forces the window to the front.

max_height , max_width

A number of pixels that specify the maximum height or width that the window can be sized to.

min_height , min_width

A number of pixels that specify the minimum height or width that the window can be sized to. Defaults are 43 and 71 respectively.

notify_flags

Flags that allow the window to control some of its functioning locally (without help from the Window Manager). Default is Ph_WM_RESIZE | Ph_WM_CLOSE | Ph_WM_HELP.

This instance variable may be a combination of zero or more of the following flags:

Constant	Description
`Ph_WM_CLOSE`	Tells the program when a window close has been attempted.
`Ph_WM_FOCUS`	Tells the program when the window gains or loses focus.
`Ph_WM_MENU`	Tells the program when the 'window' menu has been selected.
`Ph_WM_TOFRONT`	Tells the program when the window is sent to the front.
`Ph_WM_TOBACK`	Tells the program when the window is sent to the back.
`Ph_WM_HIDE`	Tells the program when the window has been hidden.
`Ph_WM_CONSWITCH`	Tells the program when the window has switched virtual consoles.
`Ph_WM_RESIZE`	Tells the program when the window has been resized.
`Ph_WM_MOVE`	Tells the program when the window has been moved.
`Ph_WM_ICON`	Tells the program when the window has been iconified.
`Ph_WM_MAX`	Tells the program when the window has been maximized.
`Ph_WM_BACKDROP`	Tells the program when the window has been made the backdrop.
`Ph_WM_HELP`	Tells the program when context sensitive help has been selected.
`Ph_WM_RESTORE`	Tells the program when context sensitive help has been restored.
`Ph_WM_FFRONT`	Tells the program when context sensitive help has been forced to the front.

render_flags

Flags that control how the window is rendered. Default is Ph_WM_APP_DEF_RENDER, which is a combination of several of these flags.

This instance variable may be a combination of zero or more of the following flags:

Constant	Description
`Ph_WM_RENDER_ASAPP`	Renders the window as an application window.
`Ph_WM_RENDER_ASICON`	Renders the window as an icon window.
`Ph_WM_RENDER_ASMASK`	As Mask
`Ph_WM_RENDER_TITLE`	Draws a title bar on the window.
`Ph_WM_RENDER_CLOSE`	Draws a close button in the window title bar.
`Ph_WM_RENDER_HELP`	Draws a help button in the window title bar.
`Ph_WM_RENDER_MAX`	Draws a maximize button in the window title bar.
`Ph_WM_RENDER_MENU`	Draws a menu button in the window title bar.
`Ph_WM_RENDER_MIN`	Draws a minimize button in the window title bar.
`Ph_WM_RENDER_BORDER`	Draws borders around the window.
`Ph_WM_RENDER_RESIZE`	Draws resizing borders around the window.

state

This instance variable specifies the state of the window when it is first opened, and may have one of the following values:

Constant	Description
`Ph_WM_STATE_ISMASK`	Internal informational bit.
`Ph_WM_STATE_ISHIDDEN`	The window opens normally, but is not displayed.
`Ph_WM_STATE_ISMAX`	Opens the window to its maximum size.
`Ph_WM_STATE_ISBACKDROP`	Opens the window as a workspace backdrop.
`Ph_WM_STATE_ISTASKBAR`	Internal informational bit.
`Ph_WM_STATE_ISPDM`	Internal informational bit.
`Ph_WM_STATE_ISICONIFIED`	Opens the window and makes it an icon.
`Ph_WM_STATE_ISICON`	Internal informational bit.
`Ph_WM_STATE_ISFRONT`	Opens the window in front of all other applications.
`Ph_WM_STATE_ISFOCUS`	Opens the window as the focus widget, if the WM cursor focus option is disabled. This is the default.

title

A string comprising the title of the window, which appears in the title bar. Default is "Untitled".

title_color

A number specifying the color of the title bar. Default is Pg_DEFAULT_WM_COLOR.

window_active_color

A number specifying the color of the frame of the window when the window has focus. Default is Pg_DEFAULT_WM_COLOR.

window_inactive_color

A number specifying the color of the frame of the window when the window doesn't have focus. Default is Pg_DEFAULT_WM_COLOR.

Callbacks

The following callbacks are associated with this widget:

Callback	Description
`Pt_CB_WINDOW`	This callback is generated when an event is received from the Window Manager.
`Pt_CB_WINDOW_CLOSING`	This callback is generated as the window closes, before the window region is removed.
`Pt_CB_WINDOW_OPENING`	This callback is generated as the window is being opened, useful for resizing and anchoring.
`Pt_CB_WINDOW_TRANSPORT`	This callback is generated when a window is transported through a Jump Gate.

Convenience Functions

Arguments

widget A PtWindow widget.

Functions

These functions are extensions of QNX Photon functions. You can refer to the PtWindow function documentation in QNX Helpviewer for more information about them.

PtWindowtoBack (widget) -- moves the window widget and all of its child windows to the back of the workspace, but not behind its parent window. To enable a child window to be moved behind its parent, make the two windows siblings by setting the child's parent to nil.

Returns t.

PtWindowtoFront (widget) -- moves the window widget and all of its child windows to the front of the workspace, and gives it focus. A parent window cannot be moved in front of its child, however. To do this, make the windows siblings by setting the child's parent to nil.

Returns t.


PtWidget		RtMeter