|
|
(2 intermediate revisions by the same user not shown) |
Line 20: |
Line 20: |
| | footer || An optional message at the bottom of the list of items. Design Time and Runtime. | | | footer || An optional message at the bottom of the list of items. Design Time and Runtime. |
| |- | | |- |
| | getValue(i) || Get the value (true or false) of line i. Runtime. | | | getValue(i) || Get the value (true or false) of line i. Starts from 0. Runtime. |
| |- | | |- |
| | header || An optional message at the top of the list of items. Design Time and Runtime. | | | header || An optional message at the top of the list of items. Design Time and Runtime. |
Line 32: |
Line 32: |
| | length || Items to show, one per line. Prefix * for disabled, > for selected, ! for heading (not all controls support headings). Design Time. | | | length || Items to show, one per line. Prefix * for disabled, > for selected, ! for heading (not all controls support headings). Design Time. |
| |- | | |- |
| | setValue(i, value) || Set the value (true or false) of line i. Runtime. | | | setValue(i, value) || Set the value (true or false) of line i. Starts from 0. Runtime. |
| |- | | |- |
| | value || Sets or gets the value. Bootstrap 4: Gets or sets true/false for single row checkbox. | | | value || Sets or gets the value. Bootstrap 4: Gets or sets true/false for single row checkbox. |
Line 41: |
Line 41: |
| Standard [[events|events]] are supported. For this control, the onclick event will be most useful. | | Standard [[events|events]] are supported. For this control, the onclick event will be most useful. |
|
| |
|
| == Example (Basic) == | | == Example == |
| Go through all the checkboxes and see which ones have been chosen.
| |
| <pre>
| |
| Function Checkbox1_onclick()
| |
| Dim choices = "Choices: "
| |
| For i = 0 To Checkbox1.length-1
| |
| If Checkbox1.getValue(i) Then choices = choices & i & " "
| |
| Next
| |
| MsgBox choices
| |
| End Function
| |
| </pre>
| |
|
| |
|
| == Example (JavaScript) ==
| | <tabber> |
| Go through all the checkboxes and see which ones have been chosen.
| | JavaScript= |
| <pre> | | <syntaxhighlight lang="JavaScript"> |
| Checkbox1.onclick = function() { | | // JavaScript |
| | Checkbox1.onchange = function() { |
| var choices = "Choices: "; | | var choices = "Choices: "; |
| for (i = 0; i <= Checkbox1.length - 1; i++) { | | for (i = 0; i <= Checkbox1.length - 1; i++) { |
Line 64: |
Line 55: |
| } | | } |
| NSB.MsgBox(choices); | | NSB.MsgBox(choices); |
| };</pre> | | }; |
| | </syntaxhighlight> |
| | |-| |
| | BASIC= |
| | <syntaxhighlight lang="vb.net"> |
| | ' Basic |
| | Function Checkbox1_onchange() |
| | Dim choices = "Choices: " |
| | For i = 0 To Checkbox1.length-1 |
| | If Checkbox1.getValue(i) Then choices = choices & i & " " |
| | Next |
| | MsgBox choices |
| | End Function |
| | </syntaxhighlight> |
| | </tabber> |
|
| |
|
| == Output == | | == Output == |
Description
The Checkbox allows users to select a binary option from a list of one or more items.
Popovers and Tooltips are supported.
Properties and Methods
Standard properties are supported, plus:
addItem(item, type) |
Adds an item to the end. type can be "checked" or "disabled" . Runtime.
|
badge |
Adds a Badge to the control. Design Time and Runtime.
|
clear() |
Clears all items. Runtime.
|
footer |
An optional message at the bottom of the list of items. Design Time and Runtime.
|
getValue(i) |
Get the value (true or false) of line i. Starts from 0. Runtime.
|
header |
An optional message at the top of the list of items. Design Time and Runtime.
|
icon |
An optional icon to appear at the top of the list. Design Time and Runtime.
|
inline |
Display items horizontally? Design Time.
|
items |
Items to show, one per line. Prefix * for disabled, > for selected, ! for heading (not all controls support headings). Design Time.
|
length |
Items to show, one per line. Prefix * for disabled, > for selected, ! for heading (not all controls support headings). Design Time.
|
setValue(i, value) |
Set the value (true or false) of line i. Starts from 0. Runtime.
|
value |
Sets or gets the value. Bootstrap 4: Gets or sets true/false for single row checkbox.
|
Events
Standard events are supported. For this control, the onclick event will be most useful.
Example
// JavaScript
Checkbox1.onchange = function() {
var choices = "Choices: ";
for (i = 0; i <= Checkbox1.length - 1; i++) {
if (Checkbox1.getValue(i)) {
choices = choices + i + " ";
}
}
NSB.MsgBox(choices);
};
' Basic
Function Checkbox1_onchange()
Dim choices = "Choices: "
For i = 0 To Checkbox1.length-1
If Checkbox1.getValue(i) Then choices = choices & i & " "
Next
MsgBox choices
End Function
Output