Table 2-4. FSET Graphics Window Attributes
|
|
/ABS_POSITION |
|
|
Position the window at an absolute location on the screen rather than at a location relative to the parent window. |
|
|
The X and Y offsets from the upper left corner of the monitor. |
|
|
None |
|
|
|
|
|
Enable a border around all or part of the window. The border is a line (one pixel wide) inside the window boundary, and it will obscure anything in that area. The border is always drawn with color 1 (black). |
|
|
One or more of the following keywords.
- ALL = Display all borders
- NONE = Display no borders
- TOP = Display top border
- NOTOP = Suppress top border
- BOTTOM = Display bottom border
- NOBOTTOM = Suppress bottom border
- LEFT = Display left border
- NOLEFT = Suppress left border
- RIGHT = Display right border
- NORIGHT = Suppress right border
|
|
|
/BORDER ALL |
|
|
/CURSOR |
|
|
Set the mouse cursor to a loaded icon. |
|
|
The index of the icon element to use, followed by the name of the icon (in single quotes) |
|
|
None |
|
|
/DISPLAY and /NODISPLAY |
|
|
Display the window. Top-level windows that are not displayed may be displayed by selecting their name from the Adept pull-down menu at the top of the screen. |
|
|
None |
|
|
/DISPLAY |
|
|
/EVENT |
|
|
Enables or disables event processing for the window. If you want to receive events, you must explicitly use this attribute with fset or fopen each time you open a window. The details of event processing, and descriptions of the events that can be specified with this keyword, are described with the GETEVENT instruction. If the window is opened for write-only access (see the /WRITEONLY attribute), this keyword causes the error File already opened. |
|
|
One or more keywords (see GETEVENT) |
|
|
/EVENT NONE |
|
|
|
|
|
Enables or disables connect and disconnect event notification. If the event value returned is 20, then you are connected to the PC. If the event value returned is 21, then you are disconnected from the PC. |
|
|
None |
|
|
None |
|
|
|
|
|
Selects a character font to be used for all text output in the window, except for output from the GTYPE instruction. The new font will take effect immediately, with the following effect on the placement of the next character output to the window: (1) The new character cell will have its left edge at the same pixel column as before the font change. (2) Its baseline will remain at the same pixel row. (3) If the top of the character cell extends above the text top margin, the character position will be bumped down so that no part of the cell is outside the text margins. (4) A similar rule applies if the right edge of the character cell extends beyond the text right margin. Font number 1 is the standard font-it has character cells 8 pixels wide and 15 pixels high; there are 3 pixels below the baseline; and uppercase letters are 9 pixels high. |
|
|
Font number (the value must be greater than or equal to one) |
|
|
/FONT 1 |
|
|
|
|
|
Specify the font number to use for the title, menu bars, and pull-down menus of the window. (Changes the title bar immediately, changes the menu bars at the next FSET /MENU... instruction.) |
|
|
Font number |
|
|
/FONT 1 |
|
|
|
|
|
Sets the change in the position of the scroll handle in the horizontal scroll bar that will be caused by clicking on the arrow buttons in the horizontal scroll bar. (This keyword is valid only when the event GRAB_H_SCROLL is enabled [see the GETEVENT instruction].) |
|
|
Number of units (see /H_RANGE) to move the handle for each click on an arrow button (the value must be greater than or equal to zero) |
|
|
Pixel width of the current font cell |
|
|
/H_HANDLE |
|
|
Sets the displayed position of the scroll handle in the horizontal scroll bar. (This keyword is valid only when the event GRAB_H_SCROLL is enabled [see GETEVENT].) |
|
|
Relative position along bar (note that this is not a pixel count; 0 = leftmost end; rightmost end may be set with /H_RANGE) |
|
|
Current scroll position |
|
|
|
|
|
Sets the value of the rightmost position of the scroll handle in the horizontal scroll bar. (This keyword is valid only when the event GRAB_H_SCROLL is enabled [see GETEVENT].) |
|
|
Value associated with the rightmost position of the scroll handle (value must be greater than or equal to 0; if n handle positions are desired, use the value n-1) |
|
|
Total number of pixels that the window can be scrolled (not the width of the window) |
|
|
|
|
|
Sets the horizontal scroll position of the displayed contents of the window. (This keyword is ignored if it is specified with FOPEN and the window already exists.) |
|
|
Horizontal offset (in pixels) in the bitmap to the first column to display (the value must be greater than or equal to zero) |
|
|
/H_SCROLL 0 |
|
|
/IGNORE |
|
|
Specifies pull-down menu items that cannot be selected. These items are dimmed in the pull-down menu display. This keyword must be specified in the same FSET instruction as the /PULLDOWN keyword. |
|
|
List of numbers in the range 1 to 30, which correspond to rows in the pull-down menu. Numbers greater than the number of pull-down items are ignored. |
|
|
No pull-down items are ignored |
|
|
/LUT |
|
|
Sets the red, green, and blue (RGB) values of a color. The specified color is actually altered for the entire graphics system. Thus, this keyword must be used with care. Note, for example, that changing color values may cause all the color descriptions in this manual to become invalid. |
|
|
The color to be changed (in the range 0 to 15), followed by the red, green, and blue values for the color (each in the range 0 to 255). A value of -1 may be specified for the red, green, or blue value to return that value to its default. For instance, specifying /LUT 15 127 127 127 will change the default white (color #15) in the system to a gray, and specifying /LUT 15 -1 -1 -1 will return the white to its default color. |
|
|
System default colors (see GCOLOR) |
|
|
|
|
|
Sets the text margins for the window. This keyword also sets the text cursor position to the top left corner of the text window defined by the new margins. The text scrolling window is reset to its maximum size. |
|
|
Coordinates of the left, top, right, and bottom edges of the text window (if a value is negative, the corresponding margin is not modified) |
|
|
- X coordinate of left margin = 8
- Y coordinate of top margin = 8
- X coordinate of right margin = (right_edge_of_window - 8)
- Y coordinate of bottom margin = (left_edge_of_window - 8)
|
|
|
|
|
|
Specifies up to 20 items to appear in the menu bar of the window. Each menu string is displayed in a box in the menu bar, left to right in the order specified. A space is added to each side of each string. If the strings are too long, the excess fall off the end of the menu bar without any error indication. The strings are written in the current font defined for the menu bar. (This keyword is ignored if the window does not have a menu bar.) |
|
|
List of up to 20 strings, each one enclosed in single quotes. Each string delimited by single-quote characters must be separated from the next string by at least one space. The correct way to clear the menu bar is to specify no strings, not a null string (that is, with /MENU, not with /MENU ' '). |
|
|
/MENU (no items) |
|
|
|
|
|
Specifies the point of reference for position information obtained from the mouse cursor. This keyword takes effect with the next event that occurs-it does not change any events that have already occurred but are waiting to be read. |
|
|
- DISPLAY = Return pointer device positions relative to the upper left-hand corner of the window region displayed on the screen.
- SCREEN = Return pointer device positions relative to the upper left-hand corner of the entire screen.
- WINDOW = Return pointer device positions relative to the upper left-hand corner of the allocated window, even if the corner is scrolled out of the displayed region.
|
|
|
/POINTER WINDOW |
|
|
|
|
|
Sets the displayed position of the window relative to its parent. The arguments define the position of this window's upper left-hand corner relative to the upper left-hand corner of the parent's allocated window. If this is a top-level window, the position is relative to the upper left-hand corner of the screen. (This keyword may not be specified for control-bar windows.) This keyword is ignored if it is specified with FOPEN and the window already exists. If this keyword is used with FSET, the value specified overrides any mouse drag that may have been done by the user. This keyword may also specify the position of the reference point of an icon relative to the top left corner of the icon (see the /ICON keyword for FOPEN). |
|
|
X position (in pixels) relative to parent (always rounded up to be an even number)
Y position (in pixels) relative to parent |
|
|
/POSITION 0 0 |
|
|
/PULLDOWN |
|
|
Outputs text into a pull-down window, and displays the pull-down window under the specified menu-bar item if that item is currently selected (highlighted). (This keyword may not be specified with FOPEN.) All the strings specified are displayed, left justified, stacked vertically, in a window the width of the longest string (plus a space on each side of the string). With the standard font, the pull-down window may have a maximum area equivalent to 25 lines of text, 25 characters wide. There can be a maximum of 30 lines of text. If there are more than 25 lines, the maximum pull-down will be less than 25 characters wide; conversely, if there are fewer than 25 lines, the pull-down can be more than 25 characters wide. Each line of text will be truncated on the right if necessary. (See the /IGNORE keyword for information on how to disable pull-down items.) Only one pull-down window can be present in the entire system at any one time. |
|
|
Number of the menu-bar item with which this pull-down list is associated (1 [leftmost item] to N [rightmost item]) followed by a list of strings (each in single quotes) separated by spaces |
|
|
No pull-down menu specified |
|
|
|
|
|
Specifies that a window is selected for receiving input. The effect of this keyword is equivalent to clicking the mouse on the window. |
|
|
None |
|
|
The window is not selected |
|
|
|
|
|
Forces a window and all its ancestors to be displayed. (This keyword differs fromthe keyword /DISPLAY, which does not display a window if any one of its ancestors is not displayed.) |
|
|
None |
|
|
None |
|
|
/SIZE |
|
|
Sets the size of the window in the display. The size specified overrides any mouse drag that may have been done by the user. This keyword may not be specified for control-bar windows. (This keyword is ignored if it is specified with FOPEN and the window already exists.) The X value is always rounded up to be an even number. For windows with a title bar, X and Y values less than 64 are set to 64. For windows without a title bar, X and Y values less than 8 are set to 8. The values of X and Y are clipped to the full size of the window as required. This keyword may also specify the size of an icon or font (see the /ICON or /DEFFONT keyword for the FOPEN instruction). |
|
|
- X size (in pixels)
- Y size (in pixels)
|
|
|
Display the whole window (see /MAXSIZE described in the FOPEN instruction) |
|
|
/SPECIAL |
|
|
Sets special attributes for the window. |
|
|
One or more of the following keywords.
- DESELECT = Allow deselection
- NODESELECT = Don't allow deselection
- POSITION = Allow moving by dragging title bar
- NOPOSITION = Don't allow dragging of title bar
- SELECTABLE = Allow window to be selected from pull-down menu under Adept icon
- NOSELECTABLE = Don't allow window to be selected from pull-down menu under Adept icon. (Window name is dimmed in pull-down menu.)
- SIZE = Allow resize with sizing icon
- NOSIZE = Don't allow resize with sizing icon
|
|
|
/SPECIAL DESELECT POSITION SELECTABLE SIZE |
|
|
/STACK |
|
|
Sets the position of the window in its window stack, which determines the layering of the windows in the display. This keyword may not be specified for control-bar windows. No child of a window can be stacked below that window's control bars. |
|
|
Code value for desired position:
- 1 Move to top of parent's stack
- -1 Move to bottom of parent's stack
|
|
|
/STACK 1 |
|
|
/TERMINAL |
|
|
Sets characteristics of the terminal emulator used to output text to the window. |
|
|
One or more of the following keywords.
- CURSOR = Display the text cursor
- NOCURSOR = Do not display text cursor
- OVERSTRIKE = Force designated overstrike characters to overstrike the previous character
- NOOVERSTRIKE = defeat overstriking
- WRAP = Wrap lines of text that are too long
- NOWRAP = Truncate long lines of text
|
|
|
/TERMINAL CURSOR OVERSTRIKE WRAP |
|
|
/TITLE |
|
|
Set the window title, which is the text that is displayed in the title bar. The title has no other meaning to the V+ system. |
|
|
String enclosed in single quotes. The string will be truncated to 40 characters. |
|
|
Same as the window name |
|
|
/UPDATE and /NOUPDATE |
|
|
In normal operation, the screen display is updated every time new graphics appear in any displayed window. The /NOUPDATE keyword stops this process for the window currently open, thereby hiding all new graphics from the screen display until normal operation resumes. The /UPDATE keyword will force the screen display to be updated and normal operation to resume. (This keyword may not be specified with the FOPEN instruction.) |
|
|
None |
|
|
/UPDATE |
|
|
/V_ARROWINC |
|
|
Sets the change in the position of the scroll handle in the vertical scroll bar that will be caused by clicking on the arrow buttons in the vertical scroll bar. (This keyword is valid only when the event GRAB_V_SCROLL is enabled [see the GETEVENT instruction].) |
|
|
Number of units (see V_RANGE) to move the handle for each click on an arrow button (the value must be greater than or equal to zero) |
|
|
Pixel height of the current font cell |
|
|
/V_HANDLE |
|
|
Sets the displayed position of the scroll handle in the vertical scroll bar. (This keyword is valid only when the event GRAB_V_SCROLL is enabled [see GETEVENT].) |
|
|
Relative position along bar (note that this is not a pixel count; 0 = topmost end; bottommost end may be set with /V_RANGE) |
|
|
Current scroll position |
|
|
|
|
|
Sets the value of the bottommost position of the scroll handle in the vertical scroll bar. (This keyword is valid only when the event GRAB_V_SCROLL event is enabled [see GETEVENT].) |
|
|
Value associated with bottommost position of the scroll handle (the value must be greater than or equal to 0; if n handle positions are desired, use the value n-1) |
|
|
Total number of pixels that the window can be scrolled (not the height of the window) |
|
|
/V_SCROLL |
|
|
Sets the vertical scroll position of the displayed contents of the window. (This keyword is ignored if it is specified with FOPEN and the window already exists.) |
|
|
Vertical offset (in pixels) in the bitmap to the first row to display (the value must be greater than or equal to zero) |
|
|
/V_SCROLL 0 |
