getFrameProperties: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
m (Conversion script moved page GetFrameProperties to getFrameProperties: Converting page titles to lowercase)
m (Text replacement - "<source" to "<syntaxhighlight")
Line 7: Line 7:


|usage=
|usage=
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
getFrameProperties(name)
getFrameProperties(name)
</source>
</source>
Line 16: Line 16:
|example=
|example=
Opening up a frame  
Opening up a frame  
<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[frame5("Test", "title=My Frame; width=100; height=200; temporary=0; value=99"):{A frame}]
[frame5("Test", "title=My Frame; width=100; height=200; temporary=0; value=99"):{A frame}]
</source>
</source>
Line 22: Line 22:
Getting the properties of the frame:
Getting the properties of the frame:


<source lang="mtmacro" line>
<syntaxhighlight lang="mtmacro" line>
[getFrameProperties("Test")]
[getFrameProperties("Test")]
</source>
</source>


The output will be:
The output will be:
<source lang="JSON">
<syntaxhighlight lang="JSON">
{
{
   "title": "My Frame",
   "title": "My Frame",

Revision as of 17:54, 14 March 2023

 This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.

getFrameProperties() Function

Introduced in version 1.5.4
Returns a json object holding the properties associated with a given frame. The properties are width, height, temporary, title, and value.

Usage

<syntaxhighlight lang="mtmacro" line> getFrameProperties(name) </source>

Parameters

  • name - The name of the frame.

Example

Opening up a frame

<syntaxhighlight lang="mtmacro" line> [frame5("Test", "title=My Frame; width=100; height=200; temporary=0; value=99"):{A frame}] </source>

Getting the properties of the frame:

<syntaxhighlight lang="mtmacro" line> [getFrameProperties("Test")] </source>

The output will be: <syntaxhighlight lang="JSON"> {

 "title": "My Frame",
 "tabtitle": "My Frame",
 "html5": 1,
 "temporary": 0,
 "visible": 1,
 "docked": 1,
 "floating": 0,
 "autohide": 0,
 "height": 1148,
 "width": 285,
 "undocked_x": 1053,
 "undocked_y": 358,
 "undocked_h": 225,
 "undocked_w": 252,
 "value": "99"

}

</source>


Version Changes

  • 1.11.0 - Added more properties.