Dialog Box Architecture
- Last UpdatedJan 20, 2025
- 1 minute read
The Application Options dialog allows customization per application requirements. It contains 2D UI controls that are configured in the apm_data.xml Application Framework Configuration file.
Currently, only Buttons and Labels are supported using the configuration file, however, other controls can be added through Graphic Context and accepting on screen keyboard input.

Define the Options dialog
The Options dialog box is defined in the apm_data.xml, starting with this data structure where we define the number of lines in the dialog box.
<define name="options" type="config" >
<item name="numberOfLines" value="3" />
The configuration is further defined by the contained data structures.
<struct name="line_0">
<item name="displayName" value="@lang:option_line0_name@" />
<item name="numberOfButtons" value="2" />
<struct name="button_0">
<item name="displayName" value="English" />
. . .
<struct name="line_1">
<item name="displayName" value="@lang:option_line2_name@" />
<item name="numberOfButtons" value="1" />
<struct name="button_0">
<item name="displayName" value="Admin" />
<item name="mode" value="toggle" />
<item name="state" value="enabled" />
</struct>