diff options
Diffstat (limited to 'doc/html/qradiobutton.html')
| -rw-r--r-- | doc/html/qradiobutton.html | 278 |
1 files changed, 278 insertions, 0 deletions
diff --git a/doc/html/qradiobutton.html b/doc/html/qradiobutton.html new file mode 100644 index 0000000..b3cd20f --- /dev/null +++ b/doc/html/qradiobutton.html @@ -0,0 +1,278 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/widgets/qradiobutton.cpp:50 --> +<html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> +<title>QRadioButton Class</title> +<style type="text/css"><!-- +fn { margin-left: 1cm; text-indent: -1cm; } +a:link { color: #004faf; text-decoration: none } +a:visited { color: #672967; text-decoration: none } +body { background: #ffffff; color: black; } +--></style> +</head> +<body> + +<table border="0" cellpadding="0" cellspacing="0" width="100%"> +<tr bgcolor="#E5E5E5"> +<td valign=center> + <a href="index.html"> +<font color="#004faf">Home</font></a> + | <a href="classes.html"> +<font color="#004faf">All Classes</font></a> + | <a href="mainclasses.html"> +<font color="#004faf">Main Classes</font></a> + | <a href="annotated.html"> +<font color="#004faf">Annotated</font></a> + | <a href="groups.html"> +<font color="#004faf">Grouped Classes</font></a> + | <a href="functions.html"> +<font color="#004faf">Functions</font></a> +</td> +<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>QRadioButton Class Reference</h1> + +<p>The QRadioButton widget provides a radio button with a text or pixmap label. +<a href="#details">More...</a> +<p><tt>#include <<a href="qradiobutton-h.html">qradiobutton.h</a>></tt> +<p>Inherits <a href="qbutton.html">QButton</a>. +<p><a href="qradiobutton-members.html">List of all member functions.</a> +<h2>Public Members</h2> +<ul> +<li class=fn><a href="#QRadioButton"><b>QRadioButton</b></a> ( QWidget * parent, const char * name = 0 )</li> +<li class=fn><a href="#QRadioButton-2"><b>QRadioButton</b></a> ( const QString & text, QWidget * parent, const char * name = 0 )</li> +<li class=fn>bool <a href="#isChecked"><b>isChecked</b></a> () const</li> +</ul> +<h2>Public Slots</h2> +<ul> +<li class=fn>virtual void <a href="#setChecked"><b>setChecked</b></a> ( bool check )</li> +</ul> +<h2>Important Inherited Members</h2> +<ul> +<li class=fn>QString <a href="#text"><b>text</b></a> () const</li> +<li class=fn>virtual void <a href="#setText"><b>setText</b></a> ( const QString & )</li> +<li class=fn>const QPixmap * <a href="#pixmap"><b>pixmap</b></a> () const</li> +<li class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( const QPixmap & )</li> +<li class=fn>QKeySequence <a href="#accel"><b>accel</b></a> () const</li> +<li class=fn>virtual void <a href="#setAccel"><b>setAccel</b></a> ( const QKeySequence & )</li> +<li class=fn>bool <a href="#isToggleButton"><b>isToggleButton</b></a> () const</li> +<li class=fn>virtual void <a href="#setDown"><b>setDown</b></a> ( bool )</li> +<li class=fn>bool <a href="#isDown"><b>isDown</b></a> () const</li> +<li class=fn>bool <a href="#isOn"><b>isOn</b></a> () const</li> +<li class=fn>ToggleState <a href="#state"><b>state</b></a> () const</li> +<li class=fn>bool <a href="#autoRepeat"><b>autoRepeat</b></a> () const</li> +<li class=fn>virtual void <a href="#setAutoRepeat"><b>setAutoRepeat</b></a> ( bool )</li> +<li class=fn>bool <a href="#isExclusiveToggle"><b>isExclusiveToggle</b></a> () const</li> +<li class=fn>QButtonGroup * <a href="#group"><b>group</b></a> () const</li> +<li class=fn>void <a href="#toggle"><b>toggle</b></a> ()</li> +<li class=fn>void <a href="#pressed"><b>pressed</b></a> ()</li> +<li class=fn>void <a href="#released"><b>released</b></a> ()</li> +<li class=fn>void <a href="#clicked"><b>clicked</b></a> ()</li> +<li class=fn>void <a href="#toggled"><b>toggled</b></a> ( bool on )</li> +<li class=fn>void <a href="#stateChanged"><b>stateChanged</b></a> ( int state )</li> +</ul> +<h2>Properties</h2> +<ul> +<li class=fn>bool <a href="#autoMask-prop"><b>autoMask</b></a> - whether the radio button is automatically masked <em>(read only)</em></li> +<li class=fn>bool <a href="#checked-prop"><b>checked</b></a> - whether the radio button is checked</li> +</ul> +<hr><a name="details"></a><h2>Detailed Description</h2> + + +The QRadioButton widget provides a radio button with a text or pixmap label. +<p> + +<p> QRadioButton and <a href="qcheckbox.html">QCheckBox</a> are both option buttons. That is, they +can be switched on (checked) or off (unchecked). The classes +differ in how the choices for the user are restricted. Check boxes +define "many of many" choices, whereas radio buttons provide a +"one of many" choice. In a group of radio buttons only one radio +button at a time can be checked; if the user selects another +button, the previously selected button is switched off. +<p> The easiest way to implement a "one of many" choice is simply to +put the radio buttons into <a href="qbuttongroup.html">QButtonGroup</a>. +<p> Whenever a button is switched on or off it emits the signal +<a href="qbutton.html#toggled">toggled</a>(). Connect to this signal if you want to trigger an action +each time the button changes state. Otherwise, use <a href="#isChecked">isChecked</a>() to +see if a particular button is selected. +<p> Just like <a href="qpushbutton.html">QPushButton</a>, a radio button can display text or a +pixmap. The text can be set in the constructor or with <a href="qbutton.html#setText">setText</a>(); +the pixmap is set with <a href="qbutton.html#setPixmap">setPixmap</a>(). +<p> <img src=qradiobt-m.png> <img src=qradiobt-w.png> +<p> +<p> <p>See also <a href="qpushbutton.html">QPushButton</a>, <a href="qtoolbutton.html">QToolButton</a>, <a href="guibooks.html#fowler">GUI Design Handbook: Radio Button</a>, and <a href="basic.html">Basic Widgets</a>. + +<hr><h2>Member Function Documentation</h2> +<h3 class=fn><a name="QRadioButton"></a>QRadioButton::QRadioButton ( <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 ) +</h3> +Constructs a radio button with no text. +<p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a> +constructor. + +<h3 class=fn><a name="QRadioButton-2"></a>QRadioButton::QRadioButton ( const <a href="qstring.html">QString</a> & text, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 ) +</h3> +Constructs a radio button with the text <em>text</em>. +<p> The <em>parent</em> and <em>name</em> arguments are sent on to the <a href="qwidget.html">QWidget</a> +constructor. + +<h3 class=fn><a href="qkeysequence.html">QKeySequence</a> <a name="accel"></a>QButton::accel () const +</h3><p>Returns the accelerator associated with the button. +See the <a href="qbutton.html#accel-prop">"accel"</a> property for details. +<h3 class=fn>bool <a name="autoRepeat"></a>QButton::autoRepeat () const +</h3><p>Returns TRUE if autoRepeat is enabled; otherwise returns FALSE. +See the <a href="qbutton.html#autoRepeat-prop">"autoRepeat"</a> property for details. +<h3 class=fn>void <a name="clicked"></a>QButton::clicked ()<tt> [signal]</tt> +</h3> + +<p> This signal is emitted when the button is activated (i.e. first +pressed down and then released when the mouse cursor is inside the +button), when the accelerator key is typed or when <a href="qbutton.html#animateClick">animateClick</a>() +is called. This signal is <em>not</em> emitted if you call <a href="qbutton.html#setDown">setDown</a>(). +<p> The <a href="qbuttongroup.html#clicked">QButtonGroup::clicked</a>() signal does the same job, if you want +to connect several buttons to the same slot. +<p> <b>Warning:</b> Don't launch a model dialog in response to this signal +for a button that has <a href="qbutton.html#autoRepeat-prop">autoRepeat</a> turned on. +<p> <p>See also <a href="qbutton.html#pressed">pressed</a>(), <a href="qbutton.html#released">released</a>(), <a href="qbutton.html#toggled">toggled</a>(), <a href="qbutton.html#autoRepeat-prop">autoRepeat</a>, and <a href="qbutton.html#down-prop">down</a>. + +<p>Examples: <a href="tutorial2-08.html#x2596">chart/setdataform.cpp</a>, <a href="listbox-example.html#x1426">listbox/listbox.cpp</a>, <a href="clientserver-example.html#x792">network/clientserver/client/client.cpp</a>, <a href="progressbar-example.html#x962">progressbar/progressbar.cpp</a>, <a href="richtext-example.html#x462">richtext/richtext.cpp</a>, <a href="tutorial1-02.html#x2290">t2/main.cpp</a>, and <a href="tutorial1-04.html#x2306">t4/main.cpp</a>. +<h3 class=fn><a href="qbuttongroup.html">QButtonGroup</a> * <a name="group"></a>QButton::group () const +</h3> +Returns the group that this button belongs to. +<p> If the button is not a member of any <a href="qbuttongroup.html">QButtonGroup</a>, this function +returns 0. +<p> <p>See also <a href="qbuttongroup.html">QButtonGroup</a>. + +<h3 class=fn>bool <a name="isChecked"></a>QRadioButton::isChecked () const +</h3><p>Returns TRUE if the radio button is checked; otherwise returns FALSE. +See the <a href="qradiobutton.html#checked-prop">"checked"</a> property for details. +<h3 class=fn>bool <a name="isDown"></a>QButton::isDown () const +</h3><p>Returns TRUE if the button is pressed; otherwise returns FALSE. +See the <a href="qbutton.html#down-prop">"down"</a> property for details. +<h3 class=fn>bool <a name="isExclusiveToggle"></a>QButton::isExclusiveToggle () const +</h3><p>Returns TRUE if the button is an exclusive toggle; otherwise returns FALSE. +See the <a href="qbutton.html#exclusiveToggle-prop">"exclusiveToggle"</a> property for details. +<h3 class=fn>bool <a name="isOn"></a>QButton::isOn () const +</h3><p>Returns TRUE if the button is toggled; otherwise returns FALSE. +See the <a href="qbutton.html#on-prop">"on"</a> property for details. +<h3 class=fn>bool <a name="isToggleButton"></a>QButton::isToggleButton () const +</h3><p>Returns TRUE if the button is a toggle button; otherwise returns FALSE. +See the <a href="qbutton.html#toggleButton-prop">"toggleButton"</a> property for details. +<h3 class=fn>const <a href="qpixmap.html">QPixmap</a> * <a name="pixmap"></a>QButton::pixmap () const +</h3><p>Returns the pixmap shown on the button. +See the <a href="qbutton.html#pixmap-prop">"pixmap"</a> property for details. +<h3 class=fn>void <a name="pressed"></a>QButton::pressed ()<tt> [signal]</tt> +</h3> + +<p> This signal is emitted when the button is pressed down. +<p> <p>See also <a href="qbutton.html#released">released</a>() and <a href="qbutton.html#clicked">clicked</a>(). + +<p>Examples: <a href="httpd-example.html#x724">network/httpd/httpd.cpp</a> and <a href="popup-example.html#x1606">popup/popup.cpp</a>. +<h3 class=fn>void <a name="released"></a>QButton::released ()<tt> [signal]</tt> +</h3> + +<p> This signal is emitted when the button is released. +<p> <p>See also <a href="qbutton.html#pressed">pressed</a>(), <a href="qbutton.html#clicked">clicked</a>(), and <a href="qbutton.html#toggled">toggled</a>(). + +<h3 class=fn>void <a name="setAccel"></a>QButton::setAccel ( const <a href="qkeysequence.html">QKeySequence</a> & )<tt> [virtual]</tt> +</h3><p>Sets the accelerator associated with the button. +See the <a href="qbutton.html#accel-prop">"accel"</a> property for details. +<h3 class=fn>void <a name="setAutoRepeat"></a>QButton::setAutoRepeat ( bool )<tt> [virtual]</tt> +</h3><p>Sets whether autoRepeat is enabled. +See the <a href="qbutton.html#autoRepeat-prop">"autoRepeat"</a> property for details. +<h3 class=fn>void <a name="setChecked"></a>QRadioButton::setChecked ( bool check )<tt> [virtual slot]</tt> +</h3><p>Sets whether the radio button is checked to <em>check</em>. +See the <a href="qradiobutton.html#checked-prop">"checked"</a> property for details. +<h3 class=fn>void <a name="setDown"></a>QButton::setDown ( bool )<tt> [virtual]</tt> +</h3><p>Sets whether the button is pressed. +See the <a href="qbutton.html#down-prop">"down"</a> property for details. +<h3 class=fn>void <a name="setPixmap"></a>QButton::setPixmap ( const <a href="qpixmap.html">QPixmap</a> & )<tt> [virtual]</tt> +</h3><p>Sets the pixmap shown on the button. +See the <a href="qbutton.html#pixmap-prop">"pixmap"</a> property for details. +<h3 class=fn>void <a name="setText"></a>QButton::setText ( const <a href="qstring.html">QString</a> & )<tt> [virtual]</tt> +</h3><p>Sets the text shown on the button. +See the <a href="qbutton.html#text-prop">"text"</a> property for details. +<h3 class=fn><a href="qbutton.html#ToggleState-enum">ToggleState</a> <a name="state"></a>QButton::state () const +</h3><p>Returns the state of the toggle button. +See the <a href="qbutton.html#toggleState-prop">"toggleState"</a> property for details. +<h3 class=fn>void <a name="stateChanged"></a>QButton::stateChanged ( int state )<tt> [signal]</tt> +</h3> + +<p> This signal is emitted whenever a toggle button changes state. <em>state</em> is <a href="qbutton.html#ToggleState-enum">On</a> if the button is on, <a href="qbutton.html#ToggleState-enum">NoChange</a> if it is in the +<a href="qcheckbox.html#setTristate">"no change" state</a> or <a href="qbutton.html#ToggleState-enum">Off</a> +if the button is off. +<p> This may be the result of a user action, <a href="qbutton.html#toggle">toggle</a>() slot activation, +<a href="qbutton.html#setState">setState</a>(), or because <a href="qbutton.html#setOn">setOn</a>() was called. +<p> <p>See also <a href="qbutton.html#clicked">clicked</a>() and <a href="qbutton.html#ToggleState-enum">QButton::ToggleState</a>. + +<h3 class=fn><a href="qstring.html">QString</a> <a name="text"></a>QButton::text () const +</h3><p>Returns the text shown on the button. +See the <a href="qbutton.html#text-prop">"text"</a> property for details. +<h3 class=fn>void <a name="toggle"></a>QButton::toggle ()<tt> [slot]</tt> +</h3> +Toggles the state of a toggle button. +<p> <p>See also <a href="qbutton.html#on-prop">on</a>, <a href="qbutton.html#setOn">setOn</a>(), <a href="qbutton.html#toggled">toggled</a>(), and <a href="qbutton.html#toggleButton-prop">toggleButton</a>. + +<h3 class=fn>void <a name="toggled"></a>QButton::toggled ( bool on )<tt> [signal]</tt> +</h3> + +<p> This signal is emitted whenever a toggle button changes status. <em>on</em> is TRUE if the button is on, or FALSE if the button is off. +<p> This may be the result of a user action, <a href="qbutton.html#toggle">toggle</a>() slot activation, +or because <a href="qbutton.html#setOn">setOn</a>() was called. +<p> <p>See also <a href="qbutton.html#clicked">clicked</a>(). + +<p>Example: <a href="listbox-example.html#x1427">listbox/listbox.cpp</a>. +<hr><h2>Property Documentation</h2> +<h3 class=fn><a href="qkeysequence.html">QKeySequence</a> <a name="accel-prop"></a>accel</h3> +<p>This property holds the accelerator associated with the button. +<p>This property is 0 if there is no accelerator set. If you set this +property to 0 then any current accelerator is removed. + +<p>Set this property's value with <a href="#setAccel">setAccel</a>() and get this property's value with <a href="#accel">accel</a>(). +<h3 class=fn>bool <a name="autoMask-prop"></a>autoMask</h3> +<p>This property holds whether the radio button is automatically masked. +<p><p><p>See also <a href="qwidget.html#autoMask-prop">QWidget::autoMask</a>. + +<h3 class=fn>bool <a name="autoRepeat-prop"></a>autoRepeat</h3> +<p>This property holds whether autoRepeat is enabled. +<p>If autoRepeat is enabled then the <a href="qbutton.html#clicked">clicked</a>() signal is emitted at +regular intervals if the button is down. This property has no +effect on toggle buttons. autoRepeat is off by default. + +<p>Set this property's value with <a href="#setAutoRepeat">setAutoRepeat</a>() and get this property's value with <a href="#autoRepeat">autoRepeat</a>(). +<h3 class=fn>bool <a name="checked-prop"></a>checked</h3> +<p>This property holds whether the radio button is checked. +<p>This property will not effect any other radio buttons unless they +have been placed in the same <a href="qbuttongroup.html">QButtonGroup</a>. The default value is +FALSE (unchecked). + +<p>Set this property's value with <a href="#setChecked">setChecked</a>() and get this property's value with <a href="#isChecked">isChecked</a>(). +<h3 class=fn><a href="qpixmap.html">QPixmap</a> <a name="pixmap-prop"></a>pixmap</h3> +<p>This property holds the pixmap shown on the button. +<p>If the pixmap is monochrome (i.e. it is a <a href="qbitmap.html">QBitmap</a> or its <a href="qpixmap.html#depth">depth</a> is 1) and it does not have a mask, +this property will set the pixmap to be its own mask. The purpose +of this is to draw transparent bitmaps which are important for +toggle buttons, for example. +<p> <a href="qbutton.html#pixmap">pixmap</a>() returns 0 if no pixmap was set. + +<p>Set this property's value with <a href="#setPixmap">setPixmap</a>() and get this property's value with <a href="#pixmap">pixmap</a>(). +<h3 class=fn><a href="qstring.html">QString</a> <a name="text-prop"></a>text</h3> +<p>This property holds the text shown on the button. +<p>This property will return a <a href="qstring.html#QString-null">QString::null</a> if the button has no +text. If the text has an ampersand (&) in it, then an +accelerator is automatically created for it using the character +that follows the '&' as the accelerator key. Any previous +accelerator will be overwritten, or cleared if no accelerator is +defined by the text. +<p> There is no default text. + +<p>Set this property's value with <a href="#setText">setText</a>() and get this property's value with <a href="#text">text</a>(). +<!-- eof --> +<hr><p> +This file is part of the <a href="index.html">Qt toolkit</a>. +Copyright © 1995-2007 +<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center> +<table width=100% cellspacing=0 border=0><tr> +<td>Copyright © 2007 +<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> +<td align=right><div align=right>Qt 3.3.8</div> +</table></div></address></body> +</html> |