Programmer Guide/Shell Items/Dialog/DIALOG Item Attributes: Difference between revisions

From STX Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{DISPLAYTITLE:{{SUBPAGENAME}}}}
{{Dialog Item}}
The [[Programmer_Guide/Shell_Items/Dialog|dialog item]] (also know for historical reasons as ''menu item'') has the following attributes, which can be accessed using the following syntax:
The [[Programmer_Guide/Shell_Items/Dialog|dialog item]] (also know for historical reasons as ''menu item'') has the following attributes, which can be accessed using the following syntax:


Line 13: Line 14:
|-
|-
| <var>!BACKGROUNDCOLOR</var>
| <var>!BACKGROUNDCOLOR</var>
| This is not implemented; the value is always set to *
| This is not implemented; the value is always set to <code>*</code>
|-
|-
| <var>!CONTROLS</var>
| <var>!CONTROLS</var>
Line 19: Line 20:
|-
|-
| <var>!DIALOGMODE</var>
| <var>!DIALOGMODE</var>
| The mode of dialog window (NOWINDOW = not created). One of the following values: <code>NOWINDOW</code>, <code>HIDDEN</code>, <code>VISIBLE</code> and <code>ENABLED</code>
| The mode of dialog window (<code>NOWINDOW</code> &hellip; not created). One of the following values: <code>NOWINDOW</code>, <code>HIDDEN</code>, <code>VISIBLE</code> and <code>ENABLED</code>
|-
|-
| <var>!DIALOGONLY</var>
| <var>!DIALOGONLY</var>
Line 29: Line 30:
| <var>!EDITING</var>
| <var>!EDITING</var>
|
|
  <code>#beingEdited := $#dialog[!EDITING,$#controlId]</code>
  #beingEdited := $#dialog[!EDITING,$#controlId]


The <code>!EDITING</code> attribute returns <code>1</code> if the control with the id <code>$#controlId</code> is a listview and is currently being edited.
The <code>!EDITING</code> attribute returns <code>1</code> if the control with the id <code>$#controlId</code> is a listview and is currently being edited.
Line 38: Line 39:
|-
|-
| <var>!FOCUS</var>
| <var>!FOCUS</var>
| Returns the index of the control which has currently the focus in the following format:
| Returns the index of the control which has currently the focus.
 
<code>index_of_focus_control</code>
|-
|-
| <var>!FOREGROUND</var>
| <var>!FOREGROUND</var>
Line 46: Line 45:
|-
|-
| <var>!MODE</var>
| <var>!MODE</var>
| This attribute is read from the display item containing the dialog and not from the dialog item itself. See section "display item attributes" for details.
| This attribute is read from the display item containing the dialog and not from the dialog item itself. See section [[Programmer_Guide/Shell_Items/Display/DISPLAY_Item_Attributes|display item attributes]] for details.
|-
|-
| <var>!NFREE</var>
| <var>!NFREE</var>

Latest revision as of 07:58, 22 April 2015

Dialog Item
NEW SET CONTROLS ATTRIBUTES MESSAGES EXAMPLES

The dialog item (also know for historical reasons as menu item) has the following attributes, which can be accessed using the following syntax: 

#result := $#dialog[!ATTRIBUTE]

e.g. if you want to assign the number of controls to a local variable, do the following: 

#nControls := $#dialog[!CONTROLS]
attribute description
!BACKGROUNDCOLOR This is not implemented; the value is always set to *
!CONTROLS The index of first free dialog control, can be used to construct sub-dialogs (pseudo property sheets) (i.e. the number of controls).
!DIALOGMODE The mode of dialog window (NOWINDOW … not created). One of the following values: NOWINDOW, HIDDEN, VISIBLE and ENABLED
!DIALOGONLY Returns 1 if the display only contains a dialog (i.e. no graphs), otherwise it returns 0.
!DISPLAY The name of the display object which owns the dialog.
!EDITING 
#beingEdited := $#dialog[!EDITING,$#controlId]

The !EDITING attribute returns 1 if the control with the id $#controlId is a listview and is currently being edited.

The attribute returns 0 if the control with the id $#controlId is a listview and is *not* being edited.

The attribute returns an asterisk (*) if the control $#controlId does not exist, or exists, but is not a listview control.

!FOCUS Returns the index of the control which has currently the focus.
!FOREGROUND The dialog item attribute !FOREGROUND returns 1 if the dialog window is in the foreground, 0 if it is not and -1 if the command fails in some way.
!MODE This attribute is read from the display item containing the dialog and not from the dialog item itself. See section display item attributes for details.
!NFREE Returns the number of controls which can be added to the dialog in the following format: 
number_of_free:_controls
!PARENT Not implemented; the value is always set to *
!STYLE This attribute is read from the display item containing the dialog and not from the dialog item itself. See section display item attributes for details.
!TITLE This attribute is read from the display item containing the dialog and not from the dialog item itself. See section display item attributes for details.
!WINDOW This attribute is read from the display item containing the dialog and not from the dialog item itself. See section display item attributes for details.
Retrieved from "https://mediawiki.kfs.oeaw.ac.at/stx/docs/wiki/index.php?title=Programmer_Guide/Shell_Items/Dialog/DIALOG_Item_Attributes&oldid=7351"

Navigation menu

Personal tools