getFrameProperties: Difference between revisions

Latest revision as of 23:59, 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

getFrameProperties(name)

Parameters

name - The name of the frame.

Example

Opening up a frame

[frame5("Test", "title=My Frame; width=100; height=200; temporary=0; value=99"):{A frame}]

Getting the properties of the frame:

[getFrameProperties("Test")]

The output will be:

{
  "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"
}

Version Changes

1.11.0 - Added more properties.

@@ Line 7: / Line 7: @@
 |usage=
-<source lang="mtmacro" line>
+<syntaxhighlight lang="mtmacro" line>
 getFrameProperties(name)
-</source>
+</syntaxhighlight>
 '''Parameters'''
@@ Line 16: / Line 16: @@
 |example=
 Opening up a frame
-<source lang="mtmacro" line>
+<syntaxhighlight lang="mtmacro" line>
-[frame("Frame Test", "width=300; height=200; temporary=0; title=A new title; value=data of relevance"): {test}]
+[frame5("Test", "title=My Frame; width=100; height=200; temporary=0; value=99"):{A frame}]
-</source>
+</syntaxhighlight>
 Getting the properties of the frame:
-<source lang="mtmacro" line>
+<syntaxhighlight lang="mtmacro" line>
-[getFrameProperties("Frame Test")]
+[getFrameProperties("Test")]
-</source>
+</syntaxhighlight>
 The output will be:
-<source lang="mtmacro" line>
+<syntaxhighlight lang="JSON">
- {"width":300,"height":200,"temporary":0,"title":"A new title","value":"data of relevance"}
+{
-</source>
+  "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"
+}
+</syntaxhighlight>
+|changes=
+* '''1.11.0''' - Added more properties.
 }}
 [[Category:Frame Function]]