Overview
Client Settings is a configuration interface for managing initial conditions, display behaviors, and user interface customization for all clients: RichClients, SmartClients and WebClients.
On this page:
Client Setting Configuration
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. 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 for RichClients and SmartClients on Windows. Its purpose is to customize the user interface. Main functionalities include overriding layouts, setting window properties, and managing 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.
/// <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: