Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

Check widget

The check widget is derived from the widget object and comes in two types, checkbox and radio button.

  • Checkbox indicates an on or off state. The appearance depends on the checkbox value (checked/unchecked) and activation state (active/inactive).
  • Radio button allows users to select from a group of choices. Appearance depends on the radio button's value (selected/unselected) and activation state (active/inactive)

By default, checkboxes are drawn as a square box at the origin of the widget's bounding rectangle with two modifications based on the checkbox's current state. If the checkbox has been selected, a checkmark is drawn within the bounding rectangle, and if the checkbox currently has focus, it will draw an external border around the outside to draw attention. Radio buttons are drawn as a circle at the origin of the widget's bounding rectangle and vary in a manner that is similar to checkboxes.

Checkboxes and radio buttons are attached to value models, which store the widget's state (on or off) as a boolean value. Applications can identify and assign a specific value model to each widget at the time it is created, or can choose instead to use the default IValueModel implementation managed by the check widget class. Radio buttons should also be attached to a view model that will manage the association of a group of radio buttons. The model functions as a notifier, sending EVT_MDL_GROUP_ITEMACTIVE events to each listening radio button as the user changes the current selection. The widgets in a radio button group should, therefore, be created to all share the same managing view model.

For more information, see Grouping radio buttons and Creating and grouping radio buttons. Additional information is available on the Brew MP website, in the http://developer.brewmp.com/reference/api-all.

The figure below shows an example of the checkbox and radio button widgets. The box next to the text "Copy sent messages" is a checkbox. The circles next to the text "Send now" and "Send on exit" are radio buttons in a group.

Required Files

AEECCheckWidget.h

AEECRadioWidget.h

Class IDs

AEECLSID_CCheckWidget

AEECLSID_CRadioWidget