How to use a checkbox

Question

I looked at the help for a single checkbox, but there are no examples for it. I have not been able to figure out how to find the state of the box when I submit the page. It is always its default value.
Help says it can be used as a boolean control. What does this mean? I tried binding a boolean to SelectedValue, escape, but isEscape() does not return the right value. I tried removing this, and then checkbox.getSelectedValue() also does not work.
Help please.
Jim

Answer 1

This shows a demo of checkbox:
add a textField
add a checkbox without any change of properties
add a button - in properties set text to "Change"
--      doubleclick the button and replace TODO with following code:
     if (checkbox2.isChecked()) {
checkbox2.setSelected("false");
} else {
checkbox2.setSelected("true");
add another button - in properties set text to "Read"
--     doubleclick the button and replace TODO with following code:
     if (checkbox2.isChecked()) {
     textField7.setText("true");
     } else {
     textField7.setText("false");
Run:
Click checkbox and then Read-button
Click change-button and then read-button
If you have a DB in bottom and want a checkbox to show a value from a table
here is a tutor for that:
DB-table with columns id of integer, name of varchar, friend of boolean
Drag the table from Servers to the page
add 3 textfields
add a dropDownlist
rightclick --> Autosubmit on Change
rightclick --> Bind to data --> select xDataProvider --> select desired value=id and desired display field=name
rightclick --> Edit EventHandler --> processValueChange
replace the TODO with
RowKey[] xrows = xDataProvider.getRowKeys(xDataProvider.getRowCount(), null);
xDataProvider().setCursorRow(xrows[Integer.parseInt(dropDown1.getSelected().toString())-1]);
When select a new value the page is sent back to server and you need these 2 lines to update the fields.
textField1.setText(dropDown1.getSelected().toString()); (Shows dropDown selected item)
textField2.setText(xDataProvider.getCursorRow().toString()); (shows dataprovider cursorrow)
textField3.setText(xDataProvider.getValue("DB_tablename.friend", xDataProvider.getCursorRow())); (shows value of dataprovider friend column)
add a checkbox
rightclick --> Bind to data --> select xDataProvider --> select desired value=id and desired display field=friend
in checkbox properties -- Data - converter - select booleanConverter
in checkbox properties -- Data - selected - set this to true (true represent checked checkbox)
Run and see changes (need at least 2 rows in DB table with different values for friend)
Please give feedback if this helps.