Radio button group control

A radio button group is a container control that holds radio buttons. The radio button group defines the layout for the buttons it contains, including a group title, text alignment for button labels, and whether or not to show a border. You can place a radio button group control within a section control.

You can bind a radio button group to a database attribute that automatically populates the group with buttons, label values, and so on. Binding to a database attribute saves time because you do not have to define the individual radio button controls for the group. When the user makes a selection in the radio button group, the value automatically updates the attribute in the database. If you link a radio button group to a database attribute, you can then edit the group in the Database Configuration application and in the Domains application.

General properties

Attribute name Description
Control ID

Each control in a presentation is assigned a unique Control ID that is read-only.

Default Label

This read-only value is the text value that is associated with the database attribute bound to this control.

Label

You can specify a text value in this field to override the Default Label for the control. This label is specific to the application and is not stored in the MAXATTRIBUTE or APPFIELDDEFAULTS tables.

Hide Label

By default, the label value always appears in the user interface. Select this check box if you want the label to be invisible.

Attribute

You can associate this control with a database attribute. Not all attributes have a Default Label value.

Value Attribute Optionally, if you do not automatically populate a radio button group with a list of buttons, you can specify a value in this field that automatically updates the database when you select a button. For example, if you have a button with a Description Attribute of Waiting for Approval, you can define a Value Attribute of WAPPR. When the user clicks the radio button, WAPPR is written to the database and Waiting for Approval is shown in the user interface.
Description Attribute

Optionally, you can specify a data attribute that displays a text label for the Value Attribute in the user interface.

Show Border

Select this check box to show a rectangular border around the control.

Data Source ID

Specify a data source ID if you want this control to use a different data source than the parent. If the control is creating a data source and the Data Source ID property is not set, the ID defaults to the ID of the control. If the data source is blank, the control inherits the data source from the parent. If no parent controls have a data source specified or if the parent is the application, MAINRECORD is the data source because it is the primary data source for the application.

Advanced properties

Attribute name Description
Text Alignment

Select Left, Center, or Right to align button text relative to button images. The label for the radio button group always aligns to the left of any buttons that you add to the group.

Input Mode

Input mode options are:

  • Default: The default input mode is read/write. Any information entered in this field is stored in the database column specified in the Attribute field.
  • Password: This mode is read/write and displays asterisks.
  • Password Readonly: This mode is read-only and displays asterisks.
  • Password Required: This mode is read/write and displays asterisks. The record cannot be saved unless there is a value in the field.
  • Query: This mode is read-only and shows a typed value.
  • Readonly: This mode is read-only and shows grayed-out text.
  • Required: This mode is read/write and the record cannot be saved unless the user enters a value in the field.
Change Event
You can configure a control to perform one of the following actions in the event of a data change to the control:
  • The REFRESHTABLE event refreshes the data source table for the control.
  • The RESETCHILDREN event deletes any child objects of the data bean of the control which then reacquires its MBOSetRemote references.
Always Synchronous

If deselected, the control can communicate with the database without pausing user activities. If cleared, the user cannot perform activities in other fields until validations for this field are completed. Synchronous activity is disabled by default. If there are dependencies between values specified for this control and other controls in the application, you can enable synchronous activity for the dependent controls.

Signature Option

You can specify a signature option that can restrict access to this control or change the properties of this control based on a condition that you specify. To create a signature option, click Add/Modify Signature Options in the Select Action menu. To specify a condition, click the Configure Conditional Properties button.

Sig Option Data Source ID

An MBO must be used to evaluate whether or not a user has access to a signature option. Specify the value of the data source that performs this evaluation if it is different to the data source that is configured for this control.