📄 categoryselect.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><!-- /home/edba/dist/qtopia/main-Sunday/qtopia/src/libraries/qtopia/categoryselect.cpp:46 --><html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>CategorySelect Class</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; }--></style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr><td width="200" align="left" valign="top"><a href="index.html"><img height="27" width="472" src="dochead.png" border="0"></a><br><font face="Arial,Helvetica,Geneva,Swiss,SunSans-Regular" align="center" size=32>Qtopia</font> <a href="index.html">Home</a> - <a href="qtopiaclasses.html">Classes</a> - <a href="qtopiaannotated.html">Annotated</a> - <a href="qtopiafunctions.html">Functions</a> - <a href="qtindex.html">Qt Embedded</a></td><td align="right" valign="top"> <table border="0" cellpadding="0" cellspacing="0" width="137"> <tr> <td><a href="http://www.trolltech.com/company/about/trolls.html"><img height="100" width="100" src="face.png" border="0"></a></td> <td><img height="100" width="100" src="qtlogo.png" align="top" border="0"></td> </tr> </table></td></tr></table><h1 align=center>CategorySelect Class Reference</h1><p>The CategorySelect widget allows users to select Categories with acombobox interface.<a href="#details">More...</a><p><tt>#include <<a href="categoryselect-h.html">categoryselect.h</a>></tt><p><a href="categoryselect-members.html">List of all member functions.</a><h2>Public Members</h2><ul><li><div class=fn><a href="#CategorySelect"><b>CategorySelect</b></a> ( QWidget * parent = 0, const char * name = 0, int width = 0 )</div></li><li><div class=fn><a href="#CategorySelect-2"><b>CategorySelect</b></a> ( const QArray<int> & vl, const QString & appName, QWidget * parent = 0, const char * name = 0, int width = 0 )</div></li><li><div class=fn><a href="#CategorySelect-3"><b>CategorySelect</b></a> ( const QArray<int> & vl, const QString & appName, const QString & visibleName, QWidget * parent = 0, const char * name = 0, int width = 0 )</div></li><li><div class=fn><a href="#CategorySelect-4"><b>CategorySelect</b></a> ( const QArray<int> & vlCats, const QString & appName, const QString & visibleName, bool allCategories, QWidget * parent = 0, const char * name = 0, int width = 0 )</div></li><li><div class=fn><a href="#~CategorySelect"><b>~CategorySelect</b></a> ()</div></li><li><div class=fn>enum <a href="#SelectorWidget-enum"><b>SelectorWidget</b></a> { ComboBox, ListView }</div></li><li><div class=fn>SelectorWidget <a href="#widgetType"><b>widgetType</b></a> () const</div></li><li><div class=fn>bool <a href="#containsCategory"><b>containsCategory</b></a> ( const QArray<int> & cats )</div></li><li><div class=fn>void <a href="#setRemoveCategoryEdit"><b>setRemoveCategoryEdit</b></a> ( bool remove )</div></li><li><div class=fn>void <a href="#setAllCategories"><b>setAllCategories</b></a> ( bool all )</div></li><li><div class=fn>void <b>setCurrentCategory</b> ( int newCatUid )</div></li><li><div class=fn>int <a href="#currentCategory"><b>currentCategory</b></a> () const</div></li><li><div class=fn>const QArray<int> & <a href="#currentCategories"><b>currentCategories</b></a> () const</div></li><li><div class=fn>QString <a href="#setCategories-2"><b>setCategories</b></a> ( const QArray<int> & cats, const QString & appName )</div></li><li><div class=fn>QString <a href="#setCategories"><b>setCategories</b></a> ( const QArray<int> & cals, const QString & appName, const QString & visibleName )</div></li><li><div class=fn>void <a href="#setFixedWidth"><b>setFixedWidth</b></a> ( int width )</div></li></ul><h2>Public Slots</h2><ul><li><div class=fn>void <a href="#slotNewCat"><b>slotNewCat</b></a> ( int newUid )</div></li></ul><h2>Signals</h2><ul><li><div class=fn>void <b>signalSelected</b> ( int )</div></li><li><div class=fn>void <a href="#editCategoriesClicked"><b>editCategoriesClicked</b></a> ()</div></li></ul><hr><a name="details"></a><h2>Detailed Description</h2>The CategorySelect widget allows users to select <a href="categories.html">Categories</a> with acombobox interface.<p> CategorySelect is useful to provide a QComboBox of Categories forfiltering (such as in the Contacts table view) or to allow the userto select multiple Categories. The allCategories variable setswhether the CategorySelect is in filtering or selecting mode.<p> In filtering mode, the All and Unfiled categories are added. The<p> In selecting mode, the CategorySelect may either be a QComboBox anda QToolButton or a QListView with checkable items depending on thescreen size.<p> CategorySelect automatically updates itself if Categories has beenchanged elsewhere in the environment.<p> Signals and slots are provided to notify the application of the usersselections. A QToolButton is also provided so that users can edit theCategories manually.<p> <p>See also <a href="qtopiaemb.html">Qtopia Classes</a>.<hr><h2>Member Type Documentation</h2><h3 class=fn><a name="SelectorWidget-enum"></a>CategorySelect::SelectorWidget</h3> Chooses a type of widget to use as the selection widget.<ul><li><tt>CategorySelect::ComboBox</tt><li><tt>CategorySelect::ListView</tt></ul><hr><h2>Member Function Documentation</h2><h3 class=fn><a name="CategorySelect"></a>CategorySelect::CategorySelect ( QWidget * parent = 0, const char * name = 0, int width = 0 )</h3>Constructs a category selector with parent <em>parent</em>, name <em>name</em> andfixed width <em>width</em>.<p> This constructor is provided to make integration with Qt Designer easier.<h3 class=fn><a name="CategorySelect-2"></a>CategorySelect::CategorySelect ( const QArray<int> & vl, const QString & appName, QWidget * parent = 0, const char * name = 0, int width = 0 )</h3>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.<p> This constructor accepts an array <em>vl</em> of integers representing <a href="categories.html">Categories</a>.<em>appName</em> is used as the visible name string.<em>width</em> is an integer used as the fixed width of the widget.The <em>parent</em> and <em>name</em> parameters are the standard Qt parent parameters.<h3 class=fn><a name="CategorySelect-3"></a>CategorySelect::CategorySelect ( const QArray<int> & vl, const QString & appName, const QString & visibleName, QWidget * parent = 0, const char * name = 0, int width = 0 )</h3>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.<p> This constructor accepts an array <em>vl</em> of integers representing <a href="categories.html">Categories</a>for application <em>appName</em>.<em>visibleName</em> is the string used when the name of this application is requiredto be displayed.<em>width</em> is an integer used as the fixed width of the widget.The <em>parent</em> and <em>name</em> parameters are the standard Qt parent parameters.<h3 class=fn><a name="CategorySelect-4"></a>CategorySelect::CategorySelect ( const QArray<int> & vlCats, const QString & appName, const QString & visibleName, bool allCategories, QWidget * parent = 0, const char * name = 0, int width = 0 )</h3>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.<p> This constructor accepts an array <em>vlCats</em> of integers representing<a href="categories.html">Categories</a>. <em>appName</em> is the application Categories name to filter on.<em>visibleName</em> is the string used when the name of thiswidget is required to be displayed. <em>allCategories</em> sets whetherthe selector offers "All" and "Unfiled" as options. If set to FALSE,then the CategorySelect allows the user to select multiple categories. Ifset to TRUE, the CategorySelect allows for only a single category selection.<em>width</em> is an integer used as the fixed width of the widget.The <em>parent</em> and <em>name</em> parameters are the standard Qt parent parameters.<p> First availability: Qtopia 1.6<h3 class=fn><a name="~CategorySelect"></a>CategorySelect::~CategorySelect ()</h3>Destructs a CategorySelect widget.<h3 class=fn>bool <a name="containsCategory"></a>CategorySelect::containsCategory ( const QArray<int> & cats )</h3>Returns TRUE if the current category contains any categories in <em>cats</em>.<p> First availability: Qtopia 1.6<h3 class=fn>const QArray<int> & <a name="currentCategories"></a>CategorySelect::currentCategories () const</h3>Returns a shallow copy of the categories in this CategorySelect.<h3 class=fn>int <a name="currentCategory"></a>CategorySelect::currentCategory () const</h3>Return the value of the currently selected category.<h3 class=fn>void <a name="editCategoriesClicked"></a>CategorySelect::editCategoriesClicked ()<tt> [signal]</tt></h3><p> This signal is emitted when the user wishes to edit thecategories, just prior to showing the dialog allowing that.<p> <p>See also CategoryEdit.<p> First availability: Qtopia 1.6<h3 class=fn>void <a name="setAllCategories"></a>CategorySelect::setAllCategories ( bool all )</h3>Changes this CategorySelect to the All category if <em>all</em> is TRUE.<h3 class=fn>QString <a name="setCategories"></a>CategorySelect::setCategories ( const QArray<int> & cals, const QString & appName, const QString & visibleName )</h3>Resets the CategorySelect to select the <em>cals</em> forthe <a href="categories.html">Categories</a> assoicated with <em>appName</em> and displaysthe <em>visibleName</em> if the user is selecting and therefore editingnew Categories.<h3 class=fn>QString <a name="setCategories-2"></a>CategorySelect::setCategories ( const QArray<int> & cats, const QString & appName )</h3>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.<p> Resets the CategorySelect to select <em>cats</em> asthe <a href="categories.html">Categories</a> associated with <em>appName</em>.<p> This function should only be called if <i>filtering</i>on Categories and not selecting and therefore possiblyallowing the user to edit Categories.<h3 class=fn>void <a name="setFixedWidth"></a>CategorySelect::setFixedWidth ( int width )</h3>Sets the fixed width of the widget to <em>width</em>.<h3 class=fn>void <a name="setRemoveCategoryEdit"></a>CategorySelect::setRemoveCategoryEdit ( bool remove )</h3>Hides the edit section of the CategorySelect widget if <em>remove</em> is TRUE.<h3 class=fn>void <a name="slotNewCat"></a>CategorySelect::slotNewCat ( int newUid )<tt> [slot]</tt></h3>This slot is called when a new Category is available,passing the <em>newUid</em> created.<h3 class=fn><a href="categoryselect.html#SelectorWidget-enum">SelectorWidget</a> <a name="widgetType"></a>CategorySelect::widgetType () const</h3>Returns the type of widget as a CategorySelect::SelectorWidget.<p> First availability: Qtopia 1.6<!-- eof --><hr><p>This file is part of the <a href="../index.html">Qtopia</a> platform,copyright © 1995-2004<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 © 2001-2004 Trolltech<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a><td align="right"><div align="right">Qtopia version 2.0.0</div></table></div></address></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -