Radio Button Group

This widget can be used as a group element to set parameter values via radio buttons in the Frontend. You can either connect the widget to the value of a parameter of your MERLIC Vision App or define a customized value list to be displayed.

We recommend you to use the widget only for parameters that have a short list of values, e.g., "dark" and "light", since each value will be displayed in its own field with a radio button. The longer the value list, the bigger the widget and the more space it will take in the Frontend. If you want to set parameters with a long value list, you may use the Combo Box widget which is more suitable for handling long value lists in the Frontend.

Style

X, Y:

Adjust the position of the widget by typing the desired coordinate values of the upper left corner into the input field.

Z-Order:

Adjust the z-order of the widget by typing the desired value into the input field. This defines which widget is displayed on top if several widgets are positioned at the same place, for example, if widget "A" has "Z-Order" "0" and widget "B" has "Z-Order" "1", widget "B" will be displayed on top of widget "A".

Width:

Adjust the width of the widget. The width is defined in pixels and set to 200 by default. To change the value, type the new width into the input field. It must be at least 38 and not be bigger than 2147483647.

Height:

Adjust the height of the widget. The height is defined in pixels and set to 78 by default. To change the value, type the new height into the input field. The minimum value for the height depends on the number of values that are displayed in the widget and on the defined label height. If only one value is displayed, the minimum height is 38. For each further value, the defined label height is required. Thus, if the widget shows 2 values and the label height is set to 30, the height must be at least 68.

Label Height:

Adjust the height of the radio button fields. The height is defined in pixels and set to 30 by default. To change the value, type the new width into the input field.

Label Spacing:

Adjust the spacing between the radio button fields. It is defined in pixels and set to 10 by default. To change the value, type the new width into the input field. You can also set the value to 0 to remove any spacing between the fields.

Font Color:

Adjust the color of the displayed values. To change the color, click into the color field and select a new color in the color selection dialog or enter the color code manually.

Font Family:

Select the font family of the displayed values in the drop-down menu of this property.

Horizontal Text Alignment:

Adjust the horizontal alignment of the text that is displayed in the label. It is set to "left" by default. You can also select "center" and "right" for the alignment at the drop-down menu.

Vertical Text Alignment:

Adjust the vertical alignment of the text that is displayed in the label. It is set to "center" by default. You can also select "top" and "bottom" for the alignment at the drop-down menu.

Data

If you create a tool group in your MVApp, make sure to connect your tool parameters and results in the Frontend Designer before grouping. For more information, see Connecting to Tools in a Group in Adjusting Your Widgets.

Values:

Define a customized list of parameter values to be displayed as radio buttons. Click on the "Edit..." button and enter the values in the new dialog. If a list of individual values is defined, the widget ignores the parameters of a connected tool and displays only the defined value list.

The chapter Adjusting Your Widgets contains a detailed description how to define customized values for a parameter that is connected to a widget.

Connected Tool:

Connect to a tool from your MERLIC Vision App by selecting the desired tool from the drop-down menu. You can only select tools that are used in your MERLIC Vision App. At the property "Connected Parameter" you may then select the parameter whose value you want to display in the widget.

Connected Parameter:

Select the parameter of the connected tool whose value you want to display from the drop-down menu. The list shows only the parameters of the tool that is selected in the property "Connected Tool". Therefore, you have to make sure that the widget is connected to a tool before selecting a parameter.

Application Example

This widget is used in the following MERLIC Vision App examples:

measure_distance_to_center_led.mvapp