?? qcheckbox.html
字號:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/widgets/qcheckbox.cpp:49 --><html><head><meta http-equiv="Content-Type" content="text/html; charset=gb2312"><meta name="Translator" content="Cavendish"><meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt"><title>QCheckBox類</title><style type="text/css"><!--h3.fn,span.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; font-family: "Times New Roman" }--></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">主頁</font></a> | <a href="classes.html"><font color="#004faf">所有的類</font></a> | <a href="mainclasses.html"><font color="#004faf">主要的類</font></a> | <a href="annotated.html"><font color="#004faf">注釋的類</font></a> | <a href="groups.html"><font color="#004faf">分組的類</font></a> | <a href="functions.html"><font color="#004faf">函數</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>QCheckBox類參考</h1><p>QCheckBox窗口部件提供一個帶文本標簽的復選框。<a href="#details">詳情請見……</a><p><tt>#include <<a href="qcheckbox-h.html">qcheckbox.h</a>></tt><p>繼承了<a href="qbutton.html">QButton</a>。<p><a href="qcheckbox-members.html">所有成員函數的列表。</a><h2>公有成員</h2><ul><li><div class=fn><a href="#QCheckBox"><b>QCheckBox</b></a> ( QWidget * parent, const char * name = 0 )</div></li><li><div class=fn><a href="#QCheckBox-2"><b>QCheckBox</b></a> ( const QString & text, QWidget * parent, const char * name = 0 )</div></li><li><div class=fn>bool <a href="#isChecked"><b>isChecked</b></a> () const</div></li><li><div class=fn>void <a href="#setNoChange"><b>setNoChange</b></a> ()</div></li><li><div class=fn>void <a href="#setTristate"><b>setTristate</b></a> ( bool y = TRUE )</div></li><li><div class=fn>bool <a href="#isTristate"><b>isTristate</b></a> () const</div></li></ul><h2>公有槽</h2><ul><li><div class=fn>void <a href="#setChecked"><b>setChecked</b></a> ( bool check )</div></li></ul><h2>重要的繼承成員</h2><ul><li><div class=fn>QString <a href="#text"><b>text</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setText"><b>setText</b></a> ( const QString & )</div></li><li><div class=fn>const QPixmap * <a href="#pixmap"><b>pixmap</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setPixmap"><b>setPixmap</b></a> ( const QPixmap & )</div></li><li><div class=fn>QKeySequence <a href="#accel"><b>accel</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setAccel"><b>setAccel</b></a> ( const QKeySequence & )</div></li><li><div class=fn>bool <a href="#isToggleButton"><b>isToggleButton</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setDown"><b>setDown</b></a> ( bool )</div></li><li><div class=fn>bool <a href="#isDown"><b>isDown</b></a> () const</div></li><li><div class=fn>bool <a href="#isOn"><b>isOn</b></a> () const</div></li><li><div class=fn>ToggleState <a href="#state"><b>state</b></a> () const</div></li><li><div class=fn>bool <a href="#autoRepeat"><b>autoRepeat</b></a> () const</div></li><li><div class=fn>virtual void <a href="#setAutoRepeat"><b>setAutoRepeat</b></a> ( bool )</div></li><li><div class=fn>bool <a href="#isExclusiveToggle"><b>isExclusiveToggle</b></a> () const</div></li><li><div class=fn>QButtonGroup * <a href="#group"><b>group</b></a> () const</div></li><li><div class=fn>void <a href="#toggle"><b>toggle</b></a> ()</div></li><li><div class=fn>void <a href="#pressed"><b>pressed</b></a> ()</div></li><li><div class=fn>void <a href="#released"><b>released</b></a> ()</div></li><li><div class=fn>void <a href="#clicked"><b>clicked</b></a> ()</div></li><li><div class=fn>void <a href="#toggled"><b>toggled</b></a> ( bool on )</div></li><li><div class=fn>void <a href="#stateChanged"><b>stateChanged</b></a> ( int state )</div></li></ul><h2>屬性</h2><ul><li><div class=fn>bool <a href="#autoMask-prop"><b>autoMask</b></a> - 復選框是否被自動遮蔽 <em>（只讀）</em></div></li><li><div class=fn>bool <a href="#checked-prop"><b>checked</b></a> - 復選框是否被選中</div></li><li><div class=fn>bool <a href="#tristate-prop"><b>tristate</b></a> - 復選框是否是三態復選框</div></li></ul><hr><a name="details"></a><h2>詳細描述</h2>QCheckBox窗口部件提供一個帶文本標簽的復選框。<p> <p> QCheckBox和<a href="qradiobutton.html">QRadioButton</a>都是選項按鈕。這是因為它們都可以在開（選中）或者關（未選中）之間切換。它們的區別是對用戶選擇的限制。單選框定義了“多選一”的選擇，而復選框提供的是“多選多”的選擇。<p> 盡管在技術上可以通過復選框來實現單選框的行為，反之亦然，但我們還是強烈建議使用眾所周知的約定。<p> <a href="qbuttongroup.html">QButtonGroup</a>可以用來在視覺上把許多復選框組織在一起。<p> 只要復選框被選中或者清除，它都會發射一個信號<a href="qbutton.html#toggled">toggled</a>()。如果你想在復選框改變狀態的時候觸發一個行為，請連接這個信號。你可以使用<a href="#isChecked">isChecked</a>()來查詢復選框是否被選中。<p> 除了常用的被選中和未選中兩個狀態，QCheckBox還可以任選地提供第三種狀態來表明“沒有改變”。當你需要給用戶一個選中或者未選中復選框的選擇時，這是很有用的。如果你需要第三種狀態，通過<a href="#setTristate">setTristate</a>()來使它生效并且使用<a href="qbutton.html#state">state</a>()來查詢當前的切換狀態。當三態復選框改變狀態時，它發射<a href="qbutton.html#stateChanged">stateChanged</a>()信號。<p> 和<a href="qpushbutton.html">QPushButton</a>一樣，復選框可以顯示文本或者像素映射。文本可以通過構造函數或者<a href="qbutton.html#setText">setText</a>()來設置，像素映射可以通過<a href="qbutton.html#setPixmap">setPixmap</a>()來設置。<p> <p> <img src=qchkbox-m.png> <img src=qchkbox-w.png><p> <p>也可以參考<a href="qbutton.html">QButton</a>、<a href="qradiobutton.html">QRadioButton</a>、<a href="guibooks.html#fowler">福勒：復選框</a>和<a href="basic.html">基本窗口部件</a>。<hr><h2>成員函數文檔</h2><h3 class=fn><a name="QCheckBox"></a>QCheckBox::QCheckBox ( <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )</h3>構造一個沒有文本的復選框。<p> <em>parent</em>和<em>name</em>參數被發送到<a href="qwidget.html">QWidget</a>的構造函數。<h3 class=fn><a name="QCheckBox-2"></a>QCheckBox::QCheckBox ( const <a href="qstring.html">QString</a> & text, <a href="qwidget.html">QWidget</a> * parent, const char * name = 0 )</h3>構造一個文本為<em>text</em>的復選框。<p> <em>parent</em>和<em>name</em>參數被發送到<a href="qwidget.html">QWidget</a>的構造函數。<h3 class=fn><a href="qkeysequence.html">QKeySequence</a> <a name="accel"></a>QButton::accel () const</h3><p>返回這個按鈕的相關快捷鍵。詳細情況請參考<a href="qbutton.html#accel-prop">“accel”</a>屬性。<h3 class=fn>bool <a name="autoRepeat"></a>QButton::autoRepeat () const</h3><p>如果autoRepeat生效，返回真，否則返回假。詳細情況請參考<a href="qbutton.html#autoRepeat-prop">“autoRepeat”</a>屬性。<h3 class=fn>void <a name="clicked"></a>QButton::clicked ()<tt> [信號]</tt></h3><p> 當按鈕被激活時（比如，當鼠標光標在按鈕中，按鈕首先被按下并且然后被釋放），或者當快捷鍵被按下時，或者<a href="#animateClick">animateClick</a>()被調用時，這個信號被發送。如果你調用<a href="#setDown">setDown</a>()，這個信號<em>不</em>被發送。<p> 如果你想把幾個按鈕連接到同一個槽中，<a href="qbuttongroup.html#clicked">QButtonGroup::clicked</a>()信號可以做這樣的工作。<p> <p>也可以參考<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>和<a href="qbutton.html#down-prop">down</a>。<p>實例：<a href="simple-qfont-demo-walkthrough.html#x2109">fonts/simple-qfont-demo/viewer.cpp</a>、<a href="listbox-example.html#x1309">listbox/listbox.cpp</a>、<a href="clientserver-example.html#x777">network/clientserver/client/client.cpp</a>、<a href="ftpclient-example.html#x649">network/ftpclient/ftpmainwindow.cpp</a>、<a href="richtext-example.html#x581">richtext/richtext.cpp</a>、<a href="tutorial1-02.html#x2277">t2/main.cpp</a>和<a href="tutorial1-04.html#x2293">t4/main.cpp</a>。<h3 class=fn><a href="qbuttongroup.html">QButtonGroup</a> * <a name="group"></a>QButton::group () const</h3> 返回這個按鈕所屬的按鈕組的指針。<p> 如果這個按鈕不是任何一個<a href="qbuttongroup.html">QButtonGroup</a>的成員，這個函數返回0。<p> <p>也可以參考<a href="qbuttongroup.html">QButtonGroup</a>。<h3 class=fn>bool <a name="isChecked"></a>QCheckBox::isChecked () const</h3><p>如果復選框被選中，返回真，否則返回假。詳細情況請參考<a href="qcheckbox.html#checked-prop">“checked”</a>屬性。<h3 class=fn>bool <a name="isDown"></a>QButton::isDown () const</h3><p>如果按鈕被按下，返回真，否則返回假。詳細情況請參考<a href="qbutton.html#down-prop">“down”</a>屬性。<h3 class=fn>bool <a name="isExclusiveToggle"></a>QButton::isExclusiveToggle () const?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -