Sophie

Sophie

distrib > * > 2009.0 > i586 > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 2060

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QGroupBox" doc="/**
&lt;p&gt;The &lt;a href=&quot;QGroupBox.html#QGroupBox(java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QGroupBox&lt;/tt&gt;&lt;/a&gt; widget provides a group box frame with a title.&lt;/p&gt;
&lt;p&gt;A group box provides a frame, a title and a keyboard shortcut, and displays various other widgets inside itself. The title is on top, the keyboard shortcut moves keyboard focus to one of the group box's child widgets.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;QGroupBox.html#QGroupBox(java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QGroupBox&lt;/tt&gt;&lt;/a&gt; also lets you set the &lt;a href=&quot;QGroupBox.html#title()&quot;&gt;title&lt;/tt&gt;&lt;/a&gt; (normally set in the constructor) and the title's &lt;a href=&quot;QGroupBox.html#alignment()&quot;&gt;alignment&lt;/tt&gt;&lt;/a&gt;. Group boxes can be checkable&lt;/tt&gt;; child widgets in checkable group boxes are enabled or disabled depending on whether or not the group box is checked&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;You can minimize the space consumption of a group box by enabling the flat&lt;/tt&gt; property. In most &lt;a href=&quot;QStyle.html&quot;&gt;styles&lt;/tt&gt;&lt;/a&gt;, enabling this property results in the removal of the left, right and bottom edges of the frame.&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;QGroupBox.html#QGroupBox(java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QGroupBox&lt;/tt&gt;&lt;/a&gt; doesn't automatically lay out the child widgets (which are often &lt;a href=&quot;QCheckBox.html&quot;&gt;&lt;tt&gt;QCheckBox&lt;/tt&gt;&lt;/a&gt;es or &lt;a href=&quot;QRadioButton.html&quot;&gt;&lt;tt&gt;QRadioButton&lt;/tt&gt;&lt;/a&gt;s but can be any widgets). The following example shows how we can set up a &lt;a href=&quot;QGroupBox.html#QGroupBox(java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QGroupBox&lt;/tt&gt;&lt;/a&gt; with a layout:&lt;/p&gt;
&lt;pre&gt;        QGroupBox *groupBox = new QGroupBox(tr(&amp;quot;Exclusive Radio Buttons&amp;quot;));

        QRadioButton *radio1 = new QRadioButton(tr(&amp;quot;&amp;amp;Radio button 1&amp;quot;));
        QRadioButton *radio2 = new QRadioButton(tr(&amp;quot;R&amp;amp;adio button 2&amp;quot;));
        QRadioButton *radio3 = new QRadioButton(tr(&amp;quot;Ra&amp;amp;dio button 3&amp;quot;));

        radio1-&amp;gt;setChecked(true);

        QVBoxLayout *vbox = new QVBoxLayout;
        vbox-&amp;gt;addWidget(radio1);
        vbox-&amp;gt;addWidget(radio2);
        vbox-&amp;gt;addWidget(radio3);
        vbox-&amp;gt;addStretch(1);
        groupBox-&amp;gt;setLayout(vbox);&lt;/pre&gt;
&lt;p&gt;&lt;table width=&quot;100%&quot; align=&quot;center&quot; cellpadding=&quot;2&quot; cellspacing=&quot;1&quot; border=&quot;0&quot;&gt;
&lt;tr valign=&quot;top&quot; class=&quot;odd&quot;&gt;&lt;td&gt;&lt;img src=&quot;%2E%2E/images/windowsxp-groupbox.png&quot; alt=&quot;Screenshot of a Windows XP style group box&quot; /&gt;&lt;/td&gt;&lt;td&gt;&lt;img src=&quot;%2E%2E/images/macintosh-groupbox.png&quot; alt=&quot;Screenshot of a Macintosh style group box&quot; /&gt;&lt;/td&gt;&lt;td&gt;&lt;img src=&quot;%2E%2E/images/plastique-groupbox.png&quot; alt=&quot;Screenshot of a Plastique style group box&quot; /&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr valign=&quot;top&quot; class=&quot;even&quot;&gt;&lt;td&gt;A &lt;a href=&quot;%2E%2E/gallery-windowsxp.html&quot;&gt;Windows XP style&lt;/tt&gt;&lt;/a&gt; group box.&lt;/td&gt;&lt;td&gt;A &lt;a href=&quot;%2E%2E/gallery-macintosh.html&quot;&gt;Macintosh style&lt;/tt&gt;&lt;/a&gt; group box.&lt;/td&gt;&lt;td&gt;A &lt;a href=&quot;%2E%2E/gallery-plastique.html&quot;&gt;Plastique style&lt;/tt&gt;&lt;/a&gt; group box.&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;&lt;/p&gt;

@see &lt;a href=&quot;QButtonGroup.html&quot;&gt;&lt;tt&gt;QButtonGroup&lt;/tt&gt;&lt;/a&gt;
@see Group Box Example&lt;/tt&gt; */">
    <signal name="protected final void clicked(boolean checked)" doc="/**
