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

The g2-window Class

A g2-window is an item of the G2-WINDOW class, which is a descendant of the OBJECT class in G2's class hierarchy.

This Inspect workspace shows the class hierarchy of the G2-WINDOW class:


Notice that, by default, the icon of a g2-window item displays a stub for a connection of class NETWORK-WIRE, which is a system-defined subclass of CONNECTION.

Your KB can draw connections between a g2-window item and other items. For instance, such a connection can indicate visually the portion of the current KB that a particular G2 user or Telewindows user is working with.

Attributes of the g2-window Class

The next table summarizes the class-specific attributes of the G2-WINDOW class:

Attribute Description
G2-user-name
Identifier under which an authorized user logs into a secure G2.
Allowable values:
none, or any other series of characters (only alphanumeric characters are recommended)
Default value:
none
Notes:
After establishing that a G2 user or Telewindows user is authorized, a secure G2 sets this attribute to the value specified in the User Name field of the G2 Login dialog.


G2-connection-status
Whether this g2-window item is associated with the window of either this G2 or a connected Telewindows process. (Read-only)
Allowable values:
connected
connection-closed

Default value:
Determined by whether this g2-window item was created automatically by G2 as the resulting of starting G2 or of receiving a connection from a Telewindows process, or whether this g2-window already exists in the current KB independently of any connection to visible windows
Notes:
See Determining When G2 Associates a g2-window With a Window.


G2-routing-information
This attribute is reserved for future use.
Allowable values:
Not applicable
Default value:
Not applicable


G2-user-mode
User mode currently in effect for this g2-window item.
Allowable values:
administrator or any application-defined user mode
Default value:
administrator, or value of Initial-g2-user-mode-for-this-kb attribute in the KB Configuration system table
Notes:
See Determining the User Mode.


g2-window- management-type
Whether this g2-window item is the client of a G2 process or a Telewindows process. (Read-Only)
Allowable values:
local
remote

Default value:
Determined by the event that triggered the creation of this g2-window item: local if created automatically after the G2 is launched, or remote if associated with a successful connection between the G2 and a Telewindows.
Notes:
See Determining Whether the Connection is Local or Remote.


g2-window-width
Width in pixels of window associated with this g2-window item. (Read-only)
Allowable values:
0 to the maximum width in pixels of the user's workstation screen.
Default value:
90% of the maximum width in pixels of the user's workstation screen
Notes:
See Identifying the Dimensions of G2's Window.


g2-window-height
Height in pixels of the window associated with this g2-window item. (Read-only)
Allowable values:
0 to the maximum height in pixels of the user's workstation screen
Default value:
90% of the maximum height in pixels of the user's workstation screen
Notes:
See Identifying the Dimensions of G2's Window.


g2-window-x-resolution
Horizontal resolution in pixels per inch of the window associated with this g2-window item. (Read-only)
Allowable values:
50 to 200
Default value:
75
Notes:
See Identifying the Resolution of G2's Window.


g2-window-y-resolution
Vertical resolution in pixels per inch of the window associated with this g2-window item. (Read-only)
Allowable values:
50 to 200
Default value:
75
Notes:
See Identifying the Resolution of G2's Window.


g2-window-specific-language
Name of a language translation item that determines, for the window associated with this g2-window item, the language of the text that G2 presents in system-defined menu choices, Text Editor buttons, and so on.
Allowable values:
english
japanese
korean
Name of any language-translation item in the current KB.

Default value:
english
Notes:
The value of this attribute overrides, for this g2-window, the setting for the entire KB found in the Current-language attribute of the current KB's Language Parameters system table. See Supporting a Window-Specific Language.


g2-window-remote-host-name
A string containing the network ID of the workstation from which the connected Telewindows process (associated with this g2-window item) was launched. (Read-only)
Allowable values:
Determined by the range of network IDs permitted by your network.
Default value:
Determined by the event that triggered the creation of this g2-window item: an actual workstation's network ID if associated with a successful connection between the G2 process and a Telewindows process, otherwise none.
Notes:
See Determining the Remote Host Name.


g2-window-user-name-in-operating-system
A string containing the operating-system login ID under which the connected Telewindows process (associated with this g2-window item) was launched. (Read-only)
Allowable values:
Determined by the range of login IDs permitted by your operating system.
Default value:
Determined by the event that triggered the creation of this g2-window item: an actual user's login ID if associated with a successful connection between the G2 process and a Telewindows process, otherwise none.
Notes:
See Determining the Login Name at the Operating System.


g2-window-time-of-last-connection
Date and time when this G2 associated this g2-window item with either this local G2 window, or with this telewindow. (Read-only)
Allowable values:
Any time-stamp supported by the operating system under which the associated G2 (for a local G2 window) or associated Telewindows (for a telewindow) runs.
Default value:
Not applicable
Notes:
See Determining the Time of Connection.


g2-window-initial-window-configuration-string
A text value meaningful to your application; it is settable only by the g2-reroute-window system procedure for a reroutable Telewindows connection.
Allowable values:
Any G2 text string.
Default value:
none
Notes:
See Setting up Access to Telewindows.


g2-window-reroute-problem-report
Message returned from an unsuccessful rerouting of a telewindow. (Read-only)
Allowable values:
Not applicable
Default value:
Not applicable


g2-window-operating-system-type
A symbol designating the type of operating system under which G2 is running. (Read-only)
Allowable values:
Any symbol.
Default value:
No default value.
Notes:
See Determining the Operating System Type.


Show-operator-logbook-in-this-window?
Whether the operator logbook is or is not displayed in the g2-window. When the value is yes, the logbook is displayed as specified in the Logbook Parameters system table.
Allowable values:
yes, no
Default value:
yes
Notes:
See Hiding and Showing Logbook Pages.

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

Copyright © 1997 Gensym Corporation, Inc.