Overview
Client Settings is a configuration interface for managing initial conditions, display behaviors, and user interface customization for all clients: RichClients and SmartClients. It allows users to tailor the application startup and runtime environment to meet specific operational needs, including startup configuration, multi-monitor setup, and interface customization. This enables users to optimize the application environment for various industrial scenarios., SmartClients and WebClients.
On this page:
| Table of Contents | ||||
|---|---|---|---|---|
|
Understanding Client Settings
Client Settings are configurable options in a software application, such as selecting themes, choosing layouts, enabling view-only modes, and activating multi-monitor support. These settings allow users to customize the interface to meet their operational needs, ensuring adaptability to various hardware setups and compliance with security standards. They enable users to modify the application's appearance and behavior, including layout, theme, security, and display preferences. To use, navigate to Displays → Client Settings, adjust the desired options, and configure settings for themes, layouts, view modes, and multi-monitor setups.
Properties Reference
The Properties References present a reference that describes and explains the Client Settings properties and options. The table lists all properties and options available. However, not all properties described in the documentation are displayed in the data grids by default. Right-click column headers to see which property columns are currently displaying. The displayed properties appear with a check mark.
The data grids allow users to manage and organize information by showing or hiding properties in tables within configuration interfaces. Users can view and select properties via column headers, enable multiple selections, add or remove columns, or reset grid settings. These features are available in all configuration interfaces using a table for data management. To show or hide properties on the data grid, right-click column headers to select properties or use the reset button to return to default settings. Check out Working with DataGrids for detailed info.
Client Setting Configuration
The Client Settings are
Client Settings properties
The Client Settings are organized into the following sections:
Initial Execution Conditions
It refers to a configuration group that defines the startup layout and theme. It aims Its purpose is to initialize the application interface according to user preferences or operational needs. It allows for selecting layouts and themes and restricts views to web or Windows clients. Users can apply these settings in scenarios requiring specific startup interfaces. Before usage, ensure that predefined layouts and themes exist. Use this group to set initial conditions for application startup.
Initial Execution Conditions | |
Layout | Selects the initial layout from predefined configurations in Displays/Layouts. |
Theme | Chooses the initial theme from predefined options in Displays/Themes. |
ViewOnly | Limits the view to specific clients. The options available are: On WebClients: restricts the view to web-based clients, preventing access from desktop applications. On Windows: restricts the view to Windows-based clients, preventing access from web applications. |
Indications for Tag Quality and Security
It refers to the definitions group, which configures visual indicators related to tag quality and security restrictions. Its purpose is to provide clear cues for identifying quality and security issues. Main functionalities include setting symbols for security restrictions and enabling indicators for undefined and bad-quality tags. This is useful in environments where visual feedback is needed to monitor system integrity. Configure it by selecting appropriate symbols. Use this group to set visual indicators.
Indications For Tag Quality And Security | |
On Security Restrictions shows | Sets indicators for tag quality and security with options such as V, ?, $, *, #, and Strikethrough. |
On Undefined Quality shows | Enables an indicator to show for undefined quality tags, unlocking additional settings for handling undefined quality. |
On Tag Bad Quality shows | Enables an indicator to show for bad quality tags, unlocking additional settings for handling bad quality. |
Enable Multiple Monitors (RichClients Only)
It refers to a configuration group that allows multiple monitors with RichClients to be used. Its purpose is to enhance display capabilities. It enables the specification of the number of monitors and the selection of the target display for the startup layout. This applies to scenarios requiring extensive display areas, such as control rooms. Before usage, ensure that the system supports multiple monitors. Use this group to configure and optimize multi-monitor setups.
Enable Multiple Monitors (RichClients Only) | |
Enable Multiple Monitors | Allows the use of multiple monitors for RichClients. |
Number of Monitors | Defines the number of monitors to be used for RichClients. |
Monitor | Sets the target display for the selected layout. |
Layout | Selects the initial layout from predefined configurations in Displays/Layouts. |
Settings available only for RichClients and SmartClients (Windows)
This group provides configuration settings reserved to for RichClients and SmartClients on Windows. Its purpose is to customize the user interface. Main functionalities include overriding layouts, setting window properties, and managing menus menu and cursor visibility. Applications include customizing the interface for different operational requirements. Before usage, ensure that predefined layouts and properties are available. Use this group to tailor the UI for specific needs.
Settings Available Only For RichClients And SmartClients (Windows) | |
Layout Override | Overrides default layout settings with options from Displays/Layouts for RichClients and SmartClients. |
Title | Enables and sets the title of the startup window. |
MinimizeBox | Enables the minimize window control button, allowing the window to be minimized by the user. |
MaximizeBox | Enables the maximize window control button, allowing the window to be maximized by the user. |
CloseBox | Enables the close window control button, allowing the window to be closed by the user. |
Resize | Allows the window to be resized by the user. |
Start Maximized | Starts the window in a maximized state, except in the development profile. |
Show Menu | Displays the menu bar in the startup window. |
File | Shows the File menu in the startup window. |
Tools | Shows the Tools menu in the startup window. |
Security | Shows the Security menu in the startup window. |
Always shows Menus in Development Profile | Ensures menus are always visible in the development profile. |
Mouse Cursor Visible | Controls the visibility of the mouse cursor on the screen. |
OnScreen Keyboard | Enables the on-screen keyboard feature, making it available for user input. Below, there's code showcasing how you can mask passwords when using this setting. |
Active Area Edges | Defines the active area edges for mouse interaction within the window. |
Active Area Mouse | Sets the mouse cursor type within the active area. None: When this option is selected, no specific mouse cursor type is assigned to the active area. The default cursor will be used, which typically appears as an arrow or the standard operating system cursor. This setting is useful when no special cursor indication is needed for the active area. Arrow: When this option is selected, the mouse cursor is displayed as an arrow within the active area. This is the standard pointer appearance and is used to indicate a normal selection or navigation action. It helps users identify areas where they can interact with standard interface elements like buttons and menus. Hand: When this option is selected, the mouse cursor is displayed as a hand within the active area. This cursor type is often used to indicate interactive elements such as hyperlinks, buttons, or other elements that respond to clicks. It helps users recognize that the area is interactive and clickable, providing a clear visual cue for interactive elements. |
Multiple windows on the same computer | Allows multiple windows to share the same user logon on the same computer, facilitating user access across different sessions. |
Masking Password when OnScreen Keyboard is available
To mask password input, set the parameter isPassword , from the OnScreen Keyboard method, to true when calling this method, as shown below.
| Code Block |
|---|
/// <summary> /// Displays screen keyboard /// </summary> /// <param name="objectName">Object name</param> /// <param name="isPassword">Flag indicating whether is a password</param> /// <param name="_actionShowOnScreenKeyboardOptional">Method called when dialog is closed. Prototyp: void Action(bool ok, string tagName, string oldValue, string newValue) </param> public static void ShowOnScreenKeyboard(string objectName, bool isPassword, Action<bool, string, string, string> _actionShowOnScreenKeyboardOptional = null) |
In this section:
| Page Tree | ||||
|---|---|---|---|---|
|