&lt;p&gt;This signal is emitted when the check box is activated (i.e&amp;#x2e; pressed down then released while the mouse cursor is inside the button), or when the shortcut key is typed, Notably, this signal is &lt;i&gt;not&lt;/i&gt; emitted if you call &lt;a href=&quot;QGroupBox.html#setChecked(boolean)&quot;&gt;&lt;tt&gt;setChecked&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;If the check box is checked &lt;tt&gt;checked&lt;/tt&gt; is true; it is false if the check box is unchecked.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(boolean checked)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;checkable&lt;/tt&gt;, &lt;a href=&quot;QGroupBox.html#toggled(boolean)&quot;&gt;&lt;tt&gt;toggled&lt;/tt&gt;&lt;/a&gt;, checked&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void customContextMenuRequested(com.trolltech.qt.core.QPoint pos)" doc="/**
&lt;p&gt;This signal is emitted when the widget's &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt; is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position &lt;tt&gt;pos&lt;/tt&gt; is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is &lt;a href=&quot;QAbstractScrollArea.html&quot;&gt;&lt;tt&gt;QAbstractScrollArea&lt;/tt&gt;&lt;/a&gt; and its subclasses that map the context menu event to coordinates of the viewport()&lt;/tt&gt; .&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(com.trolltech.qt.core.QPoint pos)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QWidget.html#mapToGlobal(com.trolltech.qt.core.QPoint)&quot;&gt;&lt;tt&gt;mapToGlobal&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QMenu.html&quot;&gt;&lt;tt&gt;QMenu&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void toggled(boolean arg__1)" doc="/**
&lt;p&gt;If the group box is checkable, this signal is emitted when the check box is toggled. &lt;tt&gt;arg__1&lt;/tt&gt; is true if the check box is checked; otherwise it is false.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(boolean arg__1)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;checkable&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <method name="public QGroupBox(com.trolltech.qt.gui.QWidget parent)" doc="/**
&lt;p&gt;Constructs a group box widget with the given &lt;tt&gt;parent&lt;/tt&gt; but with no title.&lt;/p&gt;
 */"/>
    <method name="public QGroupBox()" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QGroupBox.html#QGroupBox(java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QGroupBox&lt;/tt&gt;&lt;/a&gt;(0). */"/>
    <method name="public QGroupBox(java.lang.String title, com.trolltech.qt.gui.QWidget parent)" doc="/**
&lt;p&gt;Constructs a group box with the given &lt;tt&gt;title&lt;/tt&gt; and &lt;tt&gt;parent&lt;/tt&gt;.&lt;/p&gt;
 */"/>
    <method name="public QGroupBox(java.lang.String title)" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QGroupBox.html#QGroupBox(java.lang.String, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QGroupBox&lt;/tt&gt;&lt;/a&gt;(&lt;tt&gt;title&lt;/tt&gt;, 0). */"/>
    <method name="public final com.trolltech.qt.core.Qt.Alignment alignment()" doc="/**
&lt;p&gt;Returns the alignment of the group box title..&lt;/p&gt;
&lt;p&gt;Most styles place the title at the top of the frame. The horizontal alignment of the title can be specified using single values from the following list:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Qt::AlignLeft aligns the title text with the left-hand side of the group box.&lt;/li&gt;
&lt;li&gt;Qt::AlignRight aligns the title text with the right-hand side of the group box.&lt;/li&gt;
&lt;li&gt;Qt::AlignHCenter aligns the title text with the horizontal center of the group box.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The default alignment is Qt::AlignLeft.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#setAlignment(int)&quot;&gt;&lt;tt&gt;setAlignment&lt;/tt&gt;&lt;/a&gt;
@see Qt::Alignment&lt;/tt&gt; */"/>
    <method name="public final boolean isCheckable()" doc="/**
&lt;p&gt;Returns whether the group box has a checkbox in its title.&lt;/p&gt;
&lt;p&gt;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, the group box's children are enabled; otherwise they are disabled and inaccessible.&lt;/p&gt;
&lt;p&gt;By default, group boxes are not checkable.&lt;/p&gt;
&lt;p&gt;If this property is enabled for a group box, it will also be initially checked to ensure that its contents are enabled.&lt;/p&gt;

@see checked&lt;/tt&gt; */"/>
    <method name="public final boolean isChecked()" doc="/**
&lt;p&gt;Returns whether the group box is checked.&lt;/p&gt;
&lt;p&gt;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; otherwise the children are disabled and are inaccessible to the user.&lt;/p&gt;
&lt;p&gt;By default, checkable group boxes are also checked.&lt;/p&gt;

@see checkable&lt;/tt&gt; */"/>
    <method name="public final boolean isFlat()" doc="/**
&lt;p&gt;Returns whether the group box is painted flat or has a frame.&lt;/p&gt;
&lt;p&gt;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 drawn in most styles; otherwise the whole frame is drawn.&lt;/p&gt;
&lt;p&gt;By default, this property is disabled; i.e&amp;#x2e; group boxes are not flat unless explicitly specified.&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Note:&lt;/b&gt; In some styles, flat and non-flat group boxes have similar representations and may not be as distinguishable as they are in other styles.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#title()&quot;&gt;title&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setAlignment(int alignment)" doc="/**
&lt;p&gt;Sets the alignment of the group box title. to &lt;tt&gt;alignment&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;Most styles place the title at the top of the frame. The horizontal alignment of the title can be specified using single values from the following list:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Qt::AlignLeft aligns the title text with the left-hand side of the group box.&lt;/li&gt;
&lt;li&gt;Qt::AlignRight aligns the title text with the right-hand side of the group box.&lt;/li&gt;
&lt;li&gt;Qt::AlignHCenter aligns the title text with the horizontal center of the group box.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The default alignment is Qt::AlignLeft.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#alignment()&quot;&gt;&lt;tt&gt;alignment&lt;/tt&gt;&lt;/a&gt;
@see Qt::Alignment&lt;/tt&gt; */"/>
    <method name="public final void setCheckable(boolean checkable)" doc="/**
&lt;p&gt;Sets whether the group box has a checkbox in its title to &lt;tt&gt;checkable&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;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, the group box's children are enabled; otherwise they are disabled and inaccessible.&lt;/p&gt;
&lt;p&gt;By default, group boxes are not checkable.&lt;/p&gt;
&lt;p&gt;If this property is enabled for a group box, it will also be initially checked to ensure that its contents are enabled.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#isCheckable()&quot;&gt;&lt;tt&gt;isCheckable&lt;/tt&gt;&lt;/a&gt;
@see checked&lt;/tt&gt; */"/>
    <method name="public final void setChecked(boolean checked)" doc="/**
&lt;p&gt;Sets whether the group box is checked to &lt;tt&gt;checked&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;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; otherwise the children are disabled and are inaccessible to the user.&lt;/p&gt;
&lt;p&gt;By default, checkable group boxes are also checked.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#isChecked()&quot;&gt;&lt;tt&gt;isChecked&lt;/tt&gt;&lt;/a&gt;
@see checkable&lt;/tt&gt; */"/>
    <method name="public final void setFlat(boolean flat)" doc="/**
&lt;p&gt;Sets whether the group box is painted flat or has a frame to &lt;tt&gt;flat&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;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 drawn in most styles; otherwise the whole frame is drawn.&lt;/p&gt;
&lt;p&gt;By default, this property is disabled; i.e&amp;#x2e; group boxes are not flat unless explicitly specified.&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Note:&lt;/b&gt; In some styles, flat and non-flat group boxes have similar representations and may not be as distinguishable as they are in other styles.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#isFlat()&quot;&gt;&lt;tt&gt;isFlat&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QGroupBox.html#title()&quot;&gt;title&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final void setTitle(java.lang.String title)" doc="/**
&lt;p&gt;Sets the group box title text to &lt;tt&gt;title&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;The group box title text will have a keyboard shortcut if the title contains an ampersand ('&amp;amp;') followed by a letter.&lt;/p&gt;
&lt;pre&gt;    g-&amp;gt;setTitle(&amp;quot;&amp;amp;User information&amp;quot;);&lt;/pre&gt;
&lt;p&gt;In the example above, &lt;b&gt;Alt+U&lt;/b&gt; moves the keyboard focus to the group box. See the &lt;a href=&quot;QShortcut.html#mnemonic&quot;&gt;QShortcut&lt;/a&gt; documentation for details (to display an actual ampersand, use '&amp;amp;&amp;amp;').&lt;/p&gt;
&lt;p&gt;There is no default title text.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#title()&quot;&gt;&lt;tt&gt;title&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QGroupBox.html#alignment()&quot;&gt;alignment&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final java.lang.String title()" doc="/**
&lt;p&gt;Returns the group box title text.&lt;/p&gt;
&lt;p&gt;The group box title text will have a keyboard shortcut if the title contains an ampersand ('&amp;amp;') followed by a letter.&lt;/p&gt;
&lt;pre&gt;    g-&amp;gt;setTitle(&amp;quot;&amp;amp;User information&amp;quot;);&lt;/pre&gt;
&lt;p&gt;In the example above, &lt;b&gt;Alt+U&lt;/b&gt; moves the keyboard focus to the group box. See the &lt;a href=&quot;QShortcut.html#mnemonic&quot;&gt;QShortcut&lt;/a&gt; documentation for details (to display an actual ampersand, use '&amp;amp;&amp;amp;').&lt;/p&gt;
&lt;p&gt;There is no default title text.&lt;/p&gt;

@see &lt;a href=&quot;QGroupBox.html#setTitle(java.lang.String)&quot;&gt;&lt;tt&gt;setTitle&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QGroupBox.html#alignment()&quot;&gt;alignment&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="protected void changeEvent(com.trolltech.qt.core.QEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void childEvent(com.trolltech.qt.core.QChildEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="public boolean event(com.trolltech.qt.core.QEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void focusInEvent(com.trolltech.qt.gui.QFocusEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="public com.trolltech.qt.core.QSize minimumSizeHint()" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void mouseMoveEvent(com.trolltech.qt.gui.QMouseEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void mousePressEvent(com.trolltech.qt.gui.QMouseEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void mouseReleaseEvent(com.trolltech.qt.gui.QMouseEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void paintEvent(com.trolltech.qt.gui.QPaintEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
    <method name="protected void resizeEvent(com.trolltech.qt.gui.QResizeEvent event)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
</class>