Difference between revisions of "Documentation/DevGuide/Basic/Option Button"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (l.c.e., homonym -> "principle")
(Corrected reference from GetState method to State property to conform with the code snippet)
Line 26: Line 26:
 
   End Function
 
   End Function
 
</source>
 
</source>
The state of an option button is also returned by the <code>getState()</code> method of the control, where False is not checked and True is checked. The code is greatly simplified:  
+
The state of an option button is also returned by the <code>State</code> property of the control, where False is not checked and True is checked. The code is greatly simplified:  
 
<source lang="oobas">
 
<source lang="oobas">
 
   If oOptionButton.State Then
 
   If oOptionButton.State Then

Revision as of 14:11, 28 March 2018



An option button control com.sun.star.awt.UnoControlRadioButton is a simple switch with two states, that is selected by the user. Usually option buttons are used in groups to display several options, that the user may select. While option buttons and check boxes seem to be similar, selecting one option button deselects all the other option buttons in the same group.

Template:Documentation/Note

Usually a group box, or horizontal and vertical lines are used, because those controls visually group the option buttons together, but in principle this can be any control. There is no functional relationship between an option button and a group box. Option buttons are grouped through consecutive tab indices only.

The state of an option button is accessed by the State property of its Model, where 0 is not checked and 1 is checked.

  Function IsChecked( oOptionButtonModel As Object ) As Boolean
      Dim bChecked As Boolean
      If oOptionButtonModel.State = 1 Then
          bChecked = True
      Else
          bChecked = False
      End If
      IsChecked = bChecked
  End Function

The state of an option button is also returned by the State property of the control, where False is not checked and True is checked. The code is greatly simplified:

  If oOptionButton.State Then
     ' The option is checked
  Else
     ' The option is not checked
  End If
Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages