Enables the user to select a single option from a group of choices when paired with other RadioButton controls.
The RadioButton control can display text, an Image, or both.
When the user selects one option button (also known as a radio button) within a group, the others clear automatically. All RadioButton controls in a given container, such as a Form, constitute a group. To create multiple groups on one form, place each group in its own container, such as a GroupBox or Panel control.
RadioButton and CheckBox controls have a similar function: they offer choices a user can select or clear. The difference is that multiple CheckBox controls can be selected at the same time, but option buttons are mutually exclusive.
Use the Checked property to get or set the state of a RadioButton. The option button's appearance can be altered to appear as a toggle-style button or as a standard option button by setting the Appearance property.
For a full list of properties, methods and events see the API documentation.
When placed into a container, only one RadioButton control can be selected at a time.
If the AutoCheck property is set to false, more than one radio button might be selected within the container.
The RadioButton icon and label can be positioned anywhere in relation to each other. They are set with the CheckAlign and TextAlign properties, respectively.
| Item | Description |
|---|---|
Class name
"wisej.web.RadioButton"
Theme appearance
"radiobutton", see Themes.
Child components
"icon" is the radiobutton icon, "label" is the text. See JavaScript.
Source code
Represents a check box control.
Use a CheckBox to give the user an option, such as true/false or yes/no. The CheckBox control can display an image or text or both.
CheckBox and RadioButton controls have a similar function: they allow the user to choose from a list of options. CheckBox controls let the user pick a combination of options. In contrast, RadioButton controls allow a user to choose from mutually exclusive options.
The Appearance property determines whether the CheckBox appears as a typical CheckBox, a button, or as a switch.
The ThreeState property determines whether the control supports two or three states. Use the Checked property to get or set the value of a two-state CheckBox control and use the CheckState property to get or set the value of a three-state CheckBox control.
For a full list of properties, methods and events see the API documentation.
The Checkbox features three preset check states: Checked, Unchecked, and Indeterminate. These can be toggled using the CheckState property.
The Checkbox icon can be configured to show on the left or right side of the text.
Icons can be placed in various places around the checkbox including above, below, beside, and more.
Represents a split button control.
The Split Button is a composite control with which the user can select a default value bound to a primary button, or select from a list of mutually exclusive values displayed in a drop-down list bound to a secondary button.
For a full list of properties, methods and events see the API documentation.
The SplitButton features a dropdown that allows the user to pick one of the listed options.
The SplitButton control can be configured to show the dropdown button horizontally or vertically on the control.
The Repeat functionality allows a SplitButton to raise it's Click event repeatedly from the time it is pressed until it is released.
| Item | Description |
|---|---|
| Item | Description |
|---|---|
Class name
"wisej.web.CheckBox"
Theme appearance
"checkbox", see Themes.
Child components
"icon" is the checkbox icon, "label" is the text. See JavaScript.
Source code
Class name
"wisej.web.SplitButton"
Theme appearance
"splitbutton", see Themes.
Child components
"button", "arrow" is the dropdown icon on the button. See JavaScript.
Source code
Represents a button control.
A Button can be clicked by using the mouse, ENTER key, or SPACEBAR if the button has focus.
Set the AcceptButton or CancelButton property of a Form to allow users to click a button by pressing the ENTER or ESC keys even if the button does not have focus. This gives the form the behavior of a dialog box.
When you display a form using the ShowDialog method, you can use the DialogResult property of a button to specify the return value of ShowDialog.
For a full list of properties, methods and events see the API documentation.
An icon can be shown on the button by setting the Image, ImageList or or ImageSource property. After setting, the icon and text spacing can be increased or decreased by setting the ImageSpacing property.
The Button control supports entering custom HTML for it's value. Just set the AllowHtml property to true. The below example contains text using the <del>, <h2>, and <bdo> tags.
The Repeat functionality allows a button to raise it's Click event repeatedly from the time it is pressed until it is released.
| Item | Description |
|---|---|
Class name
"wisej.web.Button"
Theme appearance
"button", see Themes.
Child components
"icon" is the button's icon, if shown. "arrow" is the dropdown icon on a button with MenuItems set. See JavaScript.
Source code
