[Doc cleanup] Fix typos and style of QPushButton and QGroupBox

Fix some typos. Fix some sentences to make them clearer to understand.
Since both of them are widgets, there's no Qt4-centric info.

Change-Id: I5c3c4a23621505d47b00cf466e4daad9763c3076
Reviewed-by: Eskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@digia.com>
This commit is contained in:
David Gil 2012-09-25 23:46:34 +02:00 committed by The Qt Project
parent 0189315c8c
commit ad4c76d938
2 changed files with 17 additions and 18 deletions

View File

@ -149,14 +149,13 @@ void QGroupBoxPrivate::click()
\ingroup geomanagement \ingroup geomanagement
\inmodule QtWidgets \inmodule QtWidgets
A group box provides a frame, a title and a keyboard shortcut, and A group box provides a frame, a title on top, a keyboard shortcut, and
displays various other widgets inside itself. The title is on top, displays various other widgets inside itself. The keyboard shortcut moves
the keyboard shortcut moves keyboard focus to one of the group keyboard focus to one of the group box's child widgets.
box's child widgets.
QGroupBox also lets you set the \l title (normally set in the QGroupBox also lets you set the \l title (normally set in the
constructor) and the title's \l alignment. Group boxes can be constructor) and the title's \l alignment. Group boxes can be
\l checkable; child widgets in checkable group boxes are enabled or \l checkable. Child widgets in checkable group boxes are enabled or
disabled depending on whether or not the group box is \l checked. disabled depending on whether or not the group box is \l checked.
You can minimize the space consumption of a group box by enabling You can minimize the space consumption of a group box by enabling
@ -512,9 +511,9 @@ QSize QGroupBox::minimumSizeHint() const
A group box usually consists of a surrounding frame with a title A group box usually consists of a surrounding frame with a title
at the top. If this property is enabled, only the top part of the frame is at the top. If this property is enabled, only the top part of the frame is
drawn in most styles; otherwise the whole frame is drawn. drawn in most styles; otherwise, the whole frame is drawn.
By default, this property is disabled; i.e. group boxes are not flat unless By default, this property is disabled, i.e., group boxes are not flat unless
explicitly specified. explicitly specified.
\b{Note:} In some styles, flat and non-flat group boxes have similar \b{Note:} In some styles, flat and non-flat group boxes have similar
@ -546,7 +545,7 @@ void QGroupBox::setFlat(bool b)
If this property is true, the group box displays its title using If this property is true, the group box displays its title using
a checkbox in place of an ordinary label. If the checkbox is checked, a checkbox in place of an ordinary label. If the checkbox is checked,
the group box's children are enabled; otherwise they are disabled and the group box's children are enabled; otherwise, they are disabled and
inaccessible. inaccessible.
By default, group boxes are not checkable. By default, group boxes are not checkable.
@ -603,7 +602,7 @@ bool QGroupBox::isChecked() const
\fn void QGroupBox::toggled(bool on) \fn void QGroupBox::toggled(bool on)
If the group box is checkable, this signal is emitted when the check box If the group box is checkable, this signal is emitted when the check box
is toggled. \a on is true if the check box is checked; otherwise it is false. is toggled. \a on is true if the check box is checked; otherwise, it is false.
\sa checkable \sa checkable
*/ */
@ -613,12 +612,12 @@ bool QGroupBox::isChecked() const
\fn void QGroupBox::clicked(bool checked) \fn void QGroupBox::clicked(bool checked)
\since 4.2 \since 4.2
This signal is emitted when the check box is activated (i.e. pressed down This signal is emitted when the check box is activated (i.e., pressed down
then released while the mouse cursor is inside the button), or when the then released while the mouse cursor is inside the button), or when the
shortcut key is typed, Notably, this signal is \e not emitted if you call shortcut key is typed. Notably, this signal is \e not emitted if you call
setChecked(). setChecked().
If the check box is checked \a checked is true; it is false if the check If the check box is checked, \a checked is true; it is false if the check
box is unchecked. box is unchecked.
\sa checkable, toggled(), checked \sa checkable, toggled(), checked
@ -630,7 +629,7 @@ bool QGroupBox::isChecked() const
If the group box is checkable, it is displayed with a check box. If the group box is checkable, it is displayed with a check box.
If the check box is checked, the group box's children are enabled; If the check box is checked, the group box's children are enabled;
otherwise the children are disabled and are inaccessible to the user. otherwise, the children are disabled and are inaccessible to the user.
By default, checkable group boxes are also checked. By default, checkable group boxes are also checked.

View File

@ -99,18 +99,18 @@ QT_BEGIN_NAMESPACE
Push buttons display a textual label, and optionally a small Push buttons display a textual label, and optionally a small
icon. These can be set using the constructors and changed later icon. These can be set using the constructors and changed later
using setText() and setIcon(). If the button is disabled the using setText() and setIcon(). If the button is disabled, the
appearance of the text and icon will be manipulated with respect appearance of the text and icon will be manipulated with respect
to the GUI style to make the button look "disabled". to the GUI style to make the button look "disabled".
A push button emits the signal clicked() when it is activated by A push button emits the signal clicked() when it is activated by
the mouse, the Spacebar or by a keyboard shortcut. Connect to the mouse, the Spacebar or by a keyboard shortcut. Connect to
this signal to perform the button's action. Push buttons also this signal to perform the button's action. Push buttons also
provide less commonly used signals, for example, pressed() and provide less commonly used signals, for example pressed() and
released(). released().
Command buttons in dialogs are by default auto-default buttons, Command buttons in dialogs are by default auto-default buttons,
i.e. they become the default push button automatically when they i.e., they become the default push button automatically when they
receive the keyboard input focus. A default button is a push receive the keyboard input focus. A default button is a push
button that is activated when the user presses the Enter or Return button that is activated when the user presses the Enter or Return
key in a dialog. You can change this with setAutoDefault(). Note key in a dialog. You can change this with setAutoDefault(). Note
@ -190,7 +190,7 @@ QT_BEGIN_NAMESPACE
In some GUI styles a default button is drawn with an extra frame In some GUI styles a default button is drawn with an extra frame
around it, up to 3 pixels or more. Qt automatically keeps this around it, up to 3 pixels or more. Qt automatically keeps this
space free around auto-default buttons, i.e. auto-default buttons space free around auto-default buttons, i.e., auto-default buttons
may have a slightly larger size hint. may have a slightly larger size hint.
This property's default is true for buttons that have a QDialog This property's default is true for buttons that have a QDialog
@ -224,7 +224,7 @@ QT_BEGIN_NAMESPACE
If the default property is set to false on the current default button If the default property is set to false on the current default button
while the dialog is visible, a new default will automatically be while the dialog is visible, a new default will automatically be
assigned the next time a pushbutton in the dialog receives focus. assigned the next time a push button in the dialog receives focus.
This property's default is false. This property's default is false.
*/ */