Display Tab of the Edit Properties Page

Use the Display tab to set the general appearance and behavior of the windows within your application.

Click to expand

General options set the overall appearance of the application. Window behavior options include control over the what operators may do to modify the window size, which page is the default at startup, the default background color for new pages and whether page content should stretch to fit the page. (That last option is better controlled in the Idea Studio).

Default size and minimum allowed size can both be set, measured in pixels, and you have control over the content of both the title bar and the navigation bar. The display tab also provides controls over map features including minimum and maximum zoom levels, the allowed area within which maps are shown, and the ability to do a bulk download of map tiles, to be cached on the local server.

General

Property Stored as Description
Application Name Name Holds the displayed name of the application.
Changes to this property do not affect the path to the application folder.
Icon on VAM

VAMIcon

Select any image to be used to represent the application in the VAM.
Images larger than 38x20 pixels will be scaled to fit. In order for the icon to blend smoothly into the VAM, rather than appearing as a rectangle, any pixels in the image file that are not a part of the actual icon should be transparent.
Color Theme AppTheme

Select the overall color theme for the application.
This controls the title bar, navigation bar, dialogs, and the color used for the application in the VAM.

Application Window Behavior

Property Stored as Description
Full screen without borders DispMgrFullScreen When selected, options for the window size and title bar decorations are disabled. The application will fill whatever screen it is displayed within.
You should design the application to fit the smallest screen that it will be displayed on.
Resizable border DispMgrResizable

Operators may drag the window borders to the size they want to view. Scroll bars will be added if the application size exceeds the window.
Options to control the window size become available.
Title bar decorations may be configured.

The property, DispMgrResizable, is treated as 0 (false) when using multiple display windows with DispMgrHoriz, DispMgrVert

Fixed size window (a combination of the above two properties) Width and height may be set in the following section.
Minimum window size options are not relevant.
Constrain aspect ratio DispMgrAspectRatio This option is available only when the resizable border has been selected.
Any change to one dimension of the page is matched by a change to the other.
Disable min\max buttons DispMgrMinMaxDisabled Only available in combination with resizable border option.

Application Window Size (Values measured in pixels.)

Property Stored as Description
Width DispMgrWidth Sets the initial width of resizable windows.
Sets only the width of constrained windows.
Height DispMgrHeight Sets the initial height of resizable windows.
Sets only the height of constrained windows.
Minimum width DispMgrMinWidth Only for resizable windows, ensures that the width is no less than this value.
Does not apply to constrained or full-screen windows.
Minimum height DispMgrMinHeight Only for resizable windows, ensures that the height is no less than this value.
Does not apply to constrained or full-screen windows.

Page Behavior

Property Stored as Description
First page at startup Page

Choose which page will be shown upon application startup. You may return to the last page viewed, or use the drop-down list to select any page in the application.

If you choose a parameterized page, you should set the values that will be used for those parameters using the Set Page Parameters button. Failing to do so will result in the operator being prompted for parameter values when the application starts.

Background color DefaultPageColor Sets the default color for all pages that have not been configured with their own background color.
Stretch contents ScaleDisplayContent

When selected, the page display will be scaled to fill the available area of each window, excepting the editor window.

This option is useful in the case that the application is displayed full-screen on many computers, each having a different screen size.

Automated display scaling works reasonably well when enlarging the page. It cannot do as good a job when shrinking a display for a smaller screen. In particular, labels embedded within buttons or widgets are more likely to be truncated than scaled down.
Always design for the smallest screen that the application will be displayed upon. Further information is provided in Size Pages for Differing Screens

Maintain aspect ratio MaintainAspectRatio If set to 1 (true), then pages will maintain their aspect ratio when stretched.

Map

Property Stored as Description
Minimum zoom level SlippyMapMinZoomLevel The minimum (furthest out) zoom level allowed.
Maximum zoom level SlippyMapMaxZoomLevel The maximum (closest in) zoom level allowed.
Set area limiting Not a property

See: Limit the Map Area

Bulk download Not a property

See: Bulk Downloads of Map Tiles

Title Bar Contents

Configuration may be set independently for the standard display (Normal page) and for pop-up pages. When selected, the default is to use all decorations for the normal page and no decorations for pop-up pages.

The title bar includes ten separate items, each of which may be displayed or suppressed. The title bar itself must be selected for display in order for any of the decorations to have meaning.

Time format & date format:

Use the selectors to choose how time and date should be displayed in the title bar. If the available options do not include the format you prefer, open the Advanced Mode and change the values for DispMgrDateFormat and DispMgrTimeFormat.

Task Bar Contents

As with the title bar, configuration may be controlled independently for a normal page and for pop-up pages. The default is to show all task bar tools on the normal page and none on a pop-up page. As of release 11.2.23, independent control is available for the tiled menu and the list menu.

Page buttons are added by operators, and are unique to each operator. Choosing "Show Page Buttons" does not cause any to appear if the operator has not added them using the pin button, but deselecting the option will cause an operator's page button shortcuts to vanish.