$Screen attr: Difference between revisions
Jump to navigation
Jump to search
(Created page with "<span class="pageSubtitle">Get screen attributes as blank-delimited string</span> This function returns the attributes of a screen item as a blank-delimited string. It can be...") |
No edit summary |
||
| Line 3: | Line 3: | ||
This function returns the attributes of a screen item as a blank-delimited string. It can be useful for passing the attributes of a screen to another application, perhaps running on a different platform. | This function returns the attributes of a screen item as a blank-delimited string. It can be useful for passing the attributes of a screen to another application, perhaps running on a different platform. | ||
==Syntax== | ==Syntax== | ||
<p class="syntax">%string = $Screen_atta(scr_item) | <p class="syntax">%string = $Screen_atta(scr_item, [protected], [invisible], [tagged]) | ||
</p> | </p> | ||
| Line 9: | Line 9: | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%string</th> | <tr><th>%string</th> | ||
<td>This string value contains a | <td>This string value contains a blank-separated list of attributes for the requested screen item.</td></tr> | ||
<tr><th>scr_item</th> | <tr><th>scr_item</th> | ||
<td>The screen item for which attributes are to be returned. This can be a variable of the form <i>%screen:item</i> or a [[Full-screen feature#Screen_item_name_variables|screen item name variable]] of the form <i>:%string</i>.</td></tr> | <td>The screen item for which attributes are to be returned. This can be a variable of the form <i>%screen:item</i> or a [[Full-screen feature#Screen_item_name_variables|screen item name variable]] of the form <i>:%string</i>.</td></tr> | ||
<tr><th>protected</th> | |||
<td>The word to be added to the result string if the screen item is protected. If <i>protected</i> is not specified, no word is added to the result string for protected screen items.</td></tr> | |||
<tr><th>invisible</th> | |||
<td>The word to be added to the result string if the screen item is invisible. If <i>invisible</i> is not specified, no word is added to the result string for invisible screen items.</td></tr> | |||
<tr><th>tagged</th> | |||
<td>The word to be added to the result string if the screen item is tagged. If <i>tagged</i> is not specified, no word is added to the result string for tagged screen items.</td></tr> | |||
</table> | </table> | ||
===Return value=== | |||
==Examples== | ==Examples== | ||
<ol> | <ol> | ||
<li>This code fragment displays the attributes of screen item <code>bar</code> in screen <code>foo</code>: | <li>This code fragment displays the attributes of screen item <code>bar</code> in screen <code>foo</code>: | ||
<p class="code">print $screen_attr(%foo:bar) | <p class="code">print $screen_attr(%foo:bar, "protected", "invisible", "tagged") | ||
</p> | </p> | ||
</ol> | </ol> | ||
[[Category:$Functions|$Screen_attr]] | [[Category:$Functions|$Screen_attr]] | ||
Revision as of 17:49, 30 May 2017
Get screen attributes as blank-delimited string
This function returns the attributes of a screen item as a blank-delimited string. It can be useful for passing the attributes of a screen to another application, perhaps running on a different platform.
Syntax
%string = $Screen_atta(scr_item, [protected], [invisible], [tagged])
Syntax terms
| %string | This string value contains a blank-separated list of attributes for the requested screen item. |
|---|---|
| scr_item | The screen item for which attributes are to be returned. This can be a variable of the form %screen:item or a screen item name variable of the form :%string. |
| protected | The word to be added to the result string if the screen item is protected. If protected is not specified, no word is added to the result string for protected screen items. |
| invisible | The word to be added to the result string if the screen item is invisible. If invisible is not specified, no word is added to the result string for invisible screen items. |
| tagged | The word to be added to the result string if the screen item is tagged. If tagged is not specified, no word is added to the result string for tagged screen items. |
Return value
Examples
- This code fragment displays the attributes of screen item
barin screenfoo:print $screen_attr(%foo:bar, "protected", "invisible", "tagged")