You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: report-items/checkbox.md
+4-6Lines changed: 4 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ By default, the size of a CheckBox item is set.
24
24
25
25
To allow a CheckBox to expand vertically based on its contents, set the [`CanGrow`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanGrow) property to its default `True` value.
26
26
27
-
To allow a CheckBox to shrink based on its contents, set the [`CanShrink`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanShrink) property to `True`. By default, `CanShrink` is `False`. The CheckBox will always enlarge to accommodate the first line of text even when `CanGrow` is `False`.
27
+
To allow a CheckBox to shrink based on its contents, set the [`CanShrink`](/api/Telerik.Reporting.TextItemBase#Telerik_Reporting_TextItemBase_CanShrink) property to `True`. By default, `CanShrink` is `False`. The CheckBox will always enlarge to accommodate the first line of text, even when `CanGrow` is `False`.
28
28
29
29
## Embedded Expressions
30
30
@@ -36,11 +36,11 @@ In the following image, each CheckBox is initialized with the [`CheckAlign`](/ap
36
36
37
37

38
38
39
-
The check mark image depends on the value set in the `Value` property. By default, `Value` accepts `=true` or `=false`. At design time, you can initialize the `Value` property with an expression which later at runtime is evaluated to one of the [`System.Windows.Forms.CheckState`](https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.checkstate?view=windowsdesktop-6.0) values. For example, `=IsNull(Fields.Quantity, 0) > 100` will return `true` or `false` and will check and uncheck the check mark respectively.
39
+
The check mark image depends on the value set in the `Value` property. By default, `Value` accepts `=true` or `=false`. At design time, you can initialize the `Value` property with an expression, which later at runtime is evaluated to one of the [`System.Windows.Forms.CheckState`](https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.checkstate?view=windowsdesktop-6.0) values. For example, `=IsNull(Fields.Quantity, 0) > 100` will return `true` or `false` and will check and uncheck the check mark, respectively.
40
40
41
41
If your data fields return two or three distinctive values, which are not `true` or `false`, you can change the `TrueValue`, `FalseValue`, or `IndeterminateValue` properties to match your field values directly.
42
42
43
-
The `TrueValue` and `FalseValue` should be always set. If not, the `Checked` and `Unchecked` states become indetermined and you cannot show the corresponding images and check states. Generally, the `TrueValue` and `FalseValue` should be different. In the unexpected scenario where the two evaluate to the same value, the `FalseValue` will be prioritized, and the `Checked` state would become impossible to achieve.
43
+
The `TrueValue` and `FalseValue` should always be set. If not, the `Checked` and `Unchecked` states become undetermined, and you cannot show the corresponding images and check states. Generally, the `TrueValue` and `FalseValue` should be different. In the unexpected scenario where the two evaluate to the same value, the `FalseValue` will be prioritized, and the `Checked` state would become impossible to achieve.
44
44
45
45
>tip If the checkbox `Value` may take more than three values, all values that are different from the `TrueValue` and `FalseValue` will be evaluated to the `IndeterminateValue`.
46
46
@@ -50,12 +50,10 @@ The following example assumes that you have a `Status` field that has the `Appro
50
50
51
51

52
52
53
-
In this case, it is more convenient to use those values directly instead of trying to evaluate them as `true` or `false`. To use the values directly, utilize the `TrueValue`, `FalseValue`, and `IndeterminateValue` properties.
53
+
In this case, it is more convenient to use those values directly instead of trying to evaluate them as `true` or `false`. To use the values directly, utilize the `TrueValue`, `FalseValue`, and `IndeterminateValue` properties. The following image shows the final result:
54
54
55
55

0 commit comments