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) }
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. |
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.
This variable is not yet documented in detail.
This variable is not yet documented in detail.
A string that comprises the root path for this window's help topic. Default is "".
A PtWidget for the icon of the window. If set to nil, the window will use a child PtIcon, otherwise a default icon.
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. |
A number of pixels that specify the maximum height or width that the window can be sized to.
A number of pixels that specify the minimum height or width that the window can be sized to. Defaults are 43 and 71 respectively.
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. |
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. |
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. |
A string comprising the title of the window, which appears in the title bar. Default is "Untitled".
A number specifying the color of the title bar. Default is Pg_DEFAULT_WM_COLOR.
A number specifying the color of the frame of the window when the window has focus. Default is Pg_DEFAULT_WM_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.
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. |
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.
Copyright © 1995-2010 by Cogent Real-Time Systems, Inc. All rights reserved.