Skip to content

Commit f954db1

Browse files
authored
Update checkbox.md (#1943)
1 parent 01bb36c commit f954db1

File tree

1 file changed

+4
-6
lines changed

1 file changed

+4
-6
lines changed

report-items/checkbox.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ By default, the size of a CheckBox item is set.
2424

2525
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.
2626

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`.
2828

2929
## Embedded Expressions
3030

@@ -36,11 +36,11 @@ In the following image, each CheckBox is initialized with the [`CheckAlign`](/ap
3636

3737
![The effect of CheckAlign CheckBox property](images/checkboxitem2.jpg)
3838

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.
4040

4141
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.
4242

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.
4444

4545
>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`.
4646
@@ -50,12 +50,10 @@ The following example assumes that you have a `Status` field that has the `Appro
5050

5151
![Status column from the database](images/checkboxEval1.png)
5252

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:
5454

5555
![Using Status column string values directly in the CheckBox settings](images/checkboxEval2.png)
5656

57-
The following image shows the final result.
58-
5957
## Next Steps
6058

6159
* [Using Embedded Expressions]({%slug telerikreporting/designing-reports/connecting-to-data/expressions/using-expressions/overview%})

0 commit comments

Comments
 (0)