Differential D12961 Diff 37192 source/components/radiobutton.rst

Changeset View

Standalone View

View Options

source/components/radiobutton.rst

Show First 20 Lines • Show All 143 Lines • ▼ Show 20 Line(s)
144 144​
145- When using a radio button and none of the options is a valid choice, 145​- When using a radio button and none of the options is a valid choice,
146 add another option to reflect this choice, such as None or Does not 146​ add another option to reflect this choice, such as None or Does not
147 apply. 147​ apply.
148 148​
149Appearance 149​Appearance
150~~~~~~~~~~ 150​~~~~~~~~~~
151 151​
152If you are using qt widgets you should use one of Qt's Layout Classes 152​If you are using Qt widgets you should use one of
153like , that will take care of lay outing and spacing of your controls. 153​`Qt's Layout Classes <http://doc.qt.io/qt-5/layout.html>`_,
154​which will take care of laying out and spacing of your controls.
ngrahamUnsubmitted
Not Done

"that will" -> "which will"

ngraham: "that will" -> "which will"
ngrahamUnsubmitted
Done

You missed this one :)

ngraham: You missed this one :)
154 155​
155- When options are subordinate to a radio box, this relation should be 156​- When options are subordinate to a radio box, this relation should be
156 visualized by indenting the sub-options by using a horizontal spacer 157​ visualized by indenting the sub-options by using a horizontal spacer
157 of SizeType "Minimum". 158​ of SizeType "Minimum".
158 159​
159- If activating a choice affects the appearance or the enabled state of 160​- If activating a choice affects the appearance or the enabled state of
160 other controls, place them next to the radio button (group). 161​ other controls, place them next to the radio button (group).
161- Align radio buttons vertically rather than horizontally, as this 162​- Align radio buttons vertically rather than horizontally, as this
162 makes them easier to scan visually. Use horizontal or rectangular 163​ makes them easier to scan visually. Use horizontal or rectangular
163 alignments only if they greatly improve the layout of the window. 164​ alignments only if they greatly improve the layout of the window.
164- If certain controls in a configuration dialog are only relevant if a 165​- If certain controls in a configuration dialog are only relevant if a
165 certain radio button is toggled on (i.e. they are dependent 166​ certain radio button is toggled on (i.e. they are dependent
166 controls), disable them instead of hiding them if that radio button 167​ controls), disable them instead of hiding them if that radio button
167 is toggled off. 168​ is toggled off.
168 ​
169- Do not separate radio button and label. Clicking on both the button 169​- Do not separate radio button and label. Clicking on both the button
170 and the label should toggle the option. 170​ and the label should toggle the option.
171- Do not add line breaks. If necessary place an additional label below 171​- Do not add line breaks. If necessary place an additional label below
172 the check box. 172​ the check box.
173- Label a group of radio buttons with a descriptive caption to the top 173​- Label a group of radio buttons with a descriptive caption to the top
174 left of the group (cf. :doc:`alignment </layout/alignment>`). 174​ left of the group (cf. :doc:`alignment </layout/alignment>`).
175- Create a buddy relation so access keys are assigned. 175​- Create a buddy relation so access keys are assigned.
176- Use :doc:`sentence style capitalization </style/writing/capitalization>` for radio buttons. 176​- Use :doc:`sentence style capitalization </style/writing/capitalization>`
177​ for radio buttons.
177- Do not use ending punctuation (neither dot nor colon) for group 178​- Do not use ending punctuation (neither dot nor colon) for group
178 label. 179​ label.