Programmer Guide/Shell Items/Display/DISPLAY Item Attributes: Difference between revisions
From STX Wiki
< Programmer Guide | Shell Items | Display
Jump to navigationJump to search
No edit summary |
No edit summary |
||
Line 1: | Line 1: | ||
{{DISPLAYTITLE:{{SUBPAGENAME}}}} | {{DISPLAYTITLE:{{SUBPAGENAME}}}} | ||
The [[Programmer_Guide/Shell_Items/Display|display item]] has the following attributes, which can be accessed using the following syntax: | |||
#result := $#display[!ATTRIBUTE] | |||
{| | {| | ||
|- class="keinrahmen" | |- class="keinrahmen" | ||
Line 6: | Line 10: | ||
! Value(s) and Description | ! Value(s) and Description | ||
|- | |- | ||
|!MODE | | <code>!MODE</code> | ||
| N/A | | N/A | ||
|NOWINDOW<nowiki>|</nowiki>HIDDEN|VISIBLE|ENABLEDmode of the display window | |NOWINDOW<nowiki>|</nowiki>HIDDEN|VISIBLE|ENABLEDmode of the display window | ||
|- | |- | ||
|!STYLE | | <code>!STYLE</code> | ||
| N/A | | N/A | ||
|NOWINDOW<nowiki>|</nowiki>MINIMIZED|RESTORED|MAXIMIZEDstyle of the display window | |NOWINDOW<nowiki>|</nowiki>MINIMIZED|RESTORED|MAXIMIZEDstyle of the display window | ||
|- | |- | ||
|!WINDOW | | <code>!WINDOW</code> | ||
| N/A | | N/A | ||
|xpos ypos width heightposition (upper left corner) and size of the display window in pixels | |xpos ypos width heightposition (upper left corner) and size of the display window in pixels | ||
|- | |- | ||
|!TITLE | | <code>!TITLE</code> | ||
| N/A | | N/A | ||
|titletitle (caption) of the display window | |titletitle (caption) of the display window | ||
|- | |- | ||
|!NROWS | | <code>!NROWS</code> | ||
| N/A | | N/A | ||
|number_of_rowsnumber of rows for graphs | |number_of_rowsnumber of rows for graphs | ||
|- | |- | ||
|!NCOLS | | <code>!NCOLS</code> | ||
| N/A | | N/A | ||
|number_of_cols0 number_of_cols1 ...number of colums (1 or 2) per row | |number_of_cols0 number_of_cols1 ...number of colums (1 or 2) per row | ||
|- | |- | ||
|!HROWS | | <code>!HROWS</code> | ||
| N/A | | N/A | ||
|height_of_row0 height_of_row1 ...the current relative row height (sum = 1) | |height_of_row0 height_of_row1 ...the current relative row height (sum = 1) | ||
|- | |- | ||
|!WCOLS | | <code>!WCOLS</code> | ||
| | | | ||
|width_of_col0 width_of_col1 ...the current relative position (0..1) of column splitters; a position value is only valid if the row is split. | |width_of_col0 width_of_col1 ...the current relative position (0..1) of column splitters; a position value is only valid if the row is split. | ||
|- | |- | ||
|!GRAPHS | | <code>!GRAPHS</code> | ||
| N/A | | N/A | ||
|number_of_attached_graphsnumber of graph items attached to the display | |number_of_attached_graphsnumber of graph items attached to the display | ||
|- | |- | ||
|!GRAPH | |<code>!GRAPH</code> | ||
|index | |<var>index</var> | ||
|name_of_graph_object row_index col_indexget info about attached graph item identified by index (0, 1, ...) | |name_of_graph_object row_index col_indexget info about attached graph item identified by index (0, 1, ...) | ||
|- | |- | ||
|!ACTIVEGRAPH | | <code>!ACTIVEGRAPH</code> | ||
| N/A | | N/A | ||
|name_of_active_graph_objectname of currently activated (focused) graph item | |name_of_active_graph_objectname of currently activated (focused) graph item | ||
|- | |- | ||
|!FULLSCREEN | | <code>!FULLSCREEN</code> | ||
| N/A | | N/A | ||
|fullscreen_statusquery fullscreen mode flag (1 | |fullscreen_statusquery fullscreen mode flag (<code>1</code>…fullscreen, <code>0</code>…window) | ||
|- | |- | ||
|!DIALOGITEM | | <code>!DIALOGITEM</code> | ||
| N/A | | N/A | ||
|name_of_dialog_objectget name of (1st) dialog item attached to the display item | |name_of_dialog_objectget name of (1st) dialog item attached to the display item | ||
|- | |- | ||
|!DIALOGMODE | | <code>!DIALOGMODE</code> | ||
| N/A | | N/A | ||
|NOWINDOW< | | <code>NOWINDOW</code>, >code>HIDDEN</code>, <code>VISIBLE</code> or <code>ENABLED</code> indicating the mode fo mode of the dialog window (<code>NOWINDOW</code> … not created) | ||
|- | |- | ||
|!DIALOGALIGN | | <code>!DIALOGALIGN</code> | ||
| N/A | | N/A | ||
|ABOVE< | | <code>ABOVE</code>, <code>>BELOW</code>, <code>LEFT</code> or <code>RIGHT</code>, indicating the position of the dialog window | ||
|- | |- | ||
|!ONTOP | | <code>!ONTOP</code> | ||
| N/A | | N/A | ||
|always on top | |always on top status, querying whether the display is in the ''always on top'' mode | ||
|- | |- | ||
|!FOREGROUND | | <code>!FOREGROUND</code> | ||
| N/A | | N/A | ||
|Returns '<code>1</code>' if the display is currently the foreground window. Returns '<code>0</code>' if the display is currently not the foreground window. Returns '<code>-1</code>' if the display is currently not a window. | |Returns '<code>1</code>' if the display is currently the foreground window. Returns '<code>0</code>' if the display is currently not the foreground window. Returns '<code>-1</code>' if the display is currently not a window. | ||
|} | |} |
Revision as of 15:52, 31 October 2012
The display item has the following attributes, which can be accessed using the following syntax:
#result := $#display[!ATTRIBUTE]
Attribute | Argument | Value(s) and Description |
---|---|---|
!MODE
|
N/A | VISIBLE|ENABLEDmode of the display window |
!STYLE
|
N/A | RESTORED|MAXIMIZEDstyle of the display window |
!WINDOW
|
N/A | xpos ypos width heightposition (upper left corner) and size of the display window in pixels |
!TITLE
|
N/A | titletitle (caption) of the display window |
!NROWS
|
N/A | number_of_rowsnumber of rows for graphs |
!NCOLS
|
N/A | number_of_cols0 number_of_cols1 ...number of colums (1 or 2) per row |
!HROWS
|
N/A | height_of_row0 height_of_row1 ...the current relative row height (sum = 1) |
!WCOLS
|
width_of_col0 width_of_col1 ...the current relative position (0..1) of column splitters; a position value is only valid if the row is split. | |
!GRAPHS
|
N/A | number_of_attached_graphsnumber of graph items attached to the display |
!GRAPH
|
index | name_of_graph_object row_index col_indexget info about attached graph item identified by index (0, 1, ...) |
!ACTIVEGRAPH
|
N/A | name_of_active_graph_objectname of currently activated (focused) graph item |
!FULLSCREEN
|
N/A | fullscreen_statusquery fullscreen mode flag (1 …fullscreen, 0 …window)
|
!DIALOGITEM
|
N/A | name_of_dialog_objectget name of (1st) dialog item attached to the display item |
!DIALOGMODE
|
N/A | NOWINDOW , >code>HIDDEN, VISIBLE or ENABLED indicating the mode fo mode of the dialog window (NOWINDOW … not created)
|
!DIALOGALIGN
|
N/A | ABOVE , >BELOW , LEFT or RIGHT , indicating the position of the dialog window
|
!ONTOP
|
N/A | always on top status, querying whether the display is in the always on top mode |
!FOREGROUND
|
N/A | Returns '1 ' if the display is currently the foreground window. Returns '0 ' if the display is currently not the foreground window. Returns '-1 ' if the display is currently not a window.
|