Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Checkbox is a graphical element that allows users to select one or multiple options from a set. It supports checked, unchecked, and indeterminate states for partial selections. It enables selecting options, preferences, or items in forms, settings, and applications. Users interact by clicking to toggle states. Labels provide visual feedback. Linked values synchronize checkbox states with data, updating automatically when the checkbox is clicked or when the linked value changes.

On this page:

Table of Contents
maxLevel3
stylenone

Requirements

The Checkbox is Portable, functioning on both Windows and web pages across any platform. It is compatible with WPF and HTML5 displays, offering versatile use without any specific requirements.

Configuration

The Checkbox control include options for customizing its behavior and display. "Label Text" allows setting the text displayed alongside the checkbox. "Linked Value" connects the checkbox to a specific data value. "Is Read Only" makes the checkbox non-interactive. "Is Three State" enables a third, indeterminate state. "Label Order" drop-down menu determines whether the label appears before or after the checkbox. These settings control the checkbox's functionality and user interface integration. The Checkbox component has the following settings:

Checkbox Settings

Field

Description

Control NameLabel Text

It specifies the text displayed with the checkbox.

Localize

It enables the label text can be dynamically adjusted based on the user's locale settings, ensuring the interface is accessible and understandable to users from different language backgrounds.

Linked Value

It associates the checkbox with a tag, enumeration, value, or object. This linkage means that the state of the checkbox (checked or unchecked) will reflect the changes in the selected object in your application.

Is Read Only

It makes the checkbox non-interactive, meaning users cannot change its state by clicking on it. When this option is enabled, the checkbox is displayed in a way that shows its current state (checked or unchecked) but does not allow the user to modify it.

Is Three State

It enables the checkbox to have three possible states: checked, unchecked, and indeterminate.

  1. Checked: The checkbox is selected, indicating a positive or active state.

  2. Unchecked: The checkbox is not selected, indicating a negative or inactive state.

  3. Indeterminate: The checkbox is in a mixed state, which is neither checked nor unchecked. This state is often used to represent a partially completed task or when some, but not all, sub-options are selected.

Label Order

It determines the position of the label text in relation to the checkbox. There are two possible options:

  1. After: The label text appears to the right of the checkbox. This is the most common layout, often used to improve readability and alignment in forms and user interfaces.

  2. Before: The label text appears to the left of the checkbox.



Runtime Execution 

Typically the configuration settings of value is attached to a Tag exposed in the Display User Interface, or used on the CodeBehind or other modules.


In this section:

Page Tree
root@parent
spacesV10