Overview
Displays List provides a data grid, commands, and actions to manage the displays in your solution. It allows users to export displays to a .jpg or the Library and import displays from a file. The interface also allows users to insert, rename, or remove displays from the list and sort the display records by name or date.
Creating a new display in this interface is pretty simple: Click the 'New item' button on the top-left data grid corner to open the 'New Display' popup window. Enter a name for the display, select a Rendering Engine, specify the PanelType and click the 'OK' button to confirm the new display creation.
On this page:
Understanding List
Display modes
Pages, dialogs, and pop-up are different display modes, they share some common, but each one have a specific particularly or behavior. They are commonly used in application development to build intuitive and dynamic user interfaces.
Page
A Page is a Display that always remains open or opens, replacing the previous display, constituting an independent unit of information or functionality within an application. In summary, it is a screen that allows users to perform a specific action, in which access to the page is given from a navigation menu or through other links within the application.
Popup
A popup is a window that overlays the main application window. It is triggered by an action, like clicking a button or link, or can appear automatically under certain conditions. Its purpose is to provide information or functionality without leaving the current page. It operates independently, with its own border, but does not obstruct interaction with the underlying page.
There are two types of popups: modal and non-modal. A modal popup demands interaction before the user can return to the main application, pausing other activities. In contrast, a non-modal popup allows the user to continue interacting with the main application while the popup is open. These popups contain forms, menus, or other components. They offer access to functions or information but are not designed for prolonged use.
Dialog
A Dialog is a display that opens on top of all other displays and stays open, blocking the use of other displays until the User closes it.
A dialog is a small window that appears on top of the main application window and requires user input before it can be dismissed. It is typically used to prompt users for confirmation or additional information before proceeding with an action.
Dialogs can be modal, meaning the User cannot interact with the main application window until the dialog is closed.
Resize options
The options in the dropdown menu pertain to the settings for how an image or element should be resized to fit a designated display area.
StretchFill
This setting will stretch the image to completely fill the display area. This may result in the image's aspect ratio being altered, which can lead to distortion if the display area's proportions are different from the image's original aspect ratio.
StretchUniform
This option will scale the image to fit the display area while maintaining its aspect ratio. If the aspect ratios don't match, the image will be scaled until it touches the edges of the container from within, potentially leaving some empty space in the display area.
Responsive
This setting suggests that the image or element will adjust its size in response to the size of the display area. It's a bit less clear without specific context, but typically 'responsive' means that the element will scale sensibly to different screen sizes, often maintaining its aspect ratio without distortion.
NoAction
This likely means that the image will not be resized at all; it will be displayed in its original size regardless of the display area's size, which might result in cropping or overflow if the image is larger than the display area.
Properties Reference
The Display module has properties enabled as default for each display. These include Name, Engine, PanelType, as well as read-only properties like Preview, BuildStatus, BuildErrors, BuildMessage, and Description.
List properties
The table below provides a reference for the Display List properties:
Display List Properties | |
|---|---|
ID | A unique identifier for the display. |
VersionID | The version identifier, indicating the specific iteration or release of the display. |
Name | The name assigned to the display for identification and reference. |
Engine | The rendering engine used for the display, such as WPF, HTML5, or both, with the Portable option. |
PanelType | The type of panel used, typically Canvas or Dashboard, determining the layout style. |
Mode | Read-only. Shows whether the display is used as a Page, a Popup, or as a Dialog. This is defined on Drawing Properties / Display Settings. |
Preview | Read-only. Uses the MainPage display as the thumbnail. |
Navigate | A function to navigate or link to other displays or elements within the application. |
Size | Read-only. The size of the display defined in Draw. |
Length | The length property, possibly referring to duration or a specific dimensional measurement. |
OnResize | Read-only. Actions taken when the display is resized (Stretch Fill, Stretch Uniform, Responsive or NoAction). This is defined on Drawing Properties / Display Settings. |
EditSecurity | Select which Security Permissions group have access to edit this display. |
RunSecurity | Select which Security Permissions group have access to this display in runtime. |
BuildStatus | Read-only. The current status of the display's build process, such as 'Complete', 'In Progress', etc. |
BuildErrors | Read-only. Any errors encountered during the build process of the display. |
BuildMessage | Read-only. Messages or notes associated with the build process of the display. |
Level | The level or tier of the display, possibly indicating its complexity or hierarchy in the system. |
Category | The category assigned to the display, used for classification and organization. |
LockState | Read-only. The current lock state of the display, indicating if it's editable or locked for modifications. |
LockOwner | Read-only. The user or entity that currently has the display locked, if applicable. |
DateCreated | Read-only. The date when the display was initially created. |
DateModified | Read-only. The date when the display was last modified. |
Description | A brief description or summary of the display's purpose and features. |
In this section: