diff options
Diffstat (limited to 'doc/html/propertydocs')
| -rw-r--r-- | doc/html/propertydocs | 5312 |
1 files changed, 5312 insertions, 0 deletions
diff --git a/doc/html/propertydocs b/doc/html/propertydocs new file mode 100644 index 0000000..5c255c3 --- /dev/null +++ b/doc/html/propertydocs @@ -0,0 +1,5312 @@ +<!DOCTYPE PROP><PROP> +<property> + <name>QAction::accel</name> + <doc href="qaction.html#accel-prop"> +<p>This property holds the action's accelerator key. +<p>The keycodes can be found in <a href="qt.html#Key-enum">Qt::Key</a> and <a href="qt.html#Modifier-enum">Qt::Modifier</a>. There +is no default accelerator key. + +<p>Set this property's value with <a href="qaction.html#setAccel">setAccel</a>() and get this property's value with <a href="qaction.html#accel">accel</a>(). +</doc> +</property> +<property> + <name>QAction::enabled</name> + <doc href="qaction.html#enabled-prop"> +<p>This property holds whether the action is enabled. +<p>Disabled actions can't be chosen by the user. They don't disappear +from the menu/tool bar but are displayed in a way which indicates +that they are unavailable, e.g. they might be displayed grayed +out. +<p> What's this? help on disabled actions is still available provided +the <a href="qaction.html#whatsThis-prop">QAction::whatsThis</a> property is set. + +<p>Set this property's value with <a href="qaction.html#setEnabled">setEnabled</a>() and get this property's value with <a href="qaction.html#isEnabled">isEnabled</a>(). +</doc> +</property> +<property> + <name>QAction::iconSet</name> + <doc href="qaction.html#iconSet-prop"> +<p>This property holds the action's icon. +<p>The icon is used as the tool button icon and in the menu to the +left of the menu text. There is no default icon. +<p> If a null icon (<a href="qiconset.html#isNull">QIconSet::isNull</a>() is passed into this function, +the icon of the action is cleared. +<p> (See the action/toggleaction/toggleaction.cpp example.) +<p> +<p>Set this property's value with <a href="qaction.html#setIconSet">setIconSet</a>() and get this property's value with <a href="qaction.html#iconSet">iconSet</a>(). +</doc> +</property> +<property> + <name>QAction::menuText</name> + <doc href="qaction.html#menuText-prop"> +<p>This property holds the action's menu text. +<p>If the action is added to a menu the menu option will consist of +the icon (if there is one), the menu text and the accelerator (if +there is one). If the menu text is not explicitly set in the +constructor or by using <a href="qaction.html#setMenuText">setMenuText</a>() the action's description +text will be used as the menu text. There is no default menu text. +<p> <p>See also <a href="qaction.html#text-prop">text</a>. + +<p>Set this property's value with <a href="qaction.html#setMenuText">setMenuText</a>() and get this property's value with <a href="qaction.html#menuText">menuText</a>(). +</doc> +</property> +<property> + <name>QAction::on</name> + <doc href="qaction.html#on-prop"> +<p>This property holds whether a toggle action is on. +<p>This property is always on (TRUE) for command actions and +<a href="qactiongroup.html">QActionGroup</a>s; <a href="qaction.html#setOn">setOn</a>() has no effect on them. For action's +where <a href="qaction.html#isToggleAction">isToggleAction</a>() is TRUE, this property's default value is +off (FALSE). +<p> <p>See also <a href="qaction.html#toggleAction-prop">toggleAction</a>. + +<p>Set this property's value with <a href="qaction.html#setOn">setOn</a>() and get this property's value with <a href="qaction.html#isOn">isOn</a>(). +</doc> +</property> +<property> + <name>QAction::statusTip</name> + <doc href="qaction.html#statusTip-prop"> +<p>This property holds the action's status tip. +<p>The statusTip is displayed on all status bars that this action's +toplevel parent widget provides. +<p> If no status tip is defined, the action uses the tool tip text. +<p> There is no default statusTip text. +<p> <p>See also <a href="qaction.html#statusTip-prop">statusTip</a> and <a href="qaction.html#toolTip-prop">toolTip</a>. + +<p>Set this property's value with <a href="qaction.html#setStatusTip">setStatusTip</a>() and get this property's value with <a href="qaction.html#statusTip">statusTip</a>(). +</doc> +</property> +<property> + <name>QAction::text</name> + <doc href="qaction.html#text-prop"> +<p>This property holds the action's descriptive text. +<p>If <a href="qmainwindow.html#usesTextLabel-prop">QMainWindow::usesTextLabel</a> is TRUE, the text appears as a +label in the relevant tool button. It also serves as the default +text in menus and tool tips if these have not been specifically +defined. There is no default text. +<p> <p>See also <a href="qaction.html#menuText-prop">menuText</a>, <a href="qaction.html#toolTip-prop">toolTip</a>, and <a href="qaction.html#statusTip-prop">statusTip</a>. + +<p>Set this property's value with <a href="qaction.html#setText">setText</a>() and get this property's value with <a href="qaction.html#text">text</a>(). +</doc> +</property> +<property> + <name>QAction::toggleAction</name> + <doc href="qaction.html#toggleAction-prop"> +<p>This property holds whether the action is a toggle action. +<p>A toggle action is one which has an on/off state. For example a +Bold toolbar button is either on or off. An action which is not a +toggle action is a command action; a command action is simply +executed, e.g. file save. This property's default is FALSE. +<p> In some situations, the state of one toggle action should depend +on the state of others. For example, "Left Align", "Center" and +"Right Align" toggle actions are mutually exclusive. To achieve +exclusive toggling, add the relevant toggle actions to a +<a href="qactiongroup.html">QActionGroup</a> with the <a href="qactiongroup.html#exclusive-prop">QActionGroup::exclusive</a> property set to +TRUE. + +<p>Set this property's value with <a href="qaction.html#setToggleAction">setToggleAction</a>() and get this property's value with <a href="qaction.html#isToggleAction">isToggleAction</a>(). +</doc> +</property> +<property> + <name>QAction::toolTip</name> + <doc href="qaction.html#toolTip-prop"> +<p>This property holds the action's tool tip. +<p>This text is used for the tool tip. If no status tip has been set +the tool tip will be used for the status tip. +<p> If no tool tip is specified the action's text is used, and if that +hasn't been specified the description text is used as the tool tip +text. +<p> There is no default tool tip text. +<p> <p>See also <a href="qaction.html#statusTip-prop">statusTip</a> and <a href="qaction.html#accel-prop">accel</a>. + +<p>Set this property's value with <a href="qaction.html#setToolTip">setToolTip</a>() and get this property's value with <a href="qaction.html#toolTip">toolTip</a>(). +</doc> +</property> +<property> + <name>QAction::visible</name> + <doc href="qaction.html#visible-prop"> +<p>This property holds whether the action can be seen (e.g. in menus and toolbars). +<p>If <em>visible</em> is TRUE the action can be seen (e.g. in menus and +toolbars) and chosen by the user; if <em>visible</em> is FALSE the +action cannot be seen or chosen by the user. +<p> Actions which are not visible are <em>not</em> grayed out; they do not +appear at all. + +<p>Set this property's value with <a href="qaction.html#setVisible">setVisible</a>() and get this property's value with <a href="qaction.html#isVisible">isVisible</a>(). +</doc> +</property> +<property> + <name>QAction::whatsThis</name> + <doc href="qaction.html#whatsThis-prop"> +<p>This property holds the action's "What's This?" help text. +<p>The whats this text is used to provide a brief description of the +action. The text may contain rich text (HTML-like tags -- see +<a href="qstylesheet.html">QStyleSheet</a> for the list of supported tags). There is no default +"What's This" text. +<p> <p>See also <a href="qwhatsthis.html">QWhatsThis</a>. + +<p>Set this property's value with <a href="qaction.html#setWhatsThis">setWhatsThis</a>() and get this property's value with <a href="qaction.html#whatsThis">whatsThis</a>(). +</doc> +</property> +<property> + <name>QActionGroup::exclusive</name> + <doc href="qactiongroup.html#exclusive-prop"> +<p>This property holds whether the action group does exclusive toggling. +<p>If exclusive is TRUE only one toggle action in the action group +can ever be active at any one time. If the user chooses another +toggle action in the group the one they chose becomes active and +the one that was active becomes inactive. +<p> <p>See also <a href="qaction.html#toggleAction-prop">QAction::toggleAction</a>. + +<p>Set this property's value with <a href="qactiongroup.html#setExclusive">setExclusive</a>() and get this property's value with <a href="qactiongroup.html#isExclusive">isExclusive</a>(). +</doc> +</property> +<property> + <name>QActionGroup::usesDropDown</name> + <doc href="qactiongroup.html#usesDropDown-prop"> +<p>This property holds whether the group's actions are displayed in a subwidget of the widgets the action group is added to. +<p>Exclusive action groups added to a toolbar display their actions +in a combobox with the action's <a href="qaction.html#text-prop">QAction::text</a> and <a href="qaction.html#iconSet-prop">QAction::iconSet</a> properties shown. Non-exclusive groups are +represented by a tool button showing their <a href="qaction.html#iconSet-prop">QAction::iconSet</a> and +-- depending on <a href="qmainwindow.html#usesTextLabel">QMainWindow::usesTextLabel</a>() -- <a href="qaction.html#text">text</a>() +property. +<p> In a popup menu the member actions are displayed in a submenu. +<p> Changing usesDropDown only affects <em>subsequent</em> calls to <a href="qactiongroup.html#addTo">addTo</a>(). +<p> Note that setting this property for actions in a combobox causes +calls to their <a href="qaction.html#setVisible">QAction::setVisible</a>(), +<a href="qaction.html#setEnabled">QAction::setEnabled</a>(), and +<a href="qaction.html#setDisabled">QAction::setDisabled</a>() functions to have no effect. +<p> This property's default is FALSE. +<p> +<p>Set this property's value with <a href="qactiongroup.html#setUsesDropDown">setUsesDropDown</a>() and get this property's value with <a href="qactiongroup.html#usesDropDown">usesDropDown</a>(). +</doc> +</property> +<property> + <name>QAssistantClient::open</name> + <doc href="qassistantclient.html#open-prop"> +<p>This property holds whether Qt Assistant is open. +<p> +<p>Get this property's value with <a href="qassistantclient.html#isOpen">isOpen</a>(). +</doc> +</property> +<property> + <name>QAxBase::control</name> + <doc href="qaxbase.html#control-prop"> +<p>This property holds the name of the COM object wrapped by this QAxBase object. +<p>Setting this property initilializes the COM object. Any COM object +previously set is shut down. +<p> The most efficient way to set this property is by using the +registered component's UUID, e.g. +<pre> + ctrl-&gt;setControl( "{8E27C92B-1264-101C-8A2F-040224009C02}" ); + </pre> + +The second fastest way is to use the registered control's class +name (with or without version number), e.g. +<pre> + ctrl-&gt;setControl( "MSCal.Calendar" ); + </pre> + +The slowest, but easiest way to use is to use the control's full +name, e.g. +<pre> + ctrl-&gt;setControl( "Calendar Control 9.0" ); + </pre> + +<p> If the component's UUID is used the following patterns can be used +to initialize the control on a remote machine, to initialize a +licensed control or to connect to a running object: +<ul> +<li> To initialize the control on a different machine use the following +pattern: +<pre> + &lt;domain/username&gt;:&lt;password&gt;@server/{8E27C92B-1264-101C-8A2F-040224009C02} + </pre> + +<li> To initialize a licensed control use the following pattern: +<pre> + {8E27C92B-1264-101C-8A2F-040224009C02}:&lt;LicenseKey&gt; + </pre> + +<li> To connect to an already running object use the following pattern: +<pre> + {8E27C92B-1264-101C-8A2F-040224009C02}&amp; + </pre> + +</ul> +The first two patterns can be combined, e.g. to initialize a licensed +control on a remote machine: +<pre> + ctrl-&gt;setControl("DOMAIN/user:password@server/{8E27C92B-1264-101C-8A2F-040224009C02}:LicenseKey"); + </pre> + +<p> The control's read function always returns the control's UUID, if provided including the license +key, and the name of the server, but not including the username, the domain or the password. + +<p>Set this property's value with <a href="qaxbase.html#setControl">setControl</a>() and get this property's value with <a href="qaxbase.html#control">control</a>(). +</doc> +</property> +<property> + <name>QButton::accel</name> + <doc href="qbutton.html#accel-prop"> +<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="qbutton.html#setAccel">setAccel</a>() and get this property's value with <a href="qbutton.html#accel">accel</a>(). +</doc> +</property> +<property> + <name>QButton::autoRepeat</name> + <doc href="qbutton.html#autoRepeat-prop"> +<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="qbutton.html#setAutoRepeat">setAutoRepeat</a>() and get this property's value with <a href="qbutton.html#autoRepeat">autoRepeat</a>(). +</doc> +</property> +<property> + <name>QButton::autoResize</name> + <doc href="qbutton.html#autoResize-prop"> <p>This property holds whether autoResize is enabled. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> If autoResize is enabled then the button will resize itself +whenever the contents are changed. + +<p>Set this property's value with <a href="qbutton.html#setAutoResize">setAutoResize</a>() and get this property's value with <a href="qbutton.html#autoResize">autoResize</a>(). +</doc> +</property> +<property> + <name>QButton::down</name> + <doc href="qbutton.html#down-prop"> +<p>This property holds whether the button is pressed. +<p>If this property is TRUE, the button is pressed down. The signals +<a href="qbutton.html#pressed">pressed</a>() and <a href="qbutton.html#clicked">clicked</a>() are not emitted if you set this property +to TRUE. The default is FALSE. + +<p>Set this property's value with <a href="qbutton.html#setDown">setDown</a>() and get this property's value with <a href="qbutton.html#isDown">isDown</a>(). +</doc> +</property> +<property> + <name>QButton::exclusiveToggle</name> + <doc href="qbutton.html#exclusiveToggle-prop"> +<p>This property holds whether the button is an exclusive toggle. +<p>If this property is TRUE and the button is in a <a href="qbuttongroup.html">QButtonGroup</a>, the +button can only be toggled off by another one being toggled on. +The default is FALSE. + +<p>Get this property's value with <a href="qbutton.html#isExclusiveToggle">isExclusiveToggle</a>(). +</doc> +</property> +<property> + <name>QButton::on</name> + <doc href="qbutton.html#on-prop"> +<p>This property holds whether the button is toggled. +<p>This property should only be set for toggle buttons. + +<p>Get this property's value with <a href="qbutton.html#isOn">isOn</a>(). +</doc> +</property> +<property> + <name>QButton::pixmap</name> + <doc href="qbutton.html#pixmap-prop"> +<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="qbutton.html#setPixmap">setPixmap</a>() and get this property's value with <a href="qbutton.html#pixmap">pixmap</a>(). +</doc> +</property> +<property> + <name>QButton::text</name> + <doc href="qbutton.html#text-prop"> +<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 (&amp;) in it, then an +accelerator is automatically created for it using the character +that follows the '&amp;' 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="qbutton.html#setText">setText</a>() and get this property's value with <a href="qbutton.html#text">text</a>(). +</doc> +</property> +<property> + <name>QButton::toggleButton</name> + <doc href="qbutton.html#toggleButton-prop"> +<p>This property holds whether the button is a toggle button. +<p>The default value is FALSE. + +<p>Get this property's value with <a href="qbutton.html#isToggleButton">isToggleButton</a>(). +</doc> +</property> +<property> + <name>QButton::toggleState</name> + <doc href="qbutton.html#toggleState-prop"> +<p>This property holds the state of the toggle button. +<p>If this property is changed then it does not cause the button +to be repainted. + +<p>Get this property's value with <a href="qbutton.html#state">state</a>(). +</doc> +</property> +<property> + <name>QButton::toggleType</name> + <doc href="qbutton.html#toggleType-prop"> +<p>This property holds the type of toggle on the button. +<p>The default toggle type is <a href="qbutton.html#ToggleType-enum">SingleShot</a>. +<p> <p>See also <a href="qbutton.html#ToggleType-enum">QButton::ToggleType</a>. + +<p>Get this property's value with <a href="qbutton.html#toggleType">toggleType</a>(). +</doc> +</property> +<property> + <name>QButtonGroup::exclusive</name> + <doc href="qbuttongroup.html#exclusive-prop"> +<p>This property holds whether the button group is exclusive. +<p>If this property is TRUE, then the buttons in the group are +toggled, and to untoggle a button you must click on another button +in the group. The default value is FALSE. + +<p>Set this property's value with <a href="qbuttongroup.html#setExclusive">setExclusive</a>() and get this property's value with <a href="qbuttongroup.html#isExclusive">isExclusive</a>(). +</doc> +</property> +<property> + <name>QButtonGroup::radioButtonExclusive</name> + <doc href="qbuttongroup.html#radioButtonExclusive-prop"> +<p>This property holds whether the radio buttons in the group are exclusive. +<p>If this property is TRUE (the default), the <a href="qradiobutton.html">radiobuttons</a> in the group are treated exclusively. + +<p>Set this property's value with <a href="qbuttongroup.html#setRadioButtonExclusive">setRadioButtonExclusive</a>() and get this property's value with <a href="qbuttongroup.html#isRadioButtonExclusive">isRadioButtonExclusive</a>(). +</doc> +</property> +<property> + <name>QButtonGroup::selectedId</name> + <doc href="qbuttongroup.html#selectedId-prop"> +<p>This property holds the selected toggle button. +<p>The toggle button is specified as an ID. +<p> If no toggle button is selected, this property holds -1. +<p> If <a href="qbuttongroup.html#setButton">setButton</a>() is called on an exclusive group, the button with +the given id will be set to on and all the others will be set to +off. +<p> <p>See also <a href="qbuttongroup.html#selected">selected</a>(). + +<p>Set this property's value with <a href="qbuttongroup.html#setButton">setButton</a>() and get this property's value with <a href="qbuttongroup.html#selectedId">selectedId</a>(). +</doc> +</property> +<property> + <name>QCheckBox::checked</name> + <doc href="qcheckbox.html#checked-prop"> +<p>This property holds whether the checkbox is checked. +<p>The default is unchecked, i.e. FALSE. + +<p>Set this property's value with <a href="qcheckbox.html#setChecked">setChecked</a>() and get this property's value with <a href="qcheckbox.html#isChecked">isChecked</a>(). +</doc> +</property> +<property> + <name>QCheckBox::tristate</name> + <doc href="qcheckbox.html#tristate-prop"> +<p>This property holds whether the checkbox is a tri-state checkbox. +<p>The default is two-state, i.e. tri-state is FALSE. + +<p>Set this property's value with <a href="qcheckbox.html#setTristate">setTristate</a>() and get this property's value with <a href="qcheckbox.html#isTristate">isTristate</a>(). +</doc> +</property> +<property> + <name>QComboBox::autoCompletion</name> + <doc href="qcombobox.html#autoCompletion-prop"> +<p>This property holds whether auto-completion is enabled. +<p>This property can only be set for editable comboboxes, for +non-editable comboboxes it has no effect. It is FALSE by default. + +<p>Set this property's value with <a href="qcombobox.html#setAutoCompletion">setAutoCompletion</a>() and get this property's value with <a href="qcombobox.html#autoCompletion">autoCompletion</a>(). +</doc> +</property> +<property> + <name>QComboBox::autoResize</name> + <doc href="qcombobox.html#autoResize-prop"> <p>This property holds whether auto resize is enabled. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> If this property is set to TRUE then the combobox will resize itself +whenever its contents change. The default is FALSE. + +<p>Set this property's value with <a href="qcombobox.html#setAutoResize">setAutoResize</a>() and get this property's value with <a href="qcombobox.html#autoResize">autoResize</a>(). +</doc> +</property> +<property> + <name>QComboBox::count</name> + <doc href="qcombobox.html#count-prop"> +<p>This property holds the number of items in the combobox. +<p> +<p>Get this property's value with <a href="qcombobox.html#count">count</a>(). +</doc> +</property> +<property> + <name>QComboBox::currentItem</name> + <doc href="qcombobox.html#currentItem-prop"> +<p>This property holds the index of the current item in the combobox. +<p>Note that the <a href="qcombobox.html#activated">activated</a>() and <a href="qcombobox.html#highlighted">highlighted</a>() signals are only +emitted when the user changes the current item, not when it is +changed programmatically. + +<p>Set this property's value with <a href="qcombobox.html#setCurrentItem">setCurrentItem</a>() and get this property's value with <a href="qcombobox.html#currentItem">currentItem</a>(). +</doc> +</property> +<property> + <name>QComboBox::currentText</name> + <doc href="qcombobox.html#currentText-prop"> +<p>This property holds the text of the combobox's current item. +<p> +<p>Set this property's value with <a href="qcombobox.html#setCurrentText">setCurrentText</a>() and get this property's value with <a href="qcombobox.html#currentText">currentText</a>(). +</doc> +</property> +<property> + <name>QComboBox::duplicatesEnabled</name> + <doc href="qcombobox.html#duplicatesEnabled-prop"> +<p>This property holds whether duplicates are allowed. +<p>If the combobox is editable and the user enters some text in the +combobox's lineedit and presses Enter (and the <a href="qcombobox.html#insertionPolicy">insertionPolicy</a>() +is not <a href="qcombobox.html#Policy-enum">NoInsertion</a>), then what happens is this: +<ul> +<li> If the text is not already in the list, the text is inserted. +<li> If the text is in the list and this property is TRUE (the +default), the text is inserted. +<li> If the text is in the list and this property is FALSE, the text +is <em>not</em> inserted; instead the item which has matching text becomes +the current item. +</ul> +<p> This property only affects user-interaction. You can use +<a href="qcombobox.html#insertItem">insertItem</a>() to insert duplicates if you wish regardless of this +setting. + +<p>Set this property's value with <a href="qcombobox.html#setDuplicatesEnabled">setDuplicatesEnabled</a>() and get this property's value with <a href="qcombobox.html#duplicatesEnabled">duplicatesEnabled</a>(). +</doc> +</property> +<property> + <name>QComboBox::editable</name> + <doc href="qcombobox.html#editable-prop"> +<p>This property holds whether the combobox is editable. +<p>This property's default is FALSE. Note that the combobox will be +cleared if this property is set to TRUE for a 1.x <a href="motif-extension.html#Motif">Motif</a> style +combobox. To avoid this, use <a href="qcombobox.html#setEditable">setEditable</a>() before inserting any +items. Also note that the 1.x version of Motif didn't have any +editable comboboxes, so the combobox will change it's appearance +to a 2.0 style Motif combobox is it is set to be editable. + +<p>Set this property's value with <a href="qcombobox.html#setEditable">setEditable</a>() and get this property's value with <a href="qcombobox.html#editable">editable</a>(). +</doc> +</property> +<property> + <name>QComboBox::insertionPolicy</name> + <doc href="qcombobox.html#insertionPolicy-prop"> +<p>This property holds the position of the items inserted by the user. +<p>The default insertion policy is <a href="qcombobox.html#Policy-enum">AtBottom</a>. See <a href="qcombobox.html#Policy-enum">Policy</a>. + +<p>Set this property's value with <a href="qcombobox.html#setInsertionPolicy">setInsertionPolicy</a>() and get this property's value with <a href="qcombobox.html#insertionPolicy">insertionPolicy</a>(). +</doc> +</property> +<property> + <name>QComboBox::maxCount</name> + <doc href="qcombobox.html#maxCount-prop"> +<p>This property holds the maximum number of items allowed in the combobox. +<p> +<p>Set this property's value with <a href="qcombobox.html#setMaxCount">setMaxCount</a>() and get this property's value with <a href="qcombobox.html#maxCount">maxCount</a>(). +</doc> +</property> +<property> + <name>QComboBox::sizeLimit</name> + <doc href="qcombobox.html#sizeLimit-prop"> +<p>This property holds the maximum on-screen size of the combobox. +<p>This property is ignored for both <a href="motif-extension.html#Motif">Motif</a> 1.x style and non-editable +comboboxes in Mac style. The default limit is ten +lines. If the number of items in the combobox is or grows larger +than lines, a scrollbar is added. + +<p>Set this property's value with <a href="qcombobox.html#setSizeLimit">setSizeLimit</a>() and get this property's value with <a href="qcombobox.html#sizeLimit">sizeLimit</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::autoEdit</name> + <doc href="qdatabrowser.html#autoEdit-prop"> +<p>This property holds whether the browser automatically applies edits. +<p>The default value for this property is TRUE. When the user begins +an insertion or an update on a form there are two possible +outcomes when they navigate to another record: +<p> <ul> +<li> the insert or update is is performed -- this occurs if autoEdit is TRUE +<li> the insert or update is discarded -- this occurs if autoEdit is FALSE +</ul> + +<p>Set this property's value with <a href="qdatabrowser.html#setAutoEdit">setAutoEdit</a>() and get this property's value with <a href="qdatabrowser.html#autoEdit">autoEdit</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::boundaryChecking</name> + <doc href="qdatabrowser.html#boundaryChecking-prop"> +<p>This property holds whether boundary checking is active. +<p>When boundary checking is active (the default), signals are +emitted indicating the current position of the default cursor. +<p> <p>See also <a href="qdatabrowser.html#boundary">boundary</a>(). + +<p>Set this property's value with <a href="qdatabrowser.html#setBoundaryChecking">setBoundaryChecking</a>() and get this property's value with <a href="qdatabrowser.html#boundaryChecking">boundaryChecking</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::confirmCancels</name> + <doc href="qdatabrowser.html#confirmCancels-prop"> +<p>This property holds whether the browser confirms cancel operations. +<p>If this property is TRUE, all cancels must be confirmed by the +user through a message box (this behavior can be changed by +overriding the <a href="qdatabrowser.html#confirmCancel">confirmCancel</a>() function), otherwise all cancels +occur immediately. The default is FALSE. +<p> <p>See also <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a> and <a href="qdatabrowser.html#confirmCancel">confirmCancel</a>(). + +<p>Set this property's value with <a href="qdatabrowser.html#setConfirmCancels">setConfirmCancels</a>() and get this property's value with <a href="qdatabrowser.html#confirmCancels">confirmCancels</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::confirmDelete</name> + <doc href="qdatabrowser.html#confirmDelete-prop"> +<p>This property holds whether the browser confirms deletions. +<p>If this property is TRUE, the browser confirms deletions, +otherwise deletions happen immediately. +<p> <p>See also <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatabrowser.html#confirmUpdate-prop">confirmUpdate</a>, <a href="qdatabrowser.html#confirmInsert-prop">confirmInsert</a>, and <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>(). + +<p>Set this property's value with <a href="qdatabrowser.html#setConfirmDelete">setConfirmDelete</a>() and get this property's value with <a href="qdatabrowser.html#confirmDelete">confirmDelete</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::confirmEdits</name> + <doc href="qdatabrowser.html#confirmEdits-prop"> +<p>This property holds whether the browser confirms edits. +<p>If this property is TRUE, the browser confirms all edit operations +(insertions, updates and deletions), otherwise all edit operations +happen immediately. Confirmation is achieved by presenting the +user with a message box -- this behavior can be changed by +reimplementing the <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>() function, +<p> <p>See also <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>(), <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmInsert-prop">confirmInsert</a>, <a href="qdatabrowser.html#confirmUpdate-prop">confirmUpdate</a>, and <a href="qdatabrowser.html#confirmDelete-prop">confirmDelete</a>. + +<p>Set this property's value with <a href="qdatabrowser.html#setConfirmEdits">setConfirmEdits</a>() and get this property's value with <a href="qdatabrowser.html#confirmEdits">confirmEdits</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::confirmInsert</name> + <doc href="qdatabrowser.html#confirmInsert-prop"> +<p>This property holds whether the data browser confirms insertions. +<p>If this property is TRUE, the browser confirms insertions, +otherwise insertions happen immediately. +<p> <p>See also <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatabrowser.html#confirmUpdate-prop">confirmUpdate</a>, <a href="qdatabrowser.html#confirmDelete-prop">confirmDelete</a>, and <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>(). + +<p>Set this property's value with <a href="qdatabrowser.html#setConfirmInsert">setConfirmInsert</a>() and get this property's value with <a href="qdatabrowser.html#confirmInsert">confirmInsert</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::confirmUpdate</name> + <doc href="qdatabrowser.html#confirmUpdate-prop"> +<p>This property holds whether the browser confirms updates. +<p>If this property is TRUE, the browser confirms updates, otherwise +updates happen immediately. +<p> <p>See also <a href="qdatabrowser.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatabrowser.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatabrowser.html#confirmInsert-prop">confirmInsert</a>, <a href="qdatabrowser.html#confirmDelete-prop">confirmDelete</a>, and <a href="qdatabrowser.html#confirmEdit">confirmEdit</a>(). + +<p>Set this property's value with <a href="qdatabrowser.html#setConfirmUpdate">setConfirmUpdate</a>() and get this property's value with <a href="qdatabrowser.html#confirmUpdate">confirmUpdate</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::filter</name> + <doc href="qdatabrowser.html#filter-prop"> +<p>This property holds the data browser's filter. +<p>The filter applies to the data shown in the browser. Call +<a href="qdatabrowser.html#refresh">refresh</a>() to apply the new filter. A filter is a string containing +a SQL WHERE clause without the WHERE keyword, e.g. "id>1000", +"name LIKE 'A%'", etc. +<p> There is no default filter. +<p> <p>See also <a href="qdatabrowser.html#sort-prop">sort</a>. + +<p>Set this property's value with <a href="qdatabrowser.html#setFilter">setFilter</a>() and get this property's value with <a href="qdatabrowser.html#filter">filter</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::readOnly</name> + <doc href="qdatabrowser.html#readOnly-prop"> +<p>This property holds whether the browser is read-only. +<p>The default is FALSE, i.e. data can be edited. If the data browser +is read-only, no database edits will be allowed. + +<p>Set this property's value with <a href="qdatabrowser.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qdatabrowser.html#isReadOnly">isReadOnly</a>(). +</doc> +</property> +<property> + <name>QDataBrowser::sort</name> + <doc href="qdatabrowser.html#sort-prop"> +<p>This property holds the data browser's sort. +<p>The data browser's sort affects the order in which records are +viewed in the browser. Call <a href="qdatabrowser.html#refresh">refresh</a>() to apply the new sort. +<p> When retrieving the sort property, a string list is returned in +the form 'fieldname order', e.g. 'id ASC', 'surname DESC'. +<p> There is no default sort. +<p> Note that if you want to iterate over the list, you should iterate +over a copy, e.g. +<pre> + <a href="qstringlist.html">QStringList</a> list = myDataBrowser.sort(); + QStringList::Iterator it = list.<a href="qvaluelist.html#begin">begin</a>(); + while( it != list.<a href="qvaluelist.html#end">end</a>() ) { + myProcessing( *it ); + ++it; + } + </pre> + + +<p>Set this property's value with <a href="qdatabrowser.html#setSort">setSort</a>() and get this property's value with <a href="qdatabrowser.html#sort">sort</a>(). +</doc> +</property> +<property> + <name>QDataTable::autoEdit</name> + <doc href="qdatatable.html#autoEdit-prop"> +<p>This property holds whether the data table automatically applies edits. +<p>The default value for this property is TRUE. When the user begins +an insert or update in the table there are two possible outcomes +when they navigate to another record: +<p> <ol type=1> +<li> the insert or update is is performed -- this occurs if autoEdit is TRUE +<li> the insert or update is abandoned -- this occurs if autoEdit is FALSE +</ol> + +<p>Set this property's value with <a href="qdatatable.html#setAutoEdit">setAutoEdit</a>() and get this property's value with <a href="qdatatable.html#autoEdit">autoEdit</a>(). +</doc> +</property> +<property> + <name>QDataTable::confirmCancels</name> + <doc href="qdatatable.html#confirmCancels-prop"> +<p>This property holds whether the data table confirms cancel operations. +<p>If the confirmCancel property is TRUE, all cancels must be +confirmed by the user through a message box (this behavior can be +changed by overriding the <a href="qdatatable.html#confirmCancel">confirmCancel</a>() function), otherwise all +cancels occur immediately. The default is FALSE. +<p> <p>See also <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a> and <a href="qdatatable.html#confirmCancel">confirmCancel</a>(). + +<p>Set this property's value with <a href="qdatatable.html#setConfirmCancels">setConfirmCancels</a>() and get this property's value with <a href="qdatatable.html#confirmCancels">confirmCancels</a>(). +</doc> +</property> +<property> + <name>QDataTable::confirmDelete</name> + <doc href="qdatatable.html#confirmDelete-prop"> +<p>This property holds whether the data table confirms delete operations. +<p>If the confirmDelete property is TRUE, all deletions must be +confirmed by the user through a message box (this behaviour can be +changed by overriding the <a href="qdatatable.html#confirmEdit">confirmEdit</a>() function), otherwise all +delete operations occur immediately. +<p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatatable.html#confirmUpdate-prop">confirmUpdate</a>, and <a href="qdatatable.html#confirmInsert-prop">confirmInsert</a>. + +<p>Set this property's value with <a href="qdatatable.html#setConfirmDelete">setConfirmDelete</a>() and get this property's value with <a href="qdatatable.html#confirmDelete">confirmDelete</a>(). +</doc> +</property> +<property> + <name>QDataTable::confirmEdits</name> + <doc href="qdatatable.html#confirmEdits-prop"> +<p>This property holds whether the data table confirms edit operations. +<p>If the confirmEdits property is TRUE, the data table confirms all +edit operations (inserts, updates and deletes). Finer control of +edit confirmation can be achieved using <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmInsert-prop">confirmInsert</a>, <a href="qdatatable.html#confirmUpdate-prop">confirmUpdate</a> and <a href="qdatatable.html#confirmDelete-prop">confirmDelete</a>. +<p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmInsert-prop">confirmInsert</a>, <a href="qdatatable.html#confirmUpdate-prop">confirmUpdate</a>, and <a href="qdatatable.html#confirmDelete-prop">confirmDelete</a>. + +<p>Set this property's value with <a href="qdatatable.html#setConfirmEdits">setConfirmEdits</a>() and get this property's value with <a href="qdatatable.html#confirmEdits">confirmEdits</a>(). +</doc> +</property> +<property> + <name>QDataTable::confirmInsert</name> + <doc href="qdatatable.html#confirmInsert-prop"> +<p>This property holds whether the data table confirms insert operations. +<p>If the confirmInsert property is TRUE, all insertions must be +confirmed by the user through a message box (this behaviour can be +changed by overriding the <a href="qdatatable.html#confirmEdit">confirmEdit</a>() function), otherwise all +insert operations occur immediately. +<p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatatable.html#confirmUpdate-prop">confirmUpdate</a>, and <a href="qdatatable.html#confirmDelete-prop">confirmDelete</a>. + +<p>Set this property's value with <a href="qdatatable.html#setConfirmInsert">setConfirmInsert</a>() and get this property's value with <a href="qdatatable.html#confirmInsert">confirmInsert</a>(). +</doc> +</property> +<property> + <name>QDataTable::confirmUpdate</name> + <doc href="qdatatable.html#confirmUpdate-prop"> +<p>This property holds whether the data table confirms update operations. +<p>If the confirmUpdate property is TRUE, all updates must be +confirmed by the user through a message box (this behaviour can be +changed by overriding the <a href="qdatatable.html#confirmEdit">confirmEdit</a>() function), otherwise all +update operations occur immediately. +<p> <p>See also <a href="qdatatable.html#confirmCancels-prop">confirmCancels</a>, <a href="qdatatable.html#confirmEdits-prop">confirmEdits</a>, <a href="qdatatable.html#confirmInsert-prop">confirmInsert</a>, and <a href="qdatatable.html#confirmDelete-prop">confirmDelete</a>. + +<p>Set this property's value with <a href="qdatatable.html#setConfirmUpdate">setConfirmUpdate</a>() and get this property's value with <a href="qdatatable.html#confirmUpdate">confirmUpdate</a>(). +</doc> +</property> +<property> + <name>QDataTable::dateFormat</name> + <doc href="qdatatable.html#dateFormat-prop"> +<p>This property holds the format used for displaying date/time values. +<p>The dateFormat property is used for displaying date/time values in +the table. The default value is <a href="qt.html#DateFormat-enum">Qt::LocalDate</a>. + +<p>Set this property's value with <a href="qdatatable.html#setDateFormat">setDateFormat</a>() and get this property's value with <a href="qdatatable.html#dateFormat">dateFormat</a>(). +</doc> +</property> +<property> + <name>QDataTable::falseText</name> + <doc href="qdatatable.html#falseText-prop"> +<p>This property holds the text used to represent false values. +<p>The falseText property will be used to represent NULL values in +the table. The default value is "False". + +<p>Set this property's value with <a href="qdatatable.html#setFalseText">setFalseText</a>() and get this property's value with <a href="qdatatable.html#falseText">falseText</a>(). +</doc> +</property> +<property> + <name>QDataTable::filter</name> + <doc href="qdatatable.html#filter-prop"> +<p>This property holds the data filter for the data table. +<p>The filter applies to the data shown in the table. To view data +with a new filter, use <a href="qdatatable.html#refresh">refresh</a>(). A filter string is an SQL WHERE +clause without the WHERE keyword. +<p> There is no default filter. +<p> <p>See also <a href="qdatatable.html#sort-prop">sort</a>. + +<p> +<p>Set this property's value with <a href="qdatatable.html#setFilter">setFilter</a>() and get this property's value with <a href="qdatatable.html#filter">filter</a>(). +</doc> +</property> +<property> + <name>QDataTable::nullText</name> + <doc href="qdatatable.html#nullText-prop"> +<p>This property holds the text used to represent NULL values. +<p>The nullText property will be used to represent NULL values in the +table. The default value is provided by the cursor's driver. + +<p>Set this property's value with <a href="qdatatable.html#setNullText">setNullText</a>() and get this property's value with <a href="qdatatable.html#nullText">nullText</a>(). +</doc> +</property> +<property> + <name>QDataTable::numCols</name> + <doc href="qdatatable.html#numCols-prop"> +<p>This property holds the number of columns in the table. +<p> +<p>Get this property's value with <a href="qdatatable.html#numCols">numCols</a>(). +</doc> +</property> +<property> + <name>QDataTable::numRows</name> + <doc href="qdatatable.html#numRows-prop"> +<p>This property holds the number of rows in the table. +<p> +<p>Get this property's value with <a href="qdatatable.html#numRows">numRows</a>(). +</doc> +</property> +<property> + <name>QDataTable::sort</name> + <doc href="qdatatable.html#sort-prop"> +<p>This property holds the data table's sort. +<p>The table's sort affects the order in which data records are +displayed in the table. To apply a sort, use <a href="qdatatable.html#refresh">refresh</a>(). +<p> When examining the sort property, a string list is returned with +each item having the form 'fieldname order' (e.g., 'id ASC', +'surname DESC'). +<p> There is no default sort. +<p> Note that if you want to iterate over the sort list, you should +iterate over a copy, e.g. +<pre> + <a href="qstringlist.html">QStringList</a> list = myDataTable.sort(); + QStringList::Iterator it = list.<a href="qvaluelist.html#begin">begin</a>(); + while( it != list.<a href="qvaluelist.html#end">end</a>() ) { + myProcessing( *it ); + ++it; + } + </pre> + +<p> <p>See also <a href="qdatatable.html#filter-prop">filter</a> and <a href="qdatatable.html#refresh">refresh</a>(). + +<p>Set this property's value with <a href="qdatatable.html#setSort">setSort</a>() and get this property's value with <a href="qdatatable.html#sort">sort</a>(). +</doc> +</property> +<property> + <name>QDataTable::trueText</name> + <doc href="qdatatable.html#trueText-prop"> +<p>This property holds the text used to represent true values. +<p>The trueText property will be used to represent NULL values in the +table. The default value is "True". + +<p>Set this property's value with <a href="qdatatable.html#setTrueText">setTrueText</a>() and get this property's value with <a href="qdatatable.html#trueText">trueText</a>(). +</doc> +</property> +<property> + <name>QDateEdit::autoAdvance</name> + <doc href="qdateedit.html#autoAdvance-prop"> +<p>This property holds whether the editor automatically advances to the next section. +<p>If autoAdvance is TRUE, the editor will automatically advance +focus to the next date section if a user has completed a section. +The default is FALSE. + +<p>Set this property's value with <a href="qdateedit.html#setAutoAdvance">setAutoAdvance</a>() and get this property's value with <a href="qdateedit.html#autoAdvance">autoAdvance</a>(). +</doc> +</property> +<property> + <name>QDateEdit::date</name> + <doc href="qdateedit.html#date-prop"> +<p>This property holds the editor's date value. +<p>If the date property is not valid, the editor displays all zeroes +and <a href="qdateedit.html#date">QDateEdit::date</a>() will return an invalid date. It is strongly +recommended that the editor is given a default date value (e.g. +currentDate()). That way, attempts to set the date property to an +invalid date will fail. +<p> When changing the date property, if the date is less than +<a href="qdateedit.html#minValue">minValue</a>(), or is greater than <a href="qdateedit.html#maxValue">maxValue</a>(), nothing happens. + +<p>Set this property's value with <a href="qdateedit.html#setDate">setDate</a>() and get this property's value with <a href="qdateedit.html#date">date</a>(). +</doc> +</property> +<property> + <name>QDateEdit::maxValue</name> + <doc href="qdateedit.html#maxValue-prop"> +<p>This property holds the editor's maximum value. +<p>Setting the maximum date value for the editor is equivalent to +calling <a href="qdateedit.html#setRange">QDateEdit::setRange</a>( <a href="qdateedit.html#minValue">minValue</a>(), <em>d</em> ), where <em>d</em> is the +maximum date. The default maximum date is 8000-12-31. +<p> <p>See also <a href="qdateedit.html#minValue-prop">minValue</a> and <a href="qdateedit.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qdateedit.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qdateedit.html#maxValue">maxValue</a>(). +</doc> +</property> +<property> + <name>QDateEdit::minValue</name> + <doc href="qdateedit.html#minValue-prop"> +<p>This property holds the editor's minimum value. +<p>Setting the minimum date value is equivalent to calling +<a href="qdateedit.html#setRange">QDateEdit::setRange</a>( <em>d</em>, <a href="qdateedit.html#maxValue">maxValue</a>() ), where <em>d</em> is the minimum +date. The default minimum date is 1752-09-14. +<p> <p>See also <a href="qdateedit.html#maxValue-prop">maxValue</a> and <a href="qdateedit.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qdateedit.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qdateedit.html#minValue">minValue</a>(). +</doc> +</property> +<property> + <name>QDateEdit::order</name> + <doc href="qdateedit.html#order-prop"> +<p>This property holds the order in which the year, month and day appear. +<p>The default order is locale dependent. +<p> <p>See also <a href="qdateedit.html#Order-enum">Order</a>. + +<p>Set this property's value with <a href="qdateedit.html#setOrder">setOrder</a>() and get this property's value with <a href="qdateedit.html#order">order</a>(). +</doc> +</property> +<property> + <name>QDateTimeEdit::dateTime</name> + <doc href="qdatetimeedit.html#dateTime-prop"> +<p>This property holds the editor's datetime value. +<p>The datetime edit's datetime which may be an invalid datetime. + +<p>Set this property's value with <a href="qdatetimeedit.html#setDateTime">setDateTime</a>() and get this property's value with <a href="qdatetimeedit.html#dateTime">dateTime</a>(). +</doc> +</property> +<property> + <name>QDial::lineStep</name> + <doc href="qdial.html#lineStep-prop"> +<p>This property holds the current line step. +<p>setLineStep() calls the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function if the new +line step is different from the previous setting. +<p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>(), <a href="qdial.html#pageStep-prop">pageStep</a>, and <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qdial.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qdial.html#lineStep">lineStep</a>(). +</doc> +</property> +<property> + <name>QDial::maxValue</name> + <doc href="qdial.html#maxValue-prop"> +<p>This property holds the current maximum value. +<p>When setting this property, the <a href="qdial.html#minValue-prop">QDial::minValue</a> is adjusted if +necessary to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qdial.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qdial.html#maxValue">maxValue</a>(). +</doc> +</property> +<property> + <name>QDial::minValue</name> + <doc href="qdial.html#minValue-prop"> +<p>This property holds the current minimum value. +<p>When setting this property, the <a href="qdial.html#maxValue-prop">QDial::maxValue</a> is adjusted if +necessary to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qdial.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qdial.html#minValue">minValue</a>(). +</doc> +</property> +<property> + <name>QDial::notchSize</name> + <doc href="qdial.html#notchSize-prop"> +<p>This property holds the current notch size. +<p>The notch size is in range control units, not pixels, and if +possible it is a multiple of <a href="qdial.html#lineStep">lineStep</a>() that results in an +on-screen notch size near <a href="qdial.html#notchTarget">notchTarget</a>(). +<p> <p>See also <a href="qdial.html#notchTarget-prop">notchTarget</a> and <a href="qdial.html#lineStep-prop">lineStep</a>. + +<p>Get this property's value with <a href="qdial.html#notchSize">notchSize</a>(). +</doc> +</property> +<property> + <name>QDial::notchTarget</name> + <doc href="qdial.html#notchTarget-prop"> +<p>This property holds the target number of pixels between notches. +<p>The notch target is the number of pixels QDial attempts to put +between each notch. +<p> The actual size may differ from the target size. + +<p>Set this property's value with <a href="qdial.html#setNotchTarget">setNotchTarget</a>() and get this property's value with <a href="qdial.html#notchTarget">notchTarget</a>(). +</doc> +</property> +<property> + <name>QDial::notchesVisible</name> + <doc href="qdial.html#notchesVisible-prop"> +<p>This property holds whether the notches are shown. +<p>If TRUE, the notches are shown. If FALSE (the default) notches are +not shown. + +<p>Set this property's value with <a href="qdial.html#setNotchesVisible">setNotchesVisible</a>() and get this property's value with <a href="qdial.html#notchesVisible">notchesVisible</a>(). +</doc> +</property> +<property> + <name>QDial::pageStep</name> + <doc href="qdial.html#pageStep-prop"> +<p>This property holds the current page step. +<p>setPageStep() calls the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function if the new +page step is different from the previous setting. +<p> <p>See also <a href="qrangecontrol.html#stepChange">stepChange</a>(). + +<p>Set this property's value with <a href="qdial.html#setPageStep">setPageStep</a>() and get this property's value with <a href="qdial.html#pageStep">pageStep</a>(). +</doc> +</property> +<property> + <name>QDial::tracking</name> + <doc href="qdial.html#tracking-prop"> +<p>This property holds whether tracking is enabled. +<p>If TRUE (the default), tracking is enabled. This means that the +arrow can be moved using the mouse; otherwise the arrow cannot be +moved with the mouse. + +<p>Set this property's value with <a href="qdial.html#setTracking">setTracking</a>() and get this property's value with <a href="qdial.html#tracking">tracking</a>(). +</doc> +</property> +<property> + <name>QDial::value</name> + <doc href="qdial.html#value-prop"> +<p>This property holds the current dial value. +<p>This is guaranteed to be within the range +<a href="qdial.html#minValue-prop">QDial::minValue</a>..<a href="qdial.html#maxValue-prop">QDial::maxValue</a>. +<p> <p>See also <a href="qdial.html#minValue-prop">minValue</a> and <a href="qdial.html#maxValue-prop">maxValue</a>. + +<p>Set this property's value with <a href="qdial.html#setValue">setValue</a>() and get this property's value with <a href="qdial.html#value">value</a>(). +</doc> +</property> +<property> + <name>QDial::wrapping</name> + <doc href="qdial.html#wrapping-prop"> +<p>This property holds whether wrapping is enabled. +<p>If TRUE, wrapping is enabled. This means that the arrow can be +turned around 360°. Otherwise there is some space at the bottom of +the dial which is skipped by the arrow. +<p> This property's default is FALSE. + +<p>Set this property's value with <a href="qdial.html#setWrapping">setWrapping</a>() and get this property's value with <a href="qdial.html#wrapping">wrapping</a>(). +</doc> +</property> +<property> + <name>QDialog::modal</name> + <doc href="qdialog.html#modal-prop"> <p>This property holds whether <a href="qdialog.html#show">show</a>() should pop up the dialog as modal or modeless. +<p>By default, this property is false and show() pops up the dialog as +modeless. +<p> <a href="qdialog.html#exec">exec</a>() ignores the value of this property and always pops up the +dialog as modal. +<p> <p>See also <a href="qdialog.html#show">show</a>() and <a href="qdialog.html#exec">exec</a>(). + +<p>Set this property's value with <a href="qdialog.html#setModal">setModal</a>() and get this property's value with <a href="qdialog.html#isModal">isModal</a>(). +</doc> +</property> +<property> + <name>QDialog::sizeGripEnabled</name> + <doc href="qdialog.html#sizeGripEnabled-prop"> +<p>This property holds whether the size grip is enabled. +<p>A <a href="qsizegrip.html">QSizeGrip</a> is placed in the bottom right corner of the dialog when this +property is enabled. By default, the size grip is disabled. + +<p>Set this property's value with <a href="qdialog.html#setSizeGripEnabled">setSizeGripEnabled</a>() and get this property's value with <a href="qdialog.html#isSizeGripEnabled">isSizeGripEnabled</a>(). +</doc> +</property> +<property> + <name>QDockArea::count</name> + <doc href="qdockarea.html#count-prop"> +<p>This property holds the number of dock windows in the dock area. +<p> +<p>Get this property's value with <a href="qdockarea.html#count">count</a>(). +</doc> +</property> +<property> + <name>QDockArea::empty</name> + <doc href="qdockarea.html#empty-prop"> +<p>This property holds whether the dock area is empty. +<p> +<p>Get this property's value with <a href="qdockarea.html#isEmpty">isEmpty</a>(). +</doc> +</property> +<property> + <name>QDockArea::handlePosition</name> + <doc href="qdockarea.html#handlePosition-prop"> +<p>This property holds where the dock window splitter handle is placed in the dock area. +<p>The default position is <a href="qdockarea.html#HandlePosition-enum">Normal</a>. + +<p>Get this property's value with <a href="qdockarea.html#handlePosition">handlePosition</a>(). +</doc> +</property> +<property> + <name>QDockArea::orientation</name> + <doc href="qdockarea.html#orientation-prop"> +<p>This property holds the dock area's orientation. +<p>There is no default value; the orientation is specified in the +constructor. + +<p>Get this property's value with <a href="qdockarea.html#orientation">orientation</a>(). +</doc> +</property> +<property> + <name>QDockWindow::closeMode</name> + <doc href="qdockwindow.html#closeMode-prop"> +<p>This property holds the close mode of a dock window. +<p>Defines when (if ever) the dock window has a close button. The +choices are <a href="qdockwindow.html#CloseMode-enum">Never</a>, <a href="qdockwindow.html#CloseMode-enum">Docked</a> (i.e. only when docked), <a href="qdockwindow.html#CloseMode-enum">Undocked</a> (only when undocked, i.e. floated) or <a href="qdockwindow.html#CloseMode-enum">Always</a>. +<p> The default is <a href="qdockwindow.html#CloseMode-enum">Never</a>. + +<p>Set this property's value with <a href="qdockwindow.html#setCloseMode">setCloseMode</a>() and get this property's value with <a href="qdockwindow.html#closeMode">closeMode</a>(). +</doc> +</property> +<property> + <name>QDockWindow::horizontallyStretchable</name> + <doc href="qdockwindow.html#horizontallyStretchable-prop"> +<p>This property holds whether the dock window is horizontally stretchable. +<p>A dock window is horizontally stretchable if you call +<a href="qdockwindow.html#setHorizontallyStretchable">setHorizontallyStretchable</a>(TRUE) or <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>(TRUE). +<p> <p>See also <a href="qdockwindow.html#resizeEnabled-prop">resizeEnabled</a>. + +<p>Bugs and limitations: +<ul> +<li> Strecthability is broken. You must call setResizeEnabled(TRUE) to get +proper behavior and even then QDockWindow does not limit stretchablilty. +</ul> +<p>Set this property's value with <a href="qdockwindow.html#setHorizontallyStretchable">setHorizontallyStretchable</a>() and get this property's value with <a href="qdockwindow.html#isHorizontallyStretchable">isHorizontallyStretchable</a>(). +</doc> +</property> +<property> + <name>QDockWindow::movingEnabled</name> + <doc href="qdockwindow.html#movingEnabled-prop"> +<p>This property holds whether the user can move the dock window within the dock area, move the dock window to another dock area, or float the dock window. +<p>This property is TRUE by default. + +<p>Set this property's value with <a href="qdockwindow.html#setMovingEnabled">setMovingEnabled</a>() and get this property's value with <a href="qdockwindow.html#isMovingEnabled">isMovingEnabled</a>(). +</doc> +</property> +<property> + <name>QDockWindow::newLine</name> + <doc href="qdockwindow.html#newLine-prop"> +<p>This property holds whether the dock window prefers to start a new line in the dock area. +<p>The default is FALSE, i.e. the dock window doesn't require a new +line in the dock area. + +<p>Set this property's value with <a href="qdockwindow.html#setNewLine">setNewLine</a>() and get this property's value with <a href="qdockwindow.html#newLine">newLine</a>(). +</doc> +</property> +<property> + <name>QDockWindow::offset</name> + <doc href="qdockwindow.html#offset-prop"> +<p>This property holds the dock window's preferred offset from the dock area's left edge (top edge for vertical dock areas). +<p>The default is 0. + +<p>Set this property's value with <a href="qdockwindow.html#setOffset">setOffset</a>() and get this property's value with <a href="qdockwindow.html#offset">offset</a>(). +</doc> +</property> +<property> + <name>QDockWindow::opaqueMoving</name> + <doc href="qdockwindow.html#opaqueMoving-prop"> +<p>This property holds whether the dock window will be shown normally whilst it is being moved. +<p>If this property is FALSE, (the default), the dock window will be +represented by an outline rectangle whilst it is being moved. +<p> <b>Warning:</b> Currently opaque moving has some problems and we do not +recommend using it at this time. We expect to fix these problems +in a future release. + +<p>Set this property's value with <a href="qdockwindow.html#setOpaqueMoving">setOpaqueMoving</a>() and get this property's value with <a href="qdockwindow.html#opaqueMoving">opaqueMoving</a>(). +</doc> +</property> +<property> + <name>QDockWindow::resizeEnabled</name> + <doc href="qdockwindow.html#resizeEnabled-prop"> +<p>This property holds whether the dock window is resizeable. +<p>A resizeable dock window can be resized using splitter-like +handles inside a dock area and like every other top level window +when floating. +<p> A dock window is both horizontally and vertically stretchable if +you call <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>(TRUE). +<p> This property is FALSE by default. +<p> <p>See also <a href="qdockwindow.html#verticallyStretchable-prop">verticallyStretchable</a> and <a href="qdockwindow.html#horizontallyStretchable-prop">horizontallyStretchable</a>. + +<p>Set this property's value with <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>() and get this property's value with <a href="qdockwindow.html#isResizeEnabled">isResizeEnabled</a>(). +</doc> +</property> +<property> + <name>QDockWindow::stretchable</name> + <doc href="qdockwindow.html#stretchable-prop"> +<p>This property holds whether the dock window is stretchable in the current <a href="qdockwindow.html#orientation">orientation</a>(). +<p>This property can be set using <a href="qdockwindow.html#setHorizontallyStretchable">setHorizontallyStretchable</a>() and +<a href="qdockwindow.html#setVerticallyStretchable">setVerticallyStretchable</a>(), or with <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>(). +<p> <p>See also <a href="qdockwindow.html#resizeEnabled-prop">resizeEnabled</a>. + +<p>Bugs and limitations: +<ul> +<li> Strecthability is broken. You must call setResizeEnabled(TRUE) to get +proper behavior and even then QDockWindow does not limit stretchablilty. +</ul> +<p>Get this property's value with <a href="qdockwindow.html#isStretchable">isStretchable</a>(). +</doc> +</property> +<property> + <name>QDockWindow::verticallyStretchable</name> + <doc href="qdockwindow.html#verticallyStretchable-prop"> +<p>This property holds whether the dock window is vertically stretchable. +<p>A dock window is vertically stretchable if you call +<a href="qdockwindow.html#setVerticallyStretchable">setVerticallyStretchable</a>(TRUE) or <a href="qdockwindow.html#setResizeEnabled">setResizeEnabled</a>(TRUE). +<p> <p>See also <a href="qdockwindow.html#resizeEnabled-prop">resizeEnabled</a>. + +<p>Bugs and limitations: +<ul> +<li> Strecthability is broken. You must call setResizeEnabled(TRUE) to get +proper behavior and even then QDockWindow does not limit stretchablilty. +</ul> +<p>Set this property's value with <a href="qdockwindow.html#setVerticallyStretchable">setVerticallyStretchable</a>() and get this property's value with <a href="qdockwindow.html#isVerticallyStretchable">isVerticallyStretchable</a>(). +</doc> +</property> +<property> + <name>QDoubleValidator::bottom</name> + <doc href="qdoublevalidator.html#bottom-prop"> +<p>This property holds the validator's minimum acceptable value. +<p>Set this property's value with <a href="qdoublevalidator.html#setBottom">setBottom</a>() and get this property's value with <a href="qdoublevalidator.html#bottom">bottom</a>(). +<p><p>See also <a href="qdoublevalidator.html#setRange">setRange</a>(). + +</doc> +</property> +<property> + <name>QDoubleValidator::decimals</name> + <doc href="qdoublevalidator.html#decimals-prop"> +<p>This property holds the validator's maximum number of digits after the decimal point. +<p>Set this property's value with <a href="qdoublevalidator.html#setDecimals">setDecimals</a>() and get this property's value with <a href="qdoublevalidator.html#decimals">decimals</a>(). +<p><p>See also <a href="qdoublevalidator.html#setRange">setRange</a>(). + +</doc> +</property> +<property> + <name>QDoubleValidator::top</name> + <doc href="qdoublevalidator.html#top-prop"> +<p>This property holds the validator's maximum acceptable value. +<p>Set this property's value with <a href="qdoublevalidator.html#setTop">setTop</a>() and get this property's value with <a href="qdoublevalidator.html#top">top</a>(). +<p><p>See also <a href="qdoublevalidator.html#setRange">setRange</a>(). + +</doc> +</property> +<property> + <name>QFileDialog::contentsPreview</name> + <doc href="qfiledialog.html#contentsPreview-prop"> +<p>This property holds whether the file dialog can provide a contents preview of the currently selected file. +<p>The default is FALSE. +<p> <p>See also <a href="qfiledialog.html#setContentsPreview">setContentsPreview</a>() and <a href="qfiledialog.html#infoPreview-prop">infoPreview</a>. + +<p>Set this property's value with <a href="qfiledialog.html#setContentsPreviewEnabled">setContentsPreviewEnabled</a>() and get this property's value with <a href="qfiledialog.html#isContentsPreviewEnabled">isContentsPreviewEnabled</a>(). +</doc> +</property> +<property> + <name>QFileDialog::dirPath</name> + <doc href="qfiledialog.html#dirPath-prop"> +<p>This property holds the file dialog's working directory. +<p>Get this property's value with <a href="qfiledialog.html#dirPath">dirPath</a>(). +<p><p>See also <a href="qfiledialog.html#dir">dir</a>() and <a href="qfiledialog.html#setDir">setDir</a>(). + +</doc> +</property> +<property> + <name>QFileDialog::infoPreview</name> + <doc href="qfiledialog.html#infoPreview-prop"> +<p>This property holds whether the file dialog can provide preview information about the currently selected file. +<p>The default is FALSE. + +<p>Set this property's value with <a href="qfiledialog.html#setInfoPreviewEnabled">setInfoPreviewEnabled</a>() and get this property's value with <a href="qfiledialog.html#isInfoPreviewEnabled">isInfoPreviewEnabled</a>(). +</doc> +</property> +<property> + <name>QFileDialog::mode</name> + <doc href="qfiledialog.html#mode-prop"> +<p>This property holds the file dialog's mode. +<p>The default mode is <a href="qfiledialog.html#Mode-enum">ExistingFile</a>. + +<p>Set this property's value with <a href="qfiledialog.html#setMode">setMode</a>() and get this property's value with <a href="qfiledialog.html#mode">mode</a>(). +</doc> +</property> +<property> + <name>QFileDialog::previewMode</name> + <doc href="qfiledialog.html#previewMode-prop"> +<p>This property holds the preview mode for the file dialog. +<p>If you set the mode to be a mode other than <em>NoPreview</em>, you must +use <a href="qfiledialog.html#setInfoPreview">setInfoPreview</a>() or <a href="qfiledialog.html#setContentsPreview">setContentsPreview</a>() to set the dialog's +preview widget to your preview widget and enable the preview +widget(s) with <a href="qfiledialog.html#setInfoPreviewEnabled">setInfoPreviewEnabled</a>() or +<a href="qfiledialog.html#setContentsPreviewEnabled">setContentsPreviewEnabled</a>(). +<p> <p>See also <a href="qfiledialog.html#infoPreview-prop">infoPreview</a>, <a href="qfiledialog.html#contentsPreview-prop">contentsPreview</a>, and <a href="qfiledialog.html#viewMode-prop">viewMode</a>. + +<p>Set this property's value with <a href="qfiledialog.html#setPreviewMode">setPreviewMode</a>() and get this property's value with <a href="qfiledialog.html#previewMode">previewMode</a>(). +</doc> +</property> +<property> + <name>QFileDialog::selectedFile</name> + <doc href="qfiledialog.html#selectedFile-prop"> +<p>This property holds the name of the selected file. +<p>If a file was selected selectedFile contains the file's name including +its absolute path; otherwise selectedFile is empty. +<p> <p>See also <a href="qstring.html#isEmpty">QString::isEmpty</a>(), <a href="qfiledialog.html#selectedFiles-prop">selectedFiles</a>, and <a href="qfiledialog.html#selectedFilter-prop">selectedFilter</a>. + +<p>Get this property's value with <a href="qfiledialog.html#selectedFile">selectedFile</a>(). +</doc> +</property> +<property> + <name>QFileDialog::selectedFiles</name> + <doc href="qfiledialog.html#selectedFiles-prop"> +<p>This property holds the list of selected files. +<p>If one or more files are selected, selectedFiles contains their +names including their absolute paths. If no files are selected or +the mode isn't ExistingFiles selectedFiles is an empty list. +<p> It is more convenient to use <a href="qfiledialog.html#selectedFile">selectedFile</a>() if the mode is +<a href="qfiledialog.html#Mode-enum">ExistingFile</a>, <a href="qfiledialog.html#Mode-enum">Directory</a> or <a href="qfiledialog.html#Mode-enum">DirectoryOnly</a>. +<p> Note that if you want to iterate over the list, you should +iterate over a copy, e.g. +<pre> + <a href="qstringlist.html">QStringList</a> list = myFileDialog.selectedFiles(); + QStringList::Iterator it = list.<a href="qvaluelist.html#begin">begin</a>(); + while( it != list.<a href="qvaluelist.html#end">end</a>() ) { + myProcessing( *it ); + ++it; + } + </pre> + +<p> <p>See also <a href="qfiledialog.html#selectedFile-prop">selectedFile</a>, <a href="qfiledialog.html#selectedFilter-prop">selectedFilter</a>, and <a href="qvaluelist.html#empty">QValueList::empty</a>(). + +<p>Get this property's value with <a href="qfiledialog.html#selectedFiles">selectedFiles</a>(). +</doc> +</property> +<property> + <name>QFileDialog::selectedFilter</name> + <doc href="qfiledialog.html#selectedFilter-prop"> +<p>This property holds the filter which the user has selected in the file dialog. +<p>Get this property's value with <a href="qfiledialog.html#selectedFilter">selectedFilter</a>(). +<p><p>See also <a href="qfiledialog.html#filterSelected">filterSelected</a>(), <a href="qfiledialog.html#selectedFiles-prop">selectedFiles</a>, and <a href="qfiledialog.html#selectedFile-prop">selectedFile</a>. + +</doc> +</property> +<property> + <name>QFileDialog::showHiddenFiles</name> + <doc href="qfiledialog.html#showHiddenFiles-prop"> +<p>This property holds whether hidden files are shown in the file dialog. +<p>The default is FALSE, i.e. don't show hidden files. + +<p>Set this property's value with <a href="qfiledialog.html#setShowHiddenFiles">setShowHiddenFiles</a>() and get this property's value with <a href="qfiledialog.html#showHiddenFiles">showHiddenFiles</a>(). +</doc> +</property> +<property> + <name>QFileDialog::viewMode</name> + <doc href="qfiledialog.html#viewMode-prop"> +<p>This property holds the file dialog's view mode. +<p>If you set the view mode to be <em>Detail</em> (the default), then you +will see the file's details, such as the size of the file and the +date the file was last modified in addition to the file's name. +<p> If you set the view mode to be <em>List</em>, then you will just +see a list of the files and folders. +<p> See <a href="qfiledialog.html#ViewMode-enum">QFileDialog::ViewMode</a> + +<p>Set this property's value with <a href="qfiledialog.html#setViewMode">setViewMode</a>() and get this property's value with <a href="qfiledialog.html#viewMode">viewMode</a>(). +</doc> +</property> +<property> + <name>QFrame::contentsRect</name> + <doc href="qframe.html#contentsRect-prop"> +<p>This property holds the rectangle inside the frame. +<p>Get this property's value with <a href="qframe.html#contentsRect">contentsRect</a>(). +<p><p>See also <a href="qframe.html#frameRect-prop">frameRect</a> and <a href="qframe.html#drawContents">drawContents</a>(). + +</doc> +</property> +<property> + <name>QFrame::frameRect</name> + <doc href="qframe.html#frameRect-prop"> +<p>This property holds the frame rectangle. +<p>The frame rectangle is the rectangle the frame is drawn in. By +default, this is the entire widget. Setting this property does <em>not</em> cause a widget update. +<p> If this property is set to a null rectangle (for example +<tt>QRect(0, 0, 0, 0)</tt>), then the frame rectangle is equivalent to +the <a href="qwidget.html#rect">widget rectangle</a>. +<p> <p>See also <a href="qframe.html#contentsRect-prop">contentsRect</a>. + +<p>Set this property's value with <a href="qframe.html#setFrameRect">setFrameRect</a>() and get this property's value with <a href="qframe.html#frameRect">frameRect</a>(). +</doc> +</property> +<property> + <name>QFrame::frameShadow</name> + <doc href="qframe.html#frameShadow-prop"> +<p>This property holds the frame shadow value from the frame style. +<p>Set this property's value with <a href="qframe.html#setFrameShadow">setFrameShadow</a>() and get this property's value with <a href="qframe.html#frameShadow">frameShadow</a>(). +<p><p>See also <a href="qframe.html#frameStyle">frameStyle</a>() and <a href="qframe.html#frameShape-prop">frameShape</a>. + +</doc> +</property> +<property> + <name>QFrame::frameShape</name> + <doc href="qframe.html#frameShape-prop"> +<p>This property holds the frame shape value from the frame style. +<p>Set this property's value with <a href="qframe.html#setFrameShape">setFrameShape</a>() and get this property's value with <a href="qframe.html#frameShape">frameShape</a>(). +<p><p>See also <a href="qframe.html#frameStyle">frameStyle</a>() and <a href="qframe.html#frameShadow-prop">frameShadow</a>. + +</doc> +</property> +<property> + <name>QFrame::frameWidth</name> + <doc href="qframe.html#frameWidth-prop"> +<p>This property holds the width of the frame that is drawn. +<p>Note that the frame width depends on the <a href="qframe.html#setFrameStyle">frame style</a>, not only the line +width and the mid-line width. For example, the style <a href="qframe.html#Shape-enum">NoFrame</a> +always has a frame width of 0, whereas the style <a href="qframe.html#Shape-enum">Panel</a> has a +frame width equivalent to the line width. The frame width also +includes the margin. +<p> <p>See also <a href="qframe.html#lineWidth-prop">lineWidth</a>, <a href="qframe.html#midLineWidth-prop">midLineWidth</a>, <a href="qframe.html#frameStyle">frameStyle</a>(), and <a href="qframe.html#margin-prop">margin</a>. + +<p>Get this property's value with <a href="qframe.html#frameWidth">frameWidth</a>(). +</doc> +</property> +<property> + <name>QFrame::lineWidth</name> + <doc href="qframe.html#lineWidth-prop"> +<p>This property holds the line width. +<p>Note that the <em>total</em> line width for <a href="qframe.html#Shape-enum">HLine</a> and <a href="qframe.html#Shape-enum">VLine</a> is +given by <a href="qframe.html#frameWidth">frameWidth</a>(), not <a href="qframe.html#lineWidth">lineWidth</a>(). +<p> The default value is 1. +<p> <p>See also <a href="qframe.html#midLineWidth-prop">midLineWidth</a> and <a href="qframe.html#frameWidth-prop">frameWidth</a>. + +<p>Set this property's value with <a href="qframe.html#setLineWidth">setLineWidth</a>() and get this property's value with <a href="qframe.html#lineWidth">lineWidth</a>(). +</doc> +</property> +<property> + <name>QFrame::margin</name> + <doc href="qframe.html#margin-prop"> +<p>This property holds the width of the margin. +<p>The margin is the distance between the innermost pixel of the +frame and the outermost pixel of <a href="qframe.html#contentsRect">contentsRect</a>(). It is included in +<a href="qframe.html#frameWidth">frameWidth</a>(). +<p> The margin is filled according to <a href="qwidget.html#backgroundMode">backgroundMode</a>(). +<p> The default value is 0. +<p> <p>See also <a href="qframe.html#margin-prop">margin</a>, <a href="qframe.html#lineWidth-prop">lineWidth</a>, and <a href="qframe.html#frameWidth-prop">frameWidth</a>. + +<p>Set this property's value with <a href="qframe.html#setMargin">setMargin</a>() and get this property's value with <a href="qframe.html#margin">margin</a>(). +</doc> +</property> +<property> + <name>QFrame::midLineWidth</name> + <doc href="qframe.html#midLineWidth-prop"> +<p>This property holds the width of the mid-line. +<p>The default value is 0. +<p> <p>See also <a href="qframe.html#lineWidth-prop">lineWidth</a> and <a href="qframe.html#frameWidth-prop">frameWidth</a>. + +<p>Set this property's value with <a href="qframe.html#setMidLineWidth">setMidLineWidth</a>() and get this property's value with <a href="qframe.html#midLineWidth">midLineWidth</a>(). +</doc> +</property> +<property> + <name>QGridView::cellHeight</name> + <doc href="qgridview.html#cellHeight-prop"> +<p>This property holds the height of a grid row. +<p>All rows in a grid view have the same height. +<p> <p>See also <a href="qgridview.html#cellWidth-prop">cellWidth</a>. + +<p>Set this property's value with <a href="qgridview.html#setCellHeight">setCellHeight</a>() and get this property's value with <a href="qgridview.html#cellHeight">cellHeight</a>(). +</doc> +</property> +<property> + <name>QGridView::cellWidth</name> + <doc href="qgridview.html#cellWidth-prop"> +<p>This property holds the width of a grid column. +<p>All columns in a grid view have the same width. +<p> <p>See also <a href="qgridview.html#cellHeight-prop">cellHeight</a>. + +<p>Set this property's value with <a href="qgridview.html#setCellWidth">setCellWidth</a>() and get this property's value with <a href="qgridview.html#cellWidth">cellWidth</a>(). +</doc> +</property> +<property> + <name>QGridView::numCols</name> + <doc href="qgridview.html#numCols-prop"> +<p>This property holds the number of columns in the grid. +<p>Set this property's value with <a href="qgridview.html#setNumCols">setNumCols</a>() and get this property's value with <a href="qgridview.html#numCols">numCols</a>(). +<p><p>See also <a href="qgridview.html#numRows-prop">numRows</a>. + +</doc> +</property> +<property> + <name>QGridView::numRows</name> + <doc href="qgridview.html#numRows-prop"> +<p>This property holds the number of rows in the grid. +<p>Set this property's value with <a href="qgridview.html#setNumRows">setNumRows</a>() and get this property's value with <a href="qgridview.html#numRows">numRows</a>(). +<p><p>See also <a href="qgridview.html#numCols-prop">numCols</a>. + +</doc> +</property> +<property> + <name>QGroupBox::alignment</name> + <doc href="qgroupbox.html#alignment-prop"> +<p>This property holds the alignment of the group box title. +<p>The title is always placed on the upper frame line. The horizontal +alignment can be specified by the alignment parameter. +<p> The alignment is one of the following flags: +<ul> +<li> <a href="qt.html#AlignmentFlags-enum">AlignAuto</a> aligns the title according to the language, +usually to the left. +<li> <a href="qt.html#AlignmentFlags-enum">AlignLeft</a> aligns the title text to the left. +<li> <a href="qt.html#AlignmentFlags-enum">AlignRight</a> aligns the title text to the right. +<li> <a href="qt.html#AlignmentFlags-enum">AlignHCenter</a> aligns the title text centered. +</ul> +<p> The default alignment is <a href="qt.html#AlignmentFlags-enum">AlignAuto</a>. +<p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>. + +<p>Set this property's value with <a href="qgroupbox.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qgroupbox.html#alignment">alignment</a>(). +</doc> +</property> +<property> + <name>QGroupBox::checkable</name> + <doc href="qgroupbox.html#checkable-prop"> +<p>This property holds whether the group box has a checkbox in its title. +<p>If this property is TRUE, the group box has a checkbox. If the +checkbox is checked (which is the default), the group box's +children are enabled. +<p> <a href="qgroupbox.html#setCheckable">setCheckable</a>() controls whether or not the group box has a +checkbox, and <a href="qgroupbox.html#isCheckable">isCheckable</a>() controls whether the checkbox is +checked or not. + +<p>Set this property's value with <a href="qgroupbox.html#setCheckable">setCheckable</a>() and get this property's value with <a href="qgroupbox.html#isCheckable">isCheckable</a>(). +</doc> +</property> +<property> + <name>QGroupBox::checked</name> + <doc href="qgroupbox.html#checked-prop"> +<p>This property holds whether the group box's checkbox is checked. +<p>If the group box has a check box (see <a href="qgroupbox.html#isCheckable">isCheckable</a>()), and the +check box is checked (see <a href="qgroupbox.html#isChecked">isChecked</a>()), the group box's children +are enabled. If the checkbox is unchecked the children are +disabled. + +<p>Set this property's value with <a href="qgroupbox.html#setChecked">setChecked</a>() and get this property's value with <a href="qgroupbox.html#isChecked">isChecked</a>(). +</doc> +</property> +<property> + <name>QGroupBox::columns</name> + <doc href="qgroupbox.html#columns-prop"> +<p>This property holds the number of columns or rows (depending on <a href="qgroupbox.html#orientation-prop">QGroupBox::orientation</a>) in the group box. +<p>Usually it is not a good idea to set this property because it is +slow (it does a complete layout). It is best to set the number +of columns directly in the constructor. + +<p>Set this property's value with <a href="qgroupbox.html#setColumns">setColumns</a>() and get this property's value with <a href="qgroupbox.html#columns">columns</a>(). +</doc> +</property> +<property> + <name>QGroupBox::flat</name> + <doc href="qgroupbox.html#flat-prop"> +<p>This property holds whether the group box is painted flat or has a frame. +<p>By default a group box has a surrounding frame, with the title +being placed on the upper frame line. In flat mode the right, left +and bottom frame lines are omitted, and only the thin line at the +top is drawn. +<p> <p>See also <a href="qgroupbox.html#title-prop">title</a>. + +<p>Set this property's value with <a href="qgroupbox.html#setFlat">setFlat</a>() and get this property's value with <a href="qgroupbox.html#isFlat">isFlat</a>(). +</doc> +</property> +<property> + <name>QGroupBox::orientation</name> + <doc href="qgroupbox.html#orientation-prop"> +<p>This property holds the group box's orientation. +<p>A horizontal group box arranges it's children in columns, while a +vertical group box arranges them in rows. +<p> Usually it is not a good idea to set this property because it is +slow (it does a complete layout). It is better to set the +orientation directly in the constructor. + +<p>Set this property's value with <a href="qgroupbox.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qgroupbox.html#orientation">orientation</a>(). +</doc> +</property> +<property> + <name>QGroupBox::title</name> + <doc href="qgroupbox.html#title-prop"> +<p>This property holds the group box title text. +<p>The group box title text will have a focus-change keyboard +accelerator if the title contains &amp;, followed by a letter. +<p> <pre> + g-&gt;setTitle( "&amp;User information" ); + </pre> + +This produces "<u>U</u>ser information"; Alt+U moves the <a href="focus.html#keyboard-focus">keyboard focus</a> to the group box. +<p> There is no default title text. + +<p>Set this property's value with <a href="qgroupbox.html#setTitle">setTitle</a>() and get this property's value with <a href="qgroupbox.html#title">title</a>(). +</doc> +</property> +<property> + <name>QHeader::count</name> + <doc href="qheader.html#count-prop"> +<p>This property holds the number of sections in the header. +<p> +<p>Get this property's value with <a href="qheader.html#count">count</a>(). +</doc> +</property> +<property> + <name>QHeader::moving</name> + <doc href="qheader.html#moving-prop"> +<p>This property holds whether the header sections can be moved. +<p>If this property is TRUE (the default) the user can move sections. +If the user moves a section the <a href="qheader.html#indexChange">indexChange</a>() signal is emitted. +<p> <p>See also <a href="qheader.html#setClickEnabled">setClickEnabled</a>() and <a href="qheader.html#setResizeEnabled">setResizeEnabled</a>(). + +<p>Set this property's value with <a href="qheader.html#setMovingEnabled">setMovingEnabled</a>() and get this property's value with <a href="qheader.html#isMovingEnabled">isMovingEnabled</a>(). +</doc> +</property> +<property> + <name>QHeader::offset</name> + <doc href="qheader.html#offset-prop"> +<p>This property holds the header's left-most (or top-most) visible pixel. +<p>Setting this property will scroll the header so that <em>offset</em> +becomes the left-most (or top-most for vertical headers) visible +pixel. + +<p>Set this property's value with <a href="qheader.html#setOffset">setOffset</a>() and get this property's value with <a href="qheader.html#offset">offset</a>(). +</doc> +</property> +<property> + <name>QHeader::orientation</name> + <doc href="qheader.html#orientation-prop"> +<p>This property holds the header's orientation. +<p>The orientation is either <a href="qt.html#Orientation-enum">Vertical</a> or <a href="qt.html#Orientation-enum">Horizontal</a> (the +default). +<p> Call <a href="qheader.html#setOrientation">setOrientation</a>() before adding labels if you don't provide a +size parameter otherwise the sizes will be incorrect. + +<p>Set this property's value with <a href="qheader.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qheader.html#orientation">orientation</a>(). +</doc> +</property> +<property> + <name>QHeader::stretching</name> + <doc href="qheader.html#stretching-prop"> +<p>This property holds whether the header sections always take up the full width (or height) of the header. +<p> +<p>Set this property's value with <a href="qheader.html#setStretchEnabled">setStretchEnabled</a>() and get this property's value with <a href="qheader.html#isStretchEnabled">isStretchEnabled</a>(). +</doc> +</property> +<property> + <name>QHeader::tracking</name> + <doc href="qheader.html#tracking-prop"> +<p>This property holds whether the <a href="qheader.html#sizeChange">sizeChange</a>() signal is emitted continuously. +<p>If tracking is on, the sizeChange() signal is emitted continuously +while the mouse is moved (i.e. when the header is resized), +otherwise it is only emitted when the mouse button is released at +the end of resizing. +<p> Tracking defaults to FALSE. + +<p>Set this property's value with <a href="qheader.html#setTracking">setTracking</a>() and get this property's value with <a href="qheader.html#tracking">tracking</a>(). +</doc> +</property> +<property> + <name>QIconView::arrangement</name> + <doc href="qiconview.html#arrangement-prop"> +<p>This property holds the arrangement mode of the icon view. +<p>This can be <a href="qiconview.html#Arrangement-enum">LeftToRight</a> or <a href="qiconview.html#Arrangement-enum">TopToBottom</a>. The default is <a href="qiconview.html#Arrangement-enum">LeftToRight</a>. + +<p>Set this property's value with <a href="qiconview.html#setArrangement">setArrangement</a>() and get this property's value with <a href="qiconview.html#arrangement">arrangement</a>(). +</doc> +</property> +<property> + <name>QIconView::autoArrange</name> + <doc href="qiconview.html#autoArrange-prop"> +<p>This property holds whether the icon view rearranges its items when a new item is inserted. +<p>The default is TRUE. +<p> Note that if the icon view is not visible at the time of +insertion, QIconView defers all position-related work until it is +shown and then calls <a href="qiconview.html#arrangeItemsInGrid">arrangeItemsInGrid</a>(). + +<p>Set this property's value with <a href="qiconview.html#setAutoArrange">setAutoArrange</a>() and get this property's value with <a href="qiconview.html#autoArrange">autoArrange</a>(). +</doc> +</property> +<property> + <name>QIconView::count</name> + <doc href="qiconview.html#count-prop"> +<p>This property holds the number of items in the icon view. +<p> +<p>Get this property's value with <a href="qiconview.html#count">count</a>(). +</doc> +</property> +<property> + <name>QIconView::gridX</name> + <doc href="qiconview.html#gridX-prop"> +<p>This property holds the horizontal grid of the icon view. +<p>If the value is -1, (the default), QIconView computes suitable +column widths based on the icon view's contents. +<p> Note that setting a grid width overrides <a href="qiconview.html#setMaxItemWidth">setMaxItemWidth</a>(). + +<p>Set this property's value with <a href="qiconview.html#setGridX">setGridX</a>() and get this property's value with <a href="qiconview.html#gridX">gridX</a>(). +</doc> +</property> +<property> + <name>QIconView::gridY</name> + <doc href="qiconview.html#gridY-prop"> +<p>This property holds the vertical grid of the icon view. +<p>If the value is -1, (the default), QIconView computes suitable +column heights based on the icon view's contents. + +<p>Set this property's value with <a href="qiconview.html#setGridY">setGridY</a>() and get this property's value with <a href="qiconview.html#gridY">gridY</a>(). +</doc> +</property> +<property> + <name>QIconView::itemTextBackground</name> + <doc href="qiconview.html#itemTextBackground-prop"> +<p>This property holds the brush to use when drawing the background of an item's text. +<p>By default this brush is set to NoBrush, meaning that only the +normal icon view background is used. + +<p>Set this property's value with <a href="qiconview.html#setItemTextBackground">setItemTextBackground</a>() and get this property's value with <a href="qiconview.html#itemTextBackground">itemTextBackground</a>(). +</doc> +</property> +<property> + <name>QIconView::itemTextPos</name> + <doc href="qiconview.html#itemTextPos-prop"> +<p>This property holds the position where the text of each item is drawn. +<p>Valid values are <a href="qiconview.html#ItemTextPos-enum">Bottom</a> or <a href="qiconview.html#ItemTextPos-enum">Right</a>. The default is <a href="qiconview.html#ItemTextPos-enum">Bottom</a>. + +<p>Set this property's value with <a href="qiconview.html#setItemTextPos">setItemTextPos</a>() and get this property's value with <a href="qiconview.html#itemTextPos">itemTextPos</a>(). +</doc> +</property> +<property> + <name>QIconView::itemsMovable</name> + <doc href="qiconview.html#itemsMovable-prop"> +<p>This property holds whether the user is allowed to move items around in the icon view. +<p>The default is TRUE. + +<p>Set this property's value with <a href="qiconview.html#setItemsMovable">setItemsMovable</a>() and get this property's value with <a href="qiconview.html#itemsMovable">itemsMovable</a>(). +</doc> +</property> +<property> + <name>QIconView::maxItemTextLength</name> + <doc href="qiconview.html#maxItemTextLength-prop"> +<p>This property holds the maximum length (in characters) that an item's text may have. +<p>The default is 255 characters. + +<p>Set this property's value with <a href="qiconview.html#setMaxItemTextLength">setMaxItemTextLength</a>() and get this property's value with <a href="qiconview.html#maxItemTextLength">maxItemTextLength</a>(). +</doc> +</property> +<property> + <name>QIconView::maxItemWidth</name> + <doc href="qiconview.html#maxItemWidth-prop"> +<p>This property holds the maximum width that an item may have. +<p>The default is 100 pixels. +<p> Note that if the <a href="qiconview.html#gridX">gridX</a>() value is set QIconView will ignore +this property. + +<p>Set this property's value with <a href="qiconview.html#setMaxItemWidth">setMaxItemWidth</a>() and get this property's value with <a href="qiconview.html#maxItemWidth">maxItemWidth</a>(). +</doc> +</property> +<property> + <name>QIconView::resizeMode</name> + <doc href="qiconview.html#resizeMode-prop"> +<p>This property holds the resize mode of the icon view. +<p>This can be <a href="qiconview.html#ResizeMode-enum">Fixed</a> or <a href="qiconview.html#ResizeMode-enum">Adjust</a>. The default is <a href="qiconview.html#ResizeMode-enum">Fixed</a>. +See <a href="qiconview.html#ResizeMode-enum">ResizeMode</a>. + +<p>Set this property's value with <a href="qiconview.html#setResizeMode">setResizeMode</a>() and get this property's value with <a href="qiconview.html#resizeMode">resizeMode</a>(). +</doc> +</property> +<property> + <name>QIconView::selectionMode</name> + <doc href="qiconview.html#selectionMode-prop"> +<p>This property holds the selection mode of the icon view. +<p>This can be <a href="qiconview.html#SelectionMode-enum">Single</a> (the default), <a href="qiconview.html#SelectionMode-enum">Extended</a>, <a href="qiconview.html#SelectionMode-enum">Multi</a> or <a href="qiconview.html#SelectionMode-enum">NoSelection</a>. + +<p>Set this property's value with <a href="qiconview.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qiconview.html#selectionMode">selectionMode</a>(). +</doc> +</property> +<property> + <name>QIconView::showToolTips</name> + <doc href="qiconview.html#showToolTips-prop"> +<p>This property holds whether the icon view will display a tool tip with the complete text for any truncated item text. +<p>The default is TRUE. Note that this has no effect if +<a href="qiconview.html#setWordWrapIconText">setWordWrapIconText</a>() is TRUE, as it is by default. + +<p>Set this property's value with <a href="qiconview.html#setShowToolTips">setShowToolTips</a>() and get this property's value with <a href="qiconview.html#showToolTips">showToolTips</a>(). +</doc> +</property> +<property> + <name>QIconView::sortDirection</name> + <doc href="qiconview.html#sortDirection-prop"> +<p>This property holds whether the sort direction for inserting new items is ascending;. +<p>The default is TRUE (i.e. ascending). This sort direction is only +meaningful if both <a href="qiconview.html#sorting">sorting</a>() and <a href="qiconview.html#autoArrange">autoArrange</a>() are TRUE. +<p> To set the sort direction, use <a href="qiconview.html#setSorting">setSorting</a>() + +<p>Get this property's value with <a href="qiconview.html#sortDirection">sortDirection</a>(). +</doc> +</property> +<property> + <name>QIconView::sorting</name> + <doc href="qiconview.html#sorting-prop"> +<p>This property holds whether the icon view sorts on insertion. +<p>The default is FALSE, i.e. no sorting on insertion. +<p> To set the sorting, use <a href="qiconview.html#setSorting">setSorting</a>(). + +<p>Get this property's value with <a href="qiconview.html#sorting">sorting</a>(). +</doc> +</property> +<property> + <name>QIconView::spacing</name> + <doc href="qiconview.html#spacing-prop"> +<p>This property holds the space in pixels between icon view items. +<p>The default is 5 pixels. +<p> Negative values for spacing are illegal. + +<p>Set this property's value with <a href="qiconview.html#setSpacing">setSpacing</a>() and get this property's value with <a href="qiconview.html#spacing">spacing</a>(). +</doc> +</property> +<property> + <name>QIconView::wordWrapIconText</name> + <doc href="qiconview.html#wordWrapIconText-prop"> +<p>This property holds whether the item text will be word-wrapped if it is too long. +<p>The default is TRUE. +<p> If this property is FALSE, icon text that is too long is +truncated, and an ellipsis (...) appended to indicate that +truncation has occurred. The full text can still be seen by the +user if they hover the mouse because the full text is shown in a +tooltip; see <a href="qiconview.html#setShowToolTips">setShowToolTips</a>(). + +<p>Set this property's value with <a href="qiconview.html#setWordWrapIconText">setWordWrapIconText</a>() and get this property's value with <a href="qiconview.html#wordWrapIconText">wordWrapIconText</a>(). +</doc> +</property> +<property> + <name>QIntValidator::bottom</name> + <doc href="qintvalidator.html#bottom-prop"> +<p>This property holds the validator's lowest acceptable value. +<p>Set this property's value with <a href="qintvalidator.html#setBottom">setBottom</a>() and get this property's value with <a href="qintvalidator.html#bottom">bottom</a>(). +<p><p>See also <a href="qintvalidator.html#setRange">setRange</a>(). + +</doc> +</property> +<property> + <name>QIntValidator::top</name> + <doc href="qintvalidator.html#top-prop"> +<p>This property holds the validator's highest acceptable value. +<p>Set this property's value with <a href="qintvalidator.html#setTop">setTop</a>() and get this property's value with <a href="qintvalidator.html#top">top</a>(). +<p><p>See also <a href="qintvalidator.html#setRange">setRange</a>(). + +</doc> +</property> +<property> + <name>QLCDNumber::intValue</name> + <doc href="qlcdnumber.html#intValue-prop"> +<p>This property holds the displayed value rounded to the nearest integer. +<p>This property corresponds to the nearest integer to the current +value displayed by the LCDNumber. This is the value used for +hexadecimal, octal and binary modes. +<p> If the displayed value is not a number, the property has a value +of 0. + +<p>Set this property's value with <a href="qlcdnumber.html#display">display</a>() and get this property's value with <a href="qlcdnumber.html#intValue">intValue</a>(). +</doc> +</property> +<property> + <name>QLCDNumber::mode</name> + <doc href="qlcdnumber.html#mode-prop"> +<p>This property holds the current display mode (number base). +<p>Corresponds to the current display mode, which is one of <a href="qlcdnumber.html#Mode-enum">BIN</a>, +<a href="qlcdnumber.html#Mode-enum">OCT</a>, <a href="qlcdnumber.html#Mode-enum">DEC</a> (the default) and <a href="qlcdnumber.html#Mode-enum">HEX</a>. <a href="qlcdnumber.html#Mode-enum">DEC</a> mode can display +floating point values, the other modes display the integer +equivalent. +<p> <p>See also <a href="qlcdnumber.html#smallDecimalPoint-prop">smallDecimalPoint</a>, <a href="qlcdnumber.html#setHexMode">setHexMode</a>(), <a href="qlcdnumber.html#setDecMode">setDecMode</a>(), <a href="qlcdnumber.html#setOctMode">setOctMode</a>(), and <a href="qlcdnumber.html#setBinMode">setBinMode</a>(). + +<p>Set this property's value with <a href="qlcdnumber.html#setMode">setMode</a>() and get this property's value with <a href="qlcdnumber.html#mode">mode</a>(). +</doc> +</property> +<property> + <name>QLCDNumber::numDigits</name> + <doc href="qlcdnumber.html#numDigits-prop"> +<p>This property holds the current number of digits displayed. +<p>Corresponds to the current number of digits. If <a href="qlcdnumber.html#smallDecimalPoint-prop">QLCDNumber::smallDecimalPoint</a> is FALSE, the decimal point occupies +one digit position. +<p> <p>See also <a href="qlcdnumber.html#smallDecimalPoint-prop">smallDecimalPoint</a>. + +<p>Set this property's value with <a href="qlcdnumber.html#setNumDigits">setNumDigits</a>() and get this property's value with <a href="qlcdnumber.html#numDigits">numDigits</a>(). +</doc> +</property> +<property> + <name>QLCDNumber::segmentStyle</name> + <doc href="qlcdnumber.html#segmentStyle-prop"> +<p>This property holds the style of the LCDNumber. +<p><center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Style <th valign="top">Result +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="qlcdnumber.html#SegmentStyle-enum">Outline</a> +<td valign="top">Produces raised segments filled with the background color +(this is the default). +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="qlcdnumber.html#SegmentStyle-enum">Filled</a> +<td valign="top">Produces raised segments filled with the foreground color. +<tr bgcolor="#f0f0f0"> <td valign="top"><a href="qlcdnumber.html#SegmentStyle-enum">Flat</a> +<td valign="top">Produces flat segments filled with the foreground color. +</table></center> +<p> <a href="qlcdnumber.html#SegmentStyle-enum">Outline</a> and <a href="qlcdnumber.html#SegmentStyle-enum">Filled</a> will additionally use +<a href="qcolorgroup.html#light">QColorGroup::light</a>() and <a href="qcolorgroup.html#dark">QColorGroup::dark</a>() for shadow effects. + +<p>Set this property's value with <a href="qlcdnumber.html#setSegmentStyle">setSegmentStyle</a>() and get this property's value with <a href="qlcdnumber.html#segmentStyle">segmentStyle</a>(). +</doc> +</property> +<property> + <name>QLCDNumber::smallDecimalPoint</name> + <doc href="qlcdnumber.html#smallDecimalPoint-prop"> +<p>This property holds the style of the decimal point. +<p>If TRUE the decimal point is drawn between two digit positions. +Otherwise it occupies a digit position of its own, i.e. is drawn +in a digit position. The default is FALSE. +<p> The inter-digit space is made slightly wider when the decimal +point is drawn between the digits. +<p> <p>See also <a href="qlcdnumber.html#mode-prop">mode</a>. + +<p>Set this property's value with <a href="qlcdnumber.html#setSmallDecimalPoint">setSmallDecimalPoint</a>() and get this property's value with <a href="qlcdnumber.html#smallDecimalPoint">smallDecimalPoint</a>(). +</doc> +</property> +<property> + <name>QLCDNumber::value</name> + <doc href="qlcdnumber.html#value-prop"> +<p>This property holds the displayed value. +<p>This property corresponds to the current value displayed by the +LCDNumber. +<p> If the displayed value is not a number, the property has a value +of 0. + +<p>Set this property's value with <a href="qlcdnumber.html#display">display</a>() and get this property's value with <a href="qlcdnumber.html#value">value</a>(). +</doc> +</property> +<property> + <name>QLabel::alignment</name> + <doc href="qlabel.html#alignment-prop"> +<p>This property holds the alignment of the label's contents. +<p>The alignment is a bitwise OR of <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a> and <a href="qt.html#TextFlags-enum">Qt::TextFlags</a> values. The <a href="qt.html#TextFlags-enum">ExpandTabs</a>, <a href="qt.html#TextFlags-enum">SingleLine</a> and <a href="qt.html#TextFlags-enum">ShowPrefix</a> flags apply only if the label contains plain text; +otherwise they are ignored. The <a href="qt.html#TextFlags-enum">DontClip</a> flag is always +ignored. <a href="qt.html#TextFlags-enum">WordBreak</a> applies to both rich text and plain text +labels. The <a href="qt.html#TextFlags-enum">BreakAnywhere</a> flag is not supported in QLabel. +<p> If the label has a buddy, the <a href="qt.html#TextFlags-enum">ShowPrefix</a> flag is forced to +TRUE. +<p> The default alignment is <tt>AlignAuto | AlignVCenter | ExpandTabs</tt> +if the label doesn't have a buddy and <tt>AlignAuto | AlignVCenter | ExpandTabs | ShowPrefix</tt> if the label has a buddy. If the label +contains rich text, additionally <a href="qt.html#TextFlags-enum">WordBreak</a> is turned on. +<p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>, <a href="qlabel.html#setBuddy">setBuddy</a>(), and <a href="qlabel.html#text-prop">text</a>. + +<p>Set this property's value with <a href="qlabel.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qlabel.html#alignment">alignment</a>(). +</doc> +</property> +<property> + <name>QLabel::indent</name> + <doc href="qlabel.html#indent-prop"> +<p>This property holds the label's text indent in pixels. +<p>If a label displays text, the indent applies to the left edge if +<a href="qlabel.html#alignment">alignment</a>() is <a href="qt.html#AlignmentFlags-enum">AlignLeft</a>, to the right edge if alignment() is +<a href="qt.html#AlignmentFlags-enum">AlignRight</a>, to the top edge if alignment() is <a href="qt.html#AlignmentFlags-enum">AlignTop</a>, and +to to the bottom edge if alignment() is <a href="qt.html#AlignmentFlags-enum">AlignBottom</a>. +<p> If indent is negative, or if no indent has been set, the label +computes the effective indent as follows: If <a href="qframe.html#frameWidth">frameWidth</a>() is 0, +the effective indent becomes 0. If frameWidth() is greater than 0, +the effective indent becomes half the width of the "x" character +of the widget's current <a href="qwidget.html#font">font</a>(). +<p> <p>See also <a href="qlabel.html#alignment-prop">alignment</a>, <a href="qframe.html#frameWidth-prop">frameWidth</a>, and <a href="qwidget.html#font-prop">font</a>. + +<p>Set this property's value with <a href="qlabel.html#setIndent">setIndent</a>() and get this property's value with <a href="qlabel.html#indent">indent</a>(). +</doc> +</property> +<property> + <name>QLabel::pixmap</name> + <doc href="qlabel.html#pixmap-prop"> +<p>This property holds the label's pixmap. +<p>If no pixmap has been set this will return an invalid pixmap. +<p> Setting the pixmap clears any previous content, and resizes the +label if <a href="qlabel.html#autoResize">QLabel::autoResize</a>() is TRUE. The buddy accelerator, +if any, is disabled. + +<p>Set this property's value with <a href="qlabel.html#setPixmap">setPixmap</a>() and get this property's value with <a href="qlabel.html#pixmap">pixmap</a>(). +</doc> +</property> +<property> + <name>QLabel::scaledContents</name> + <doc href="qlabel.html#scaledContents-prop"> +<p>This property holds whether the label will scale its contents to fill all available space. +<p>When enabled and the label shows a pixmap, it will scale the +pixmap to fill the available space. +<p> This property's default is FALSE. +<p> <p>See also <a href="qlabel.html#scaledContents-prop">scaledContents</a>. + +<p>Set this property's value with <a href="qlabel.html#setScaledContents">setScaledContents</a>() and get this property's value with <a href="qlabel.html#hasScaledContents">hasScaledContents</a>(). +</doc> +</property> +<property> + <name>QLabel::text</name> + <doc href="qlabel.html#text-prop"> +<p>This property holds the label's text. +<p>If no text has been set this will return an empty string. Setting +the text clears any previous content, unless they are the same. +<p> The text will be interpreted either as a plain text or as a rich +text, depending on the text format setting; see <a href="qlabel.html#setTextFormat">setTextFormat</a>(). +The default setting is <a href="qt.html#TextFormat-enum">AutoText</a>, i.e. QLabel will try to +auto-detect the format of the text set. +<p> If the text is interpreted as a plain text and a buddy has been +set, the buddy accelerator key is updated from the new text. +<p> The label resizes itself if auto-resizing is enabled. +<p> Note that Qlabel is well-suited to display small rich text +documents, i.e. those small documents that get their document +specific settings (font, text color, link color) from the label's +palette and font properties. For large documents, use <a href="qtextedit.html">QTextEdit</a> +in read-only mode instead. QTextEdit will flicker less on resize +and can also provide a scrollbar when necessary. +<p> <p>See also <a href="qlabel.html#textFormat-prop">textFormat</a>, <a href="qlabel.html#setBuddy">setBuddy</a>(), and <a href="qlabel.html#alignment-prop">alignment</a>. + +<p>Set this property's value with <a href="qlabel.html#setText">setText</a>() and get this property's value with <a href="qlabel.html#text">text</a>(). +</doc> +</property> +<property> + <name>QLabel::textFormat</name> + <doc href="qlabel.html#textFormat-prop"> +<p>This property holds the label's text format. +<p>See the <a href="qt.html#TextFormat-enum">Qt::TextFormat</a> enum for an explanation of the possible +options. +<p> The default format is <a href="qt.html#TextFormat-enum">AutoText</a>. +<p> <p>See also <a href="qlabel.html#text-prop">text</a>. + +<p>Set this property's value with <a href="qlabel.html#setTextFormat">setTextFormat</a>() and get this property's value with <a href="qlabel.html#textFormat">textFormat</a>(). +</doc> +</property> +<property> + <name>QLayout::margin</name> + <doc href="qlayout.html#margin-prop"> +<p>This property holds the width of the outside border of the layout. +<p>For some layout classes this property has an effect only on +top-level layouts; <a href="qboxlayout.html">QBoxLayout</a> and <a href="qgridlayout.html">QGridLayout</a> support margins for +child layouts. The default value is 0. +<p> <p>See also <a href="qlayout.html#spacing-prop">spacing</a>. + +<p>Set this property's value with <a href="qlayout.html#setMargin">setMargin</a>() and get this property's value with <a href="qlayout.html#margin">margin</a>(). +</doc> +</property> +<property> + <name>QLayout::resizeMode</name> + <doc href="qlayout.html#resizeMode-prop"> +<p>This property holds the resize mode of the layout. +<p>The default mode is <a href="qlayout.html#ResizeMode-enum">Auto</a>. +<p> <p>See also <a href="qlayout.html#ResizeMode-enum">QLayout::ResizeMode</a>. + +<p>Set this property's value with <a href="qlayout.html#setResizeMode">setResizeMode</a>() and get this property's value with <a href="qlayout.html#resizeMode">resizeMode</a>(). +</doc> +</property> +<property> + <name>QLayout::spacing</name> + <doc href="qlayout.html#spacing-prop"> +<p>This property holds the spacing between widgets inside the layout. +<p>The default value is -1, which signifies that the layout's spacing +should not override the widget's spacing. +<p> <p>See also <a href="qlayout.html#margin-prop">margin</a>. + +<p>Set this property's value with <a href="qlayout.html#setSpacing">setSpacing</a>() and get this property's value with <a href="qlayout.html#spacing">spacing</a>(). +</doc> +</property> +<property> + <name>QLineEdit::acceptableInput</name> + <doc href="qlineedit.html#acceptableInput-prop"> +<p>This property holds whether the input satisfies the inputMask and the validator. +<p>Get this property's value with <a href="qlineedit.html#hasAcceptableInput">hasAcceptableInput</a>(). +<p><p>See also <a href="qlineedit.html#inputMask-prop">inputMask</a> and <a href="qlineedit.html#setValidator">setValidator</a>(). + +</doc> +</property> +<property> + <name>QLineEdit::alignment</name> + <doc href="qlineedit.html#alignment-prop"> +<p>This property holds the alignment of the line edit. +<p>Possible Values are <a href="qt.html#AlignmentFlags-enum">Qt::AlignAuto</a>, <a href="qt.html#AlignmentFlags-enum">Qt::AlignLeft</a>, <a href="qt.html#AlignmentFlags-enum">Qt::AlignRight</a> and <a href="qt.html#AlignmentFlags-enum">Qt::AlignHCenter</a>. +<p> Attempting to set the alignment to an illegal flag combination +does nothing. +<p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>. + +<p>Set this property's value with <a href="qlineedit.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qlineedit.html#alignment">alignment</a>(). +</doc> +</property> +<property> + <name>QLineEdit::cursorPosition</name> + <doc href="qlineedit.html#cursorPosition-prop"> +<p>This property holds the current cursor position for this line edit. +<p>Setting the cursor position causes a repaint when appropriate. + +<p>Set this property's value with <a href="qlineedit.html#setCursorPosition">setCursorPosition</a>() and get this property's value with <a href="qlineedit.html#cursorPosition">cursorPosition</a>(). +</doc> +</property> +<property> + <name>QLineEdit::displayText</name> + <doc href="qlineedit.html#displayText-prop"> +<p>This property holds the displayed text. +<p>If <a href="qlineedit.html#EchoMode-enum">EchoMode</a> is <a href="qlineedit.html#EchoMode-enum">Normal</a> this returns the same as <a href="qlineedit.html#text">text</a>(); if +<a href="qlineedit.html#EchoMode-enum">EchoMode</a> is <a href="qlineedit.html#EchoMode-enum">Password</a> it returns a string of asterisks +text().length() characters long, e.g. "******"; if <a href="qlineedit.html#EchoMode-enum">EchoMode</a> is +<a href="qlineedit.html#EchoMode-enum">NoEcho</a> returns an empty string, "". +<p> <p>See also <a href="qlineedit.html#echoMode-prop">echoMode</a>, <a href="qlineedit.html#text-prop">text</a>, and <a href="qlineedit.html#EchoMode-enum">EchoMode</a>. + +<p>Get this property's value with <a href="qlineedit.html#displayText">displayText</a>(). +</doc> +</property> +<property> + <name>QLineEdit::dragEnabled</name> + <doc href="qlineedit.html#dragEnabled-prop"> +<p>This property holds whether the lineedit starts a drag if the user presses and moves the mouse on some selected text. +<p> +<p>Set this property's value with <a href="qlineedit.html#setDragEnabled">setDragEnabled</a>() and get this property's value with <a href="qlineedit.html#dragEnabled">dragEnabled</a>(). +</doc> +</property> +<property> + <name>QLineEdit::echoMode</name> + <doc href="qlineedit.html#echoMode-prop"> +<p>This property holds the line edit's echo mode. +<p>The initial setting is <a href="qlineedit.html#EchoMode-enum">Normal</a>, but QLineEdit also supports <a href="qlineedit.html#EchoMode-enum">NoEcho</a> and <a href="qlineedit.html#EchoMode-enum">Password</a> modes. +<p> The widget's display and the ability to copy or drag the text is +affected by this setting. +<p> <p>See also <a href="qlineedit.html#EchoMode-enum">EchoMode</a> and <a href="qlineedit.html#displayText-prop">displayText</a>. + +<p>Set this property's value with <a href="qlineedit.html#setEchoMode">setEchoMode</a>() and get this property's value with <a href="qlineedit.html#echoMode">echoMode</a>(). +</doc> +</property> +<property> + <name>QLineEdit::edited</name> + <doc href="qlineedit.html#edited-prop"> +<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> <p>This property holds whether the line edit has been edited. Use modified instead. +<p> +<p>Set this property's value with <a href="qlineedit.html#setEdited">setEdited</a>() and get this property's value with <a href="qlineedit.html#edited">edited</a>(). +</doc> +</property> +<property> + <name>QLineEdit::frame</name> + <doc href="qlineedit.html#frame-prop"> +<p>This property holds whether the line edit draws itself with a frame. +<p>If enabled (the default) the line edit draws itself inside a +two-pixel frame, otherwise the line edit draws itself without any +frame. + +<p>Set this property's value with <a href="qlineedit.html#setFrame">setFrame</a>() and get this property's value with <a href="qlineedit.html#frame">frame</a>(). +</doc> +</property> +<property> + <name>QLineEdit::hasMarkedText</name> + <doc href="qlineedit.html#hasMarkedText-prop"> +<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> <p>This property holds whether part of the text has been selected by the user. Use hasSelectedText instead. +<p> +<p>Get this property's value with <a href="qlineedit.html#hasMarkedText">hasMarkedText</a>(). +</doc> +</property> +<property> + <name>QLineEdit::hasSelectedText</name> + <doc href="qlineedit.html#hasSelectedText-prop"> +<p>This property holds whether there is any text selected. +<p>hasSelectedText() returns TRUE if some or all of the text has been +selected by the user; otherwise returns FALSE. +<p> <p>See also <a href="qlineedit.html#selectedText-prop">selectedText</a>. + +<p>Get this property's value with <a href="qlineedit.html#hasSelectedText">hasSelectedText</a>(). +</doc> +</property> +<property> + <name>QLineEdit::inputMask</name> + <doc href="qlineedit.html#inputMask-prop"> +<p>This property holds the validation input mask. +<p>If no mask is set, <a href="qlineedit.html#inputMask">inputMask</a>() returns <a href="qstring.html#QString-null">QString::null</a>. +<p> Sets the QLineEdit's validation mask. Validators can be used +instead of, or in conjunction with masks; see <a href="qlineedit.html#setValidator">setValidator</a>(). +<p> Unset the mask and return to normal QLineEdit operation by passing +an empty string ("") or just calling <a href="qlineedit.html#setInputMask">setInputMask</a>() with no +arguments. +<p> The mask format understands these mask characters: +<center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Character <th valign="top">Meaning +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>A</tt> <td valign="top">ASCII alphabetic character required. A-Z, a-z. +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>a</tt> <td valign="top">ASCII alphabetic character permitted but not required. +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>N</tt> <td valign="top">ASCII alphanumeric character required. A-Z, a-z, 0-9. +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>n</tt> <td valign="top">ASCII alphanumeric character permitted but not required. +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>X</tt> <td valign="top">Any character required. +<tr bgcolor="#d0d0d0"> <td valign="top"><a href="qwidget.html#x-prop">x</a> <td valign="top">Any character permitted but not required. +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>9</tt> <td valign="top">ASCII digit required. 0-9. +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>0</tt> <td valign="top">ASCII digit permitted but not required. +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>D</tt> <td valign="top">ASCII digit required. 1-9. +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>d</tt> <td valign="top">ASCII digit permitted but not required (1-9). +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>#</tt> <td valign="top">ASCII digit or plus/minus sign permitted but not required. +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>&gt;</tt> <td valign="top">All following alphabetic characters are uppercased. +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>&lt;</tt> <td valign="top">All following alphabetic characters are lowercased. +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>!</tt> <td valign="top">Switch off case conversion. +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>&#92;</tt> <td valign="top">Use <tt>&#92;</tt> to escape the special +characters listed above to use them as +separators. +</table></center> +<p> The mask consists of a string of mask characters and separators, +optionally followed by a semi-colon and the character used for +blanks: the blank characters are always removed from the text +after editing. The default blank character is space. +<p> Examples: +<center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">Mask <th valign="top">Notes +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>000.000.000.000;_</tt> <td valign="top">IP address; blanks are <tt>_</tt>. +<tr bgcolor="#f0f0f0"> <td valign="top"><tt>0000-00-00</tt> <td valign="top">ISO Date; blanks are <tt>space</tt> +<tr bgcolor="#d0d0d0"> <td valign="top"><tt>&gt;AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#</tt> <td valign="top">License number; +blanks are <tt>-</tt> and all (alphabetic) characters are converted to +uppercase. +</table></center> +<p> To get range control (e.g. for an IP address) use masks together +with <a href="qlineedit.html#setValidator">validators</a>. +<p> <p>See also <a href="qlineedit.html#maxLength-prop">maxLength</a>. + +<p>Set this property's value with <a href="qlineedit.html#setInputMask">setInputMask</a>() and get this property's value with <a href="qlineedit.html#inputMask">inputMask</a>(). +</doc> +</property> +<property> + <name>QLineEdit::markedText</name> + <doc href="qlineedit.html#markedText-prop"> +<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> <p>This property holds the text selected by the user. Use selectedText instead. +<p> +<p>Get this property's value with <a href="qlineedit.html#markedText">markedText</a>(). +</doc> +</property> +<property> + <name>QLineEdit::maxLength</name> + <doc href="qlineedit.html#maxLength-prop"> +<p>This property holds the maximum permitted length of the text. +<p>If the text is too long, it is truncated at the limit. +<p> If truncation occurs any selected text will be unselected, the +cursor position is set to 0 and the first part of the string is +shown. +<p> If the line edit has an input mask, the mask defines the maximum +string length. +<p> <p>See also <a href="qlineedit.html#inputMask-prop">inputMask</a>. + +<p>Set this property's value with <a href="qlineedit.html#setMaxLength">setMaxLength</a>() and get this property's value with <a href="qlineedit.html#maxLength">maxLength</a>(). +</doc> +</property> +<property> + <name>QLineEdit::modified</name> + <doc href="qlineedit.html#modified-prop"> +<p>This property holds whether the line edit's contents has been modified by the user. +<p>The modified flag is never read by QLineEdit; it has a default value +of FALSE and is changed to TRUE whenever the user changes the line +edit's contents. +<p> This is useful for things that need to provide a default value but +do not start out knowing what the default should be (perhaps it +depends on other fields on the form). Start the line edit without +the best default, and when the default is known, if modified() +returns FALSE (the user hasn't entered any text), insert the +default value. +<p> Calling <a href="qlineedit.html#clearModified">clearModified</a>() or <a href="qlineedit.html#setText">setText</a>() resets the modified flag to +FALSE. + +<p>Get this property's value with <a href="qlineedit.html#isModified">isModified</a>(). +</doc> +</property> +<property> + <name>QLineEdit::readOnly</name> + <doc href="qlineedit.html#readOnly-prop"> +<p>This property holds whether the line edit is read only. +<p>In read-only mode, the user can still copy the text to the +clipboard or drag-and-drop the text (if <a href="qlineedit.html#echoMode">echoMode</a>() is <a href="qlineedit.html#EchoMode-enum">Normal</a>), +but cannot edit it. +<p> QLineEdit does not show a cursor in read-only mode. +<p> <p>See also <a href="qwidget.html#enabled-prop">enabled</a>. + +<p>Set this property's value with <a href="qlineedit.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qlineedit.html#isReadOnly">isReadOnly</a>(). +</doc> +</property> +<property> + <name>QLineEdit::redoAvailable</name> + <doc href="qlineedit.html#redoAvailable-prop"> +<p>This property holds whether redo is available. +<p> +<p>Get this property's value with <a href="qlineedit.html#isRedoAvailable">isRedoAvailable</a>(). +</doc> +</property> +<property> + <name>QLineEdit::selectedText</name> + <doc href="qlineedit.html#selectedText-prop"> +<p>This property holds the selected text. +<p>If there is no selected text this property's value is +<a href="qstring.html#QString-null">QString::null</a>. +<p> <p>See also <a href="qlineedit.html#hasSelectedText-prop">hasSelectedText</a>. + +<p>Get this property's value with <a href="qlineedit.html#selectedText">selectedText</a>(). +</doc> +</property> +<property> + <name>QLineEdit::text</name> + <doc href="qlineedit.html#text-prop"> +<p>This property holds the line edit's text. +<p>Note that setting this property clears the selection, clears the +undo/redo history, moves the cursor to the end of the line and +resets the <a href="qlineedit.html#modified-prop">modified</a> property to FALSE. The text is not +validated when inserted with <a href="qlineedit.html#setText">setText</a>(). +<p> The text is truncated to <a href="qlineedit.html#maxLength">maxLength</a>() length. +<p> <p>See also <a href="qlineedit.html#insert">insert</a>(). + +<p>Set this property's value with <a href="qlineedit.html#setText">setText</a>() and get this property's value with <a href="qlineedit.html#text">text</a>(). +</doc> +</property> +<property> + <name>QLineEdit::undoAvailable</name> + <doc href="qlineedit.html#undoAvailable-prop"> +<p>This property holds whether undo is available. +<p> +<p>Get this property's value with <a href="qlineedit.html#isUndoAvailable">isUndoAvailable</a>(). +</doc> +</property> +<property> + <name>QListBox::columnMode</name> + <doc href="qlistbox.html#columnMode-prop"> +<p>This property holds the column layout mode for this list box. +<p>setColumnMode() sets the layout mode and adjusts the number of +displayed columns. The row layout mode automatically becomes <a href="qlistbox.html#LayoutMode-enum">Variable</a>, unless the column mode is <a href="qlistbox.html#LayoutMode-enum">Variable</a>. +<p> <p>See also <a href="qlistbox.html#rowMode-prop">rowMode</a>, <a href="qlistbox.html#rowMode-prop">rowMode</a>, and <a href="qlistbox.html#numColumns-prop">numColumns</a>. + +<p>Set this property's value with <a href="qlistbox.html#setColumnMode">setColumnMode</a>() and get this property's value with <a href="qlistbox.html#columnMode">columnMode</a>(). +</doc> +</property> +<property> + <name>QListBox::count</name> + <doc href="qlistbox.html#count-prop"> +<p>This property holds the number of items in the list box. +<p> +<p>Get this property's value with <a href="qlistbox.html#count">count</a>(). +</doc> +</property> +<property> + <name>QListBox::currentItem</name> + <doc href="qlistbox.html#currentItem-prop"> +<p>This property holds the current highlighted item. +<p>When setting this property, the highlighting is moved to the item +and the list box scrolled as necessary. +<p> If no item is current, <a href="qlistbox.html#currentItem">currentItem</a>() returns -1. + +<p>Set this property's value with <a href="qlistbox.html#setCurrentItem">setCurrentItem</a>() and get this property's value with <a href="qlistbox.html#currentItem">currentItem</a>(). +</doc> +</property> +<property> + <name>QListBox::currentText</name> + <doc href="qlistbox.html#currentText-prop"> +<p>This property holds the text of the current item. +<p>This is equivalent to <a href="qlistbox.html#text">text</a>(currentItem()). + +<p>Get this property's value with <a href="qlistbox.html#currentText">currentText</a>(). +</doc> +</property> +<property> + <name>QListBox::multiSelection</name> + <doc href="qlistbox.html#multiSelection-prop"> +<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> <p>This property holds whether or not the list box is in Multi selection mode. +<p>Consider using the <a href="qlistbox.html#selectionMode-prop">QListBox::selectionMode</a> property instead of +this property. +<p> When setting this property, Multi selection mode is used if set to TRUE and +to Single selection mode if set to FALSE. +<p> When getting this property, TRUE is returned if the list box is in +Multi selection mode or Extended selection mode, and FALSE if it is +in Single selection mode or NoSelection mode. +<p> <p>See also <a href="qlistbox.html#selectionMode-prop">selectionMode</a>. + +<p>Set this property's value with <a href="qlistbox.html#setMultiSelection">setMultiSelection</a>() and get this property's value with <a href="qlistbox.html#isMultiSelection">isMultiSelection</a>(). +</doc> +</property> +<property> + <name>QListBox::numColumns</name> + <doc href="qlistbox.html#numColumns-prop"> +<p>This property holds the number of columns in the list box. +<p>This is normally 1, but can be different if <a href="qlistbox.html#columnMode-prop">QListBox::columnMode</a> or <a href="qlistbox.html#rowMode-prop">QListBox::rowMode</a> has been set. +<p> <p>See also <a href="qlistbox.html#columnMode-prop">columnMode</a>, <a href="qlistbox.html#rowMode-prop">rowMode</a>, and <a href="qlistbox.html#numRows-prop">numRows</a>. + +<p>Get this property's value with <a href="qlistbox.html#numColumns">numColumns</a>(). +</doc> +</property> +<property> + <name>QListBox::numItemsVisible</name> + <doc href="qlistbox.html#numItemsVisible-prop"> +<p>This property holds the number of visible items. +<p>Both partially and entirely visible items are counted. + +<p>Get this property's value with <a href="qlistbox.html#numItemsVisible">numItemsVisible</a>(). +</doc> +</property> +<property> + <name>QListBox::numRows</name> + <doc href="qlistbox.html#numRows-prop"> +<p>This property holds the number of rows in the list box. +<p>This is equal to the number of items in the default single-column +layout, but can be different. +<p> <p>See also <a href="qlistbox.html#columnMode-prop">columnMode</a>, <a href="qlistbox.html#rowMode-prop">rowMode</a>, and <a href="qlistbox.html#numColumns-prop">numColumns</a>. + +<p>Get this property's value with <a href="qlistbox.html#numRows">numRows</a>(). +</doc> +</property> +<property> + <name>QListBox::rowMode</name> + <doc href="qlistbox.html#rowMode-prop"> +<p>This property holds the row layout mode for this list box. +<p>This property is normally <a href="qlistbox.html#LayoutMode-enum">Variable</a>. +<p> <a href="qlistbox.html#setRowMode">setRowMode</a>() sets the layout mode and adjusts the number of +displayed rows. The column layout mode automatically becomes <a href="qlistbox.html#LayoutMode-enum">Variable</a>, unless the row mode is <a href="qlistbox.html#LayoutMode-enum">Variable</a>. +<p> <p>See also <a href="qlistbox.html#columnMode-prop">columnMode</a>. + +<p>Set this property's value with <a href="qlistbox.html#setRowMode">setRowMode</a>() and get this property's value with <a href="qlistbox.html#rowMode">rowMode</a>(). +</doc> +</property> +<property> + <name>QListBox::selectionMode</name> + <doc href="qlistbox.html#selectionMode-prop"> +<p>This property holds the selection mode of the list box. +<p>Sets the list box's selection mode, which may be one of <a href="qlistbox.html#SelectionMode-enum">Single</a> +(the default), <a href="qlistbox.html#SelectionMode-enum">Extended</a>, <a href="qlistbox.html#SelectionMode-enum">Multi</a> or <a href="qlistbox.html#SelectionMode-enum">NoSelection</a>. +<p> <p>See also <a href="qlistbox.html#SelectionMode-enum">SelectionMode</a>. + +<p>Set this property's value with <a href="qlistbox.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qlistbox.html#selectionMode">selectionMode</a>(). +</doc> +</property> +<property> + <name>QListBox::topItem</name> + <doc href="qlistbox.html#topItem-prop"> +<p>This property holds the index of an item at the top of the screen. +<p>When getting this property and the listbox has multiple columns, +an arbitrary item is selected and returned. +<p> When setting this property, the list box is scrolled so the item +at position <em>index</em> in the list is displayed in the top row of +the list box. + +<p>Set this property's value with <a href="qlistbox.html#setTopItem">setTopItem</a>() and get this property's value with <a href="qlistbox.html#topItem">topItem</a>(). +</doc> +</property> +<property> + <name>QListBox::variableHeight</name> + <doc href="qlistbox.html#variableHeight-prop"> +<p>This property holds whether this list box has variable-height rows. +<p>When the list box has variable-height rows (the default), each row +is as high as the highest item in that row. When it has same-sized +rows, all rows are as high as the highest item in the list box. +<p> <p>See also <a href="qlistbox.html#variableWidth-prop">variableWidth</a>. + +<p>Set this property's value with <a href="qlistbox.html#setVariableHeight">setVariableHeight</a>() and get this property's value with <a href="qlistbox.html#variableHeight">variableHeight</a>(). +</doc> +</property> +<property> + <name>QListBox::variableWidth</name> + <doc href="qlistbox.html#variableWidth-prop"> +<p>This property holds whether this list box has variable-width columns. +<p>When the list box has variable-width columns, each column is as +wide as the widest item in that column. When it has same-sized +columns (the default), all columns are as wide as the widest item +in the list box. +<p> <p>See also <a href="qlistbox.html#variableHeight-prop">variableHeight</a>. + +<p>Set this property's value with <a href="qlistbox.html#setVariableWidth">setVariableWidth</a>() and get this property's value with <a href="qlistbox.html#variableWidth">variableWidth</a>(). +</doc> +</property> +<property> + <name>QListView::allColumnsShowFocus</name> + <doc href="qlistview.html#allColumnsShowFocus-prop"> +<p>This property holds whether items should show <a href="focus.html#keyboard-focus">keyboard focus</a> using all columns. +<p>If this property is TRUE all columns will show focus and selection +states, otherwise only column 0 will show focus. +<p> The default is FALSE. +<p> Setting this to TRUE if it's not necessary may cause noticeable +flicker. + +<p>Set this property's value with <a href="qlistview.html#setAllColumnsShowFocus">setAllColumnsShowFocus</a>() and get this property's value with <a href="qlistview.html#allColumnsShowFocus">allColumnsShowFocus</a>(). +</doc> +</property> +<property> + <name>QListView::childCount</name> + <doc href="qlistview.html#childCount-prop"> +<p>This property holds the number of parentless (top-level) <a href="qlistviewitem.html">QListViewItem</a> objects in this QListView. +<p>Holds the current number of parentless (top-level) QListViewItem +objects in this QListView. +<p> <p>See also <a href="qlistviewitem.html#childCount">QListViewItem::childCount</a>(). + +<p>Get this property's value with <a href="qlistview.html#childCount">childCount</a>(). +</doc> +</property> +<property> + <name>QListView::columns</name> + <doc href="qlistview.html#columns-prop"> +<p>This property holds the number of columns in this list view. +<p>Get this property's value with <a href="qlistview.html#columns">columns</a>(). +<p><p>See also <a href="qlistview.html#addColumn">addColumn</a>() and <a href="qlistview.html#removeColumn">removeColumn</a>(). + +</doc> +</property> +<property> + <name>QListView::defaultRenameAction</name> + <doc href="qlistview.html#defaultRenameAction-prop"> +<p>This property holds what action to perform when the editor loses focus during renaming. +<p>If this property is <a href="qlistview.html#RenameAction-enum">Accept</a>, and the user renames an item and +the editor loses focus (without the user pressing Enter), the +item will still be renamed. If the property's value is <a href="qlistview.html#RenameAction-enum">Reject</a>, +the item will not be renamed unless the user presses Enter. The +default is <a href="qlistview.html#RenameAction-enum">Reject</a>. + +<p>Set this property's value with <a href="qlistview.html#setDefaultRenameAction">setDefaultRenameAction</a>() and get this property's value with <a href="qlistview.html#defaultRenameAction">defaultRenameAction</a>(). +</doc> +</property> +<property> + <name>QListView::itemMargin</name> + <doc href="qlistview.html#itemMargin-prop"> +<p>This property holds the advisory item margin that list items may use. +<p>The item margin defaults to one pixel and is the margin between +the item's edges and the area where it draws its contents. +<a href="qlistviewitem.html#paintFocus">QListViewItem::paintFocus</a>() draws in the margin. +<p> <p>See also <a href="qlistviewitem.html#paintCell">QListViewItem::paintCell</a>(). + +<p>Set this property's value with <a href="qlistview.html#setItemMargin">setItemMargin</a>() and get this property's value with <a href="qlistview.html#itemMargin">itemMargin</a>(). +</doc> +</property> +<property> + <name>QListView::multiSelection</name> + <doc href="qlistview.html#multiSelection-prop"> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> <p>This property holds whether the list view is in multi-selection or extended-selection mode. +<p>If you enable multi-selection, <a href="qlistview.html#SelectionMode-enum">Multi</a>, mode, it is possible to +specify whether or not this mode should be extended. <a href="qlistview.html#SelectionMode-enum">Extended</a> +means that the user can select multiple items only when pressing +the Shift or Ctrl key at the same time. +<p> The default selection mode is <a href="qlistview.html#SelectionMode-enum">Single</a>. +<p> <p>See also <a href="qlistview.html#selectionMode-prop">selectionMode</a>. + +<p>Set this property's value with <a href="qlistview.html#setMultiSelection">setMultiSelection</a>() and get this property's value with <a href="qlistview.html#isMultiSelection">isMultiSelection</a>(). +</doc> +</property> +<property> + <name>QListView::resizeMode</name> + <doc href="qlistview.html#resizeMode-prop"> +<p>This property holds whether all, none or the only the last column should be resized. +<p>Specifies whether all, none or only the last column should be +resized to fit the full width of the list view. The values for this +property can be one of: <a href="qlistview.html#ResizeMode-enum">NoColumn</a> (the default), <a href="qlistview.html#ResizeMode-enum">AllColumns</a> +or <a href="qlistview.html#ResizeMode-enum">LastColumn</a>. +<p> <b>Warning:</b> Setting the resize mode should be done after all necessary +columns have been added to the list view, otherwise the behavior is +undefined. +<p> <p>See also <a href="qheader.html">QHeader</a> and <a href="qlistview.html#header">header</a>(). + +<p>Set this property's value with <a href="qlistview.html#setResizeMode">setResizeMode</a>() and get this property's value with <a href="qlistview.html#resizeMode">resizeMode</a>(). +</doc> +</property> +<property> + <name>QListView::rootIsDecorated</name> + <doc href="qlistview.html#rootIsDecorated-prop"> +<p>This property holds whether the list view shows open/close signs on root items. +<p>Open/close signs are small <b>+</b> or <b>-</b> symbols in windows +style, or arrows in <a href="motif-extension.html#Motif">Motif</a> style. The default is FALSE. + +<p>Set this property's value with <a href="qlistview.html#setRootIsDecorated">setRootIsDecorated</a>() and get this property's value with <a href="qlistview.html#rootIsDecorated">rootIsDecorated</a>(). +</doc> +</property> +<property> + <name>QListView::selectionMode</name> + <doc href="qlistview.html#selectionMode-prop"> +<p>This property holds the list view's selection mode. +<p>The mode can be <a href="qlistview.html#SelectionMode-enum">Single</a> (the default), <a href="qlistview.html#SelectionMode-enum">Extended</a>, <a href="qlistview.html#SelectionMode-enum">Multi</a> or +<a href="qlistview.html#SelectionMode-enum">NoSelection</a>. +<p> <p>See also <a href="qlistview.html#multiSelection-prop">multiSelection</a>. + +<p>Set this property's value with <a href="qlistview.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qlistview.html#selectionMode">selectionMode</a>(). +</doc> +</property> +<property> + <name>QListView::showSortIndicator</name> + <doc href="qlistview.html#showSortIndicator-prop"> +<p>This property holds whether the list view header should display a sort indicator. +<p>If this property is TRUE, an arrow is drawn in the header of the +list view to indicate the sort order of the list view contents. +The arrow will be drawn in the correct column and will point up or +down, depending on the current sort direction. The default is +FALSE (don't show an indicator). +<p> <p>See also <a href="qheader.html#setSortIndicator">QHeader::setSortIndicator</a>(). + +<p>Set this property's value with <a href="qlistview.html#setShowSortIndicator">setShowSortIndicator</a>() and get this property's value with <a href="qlistview.html#showSortIndicator">showSortIndicator</a>(). +</doc> +</property> +<property> + <name>QListView::showToolTips</name> + <doc href="qlistview.html#showToolTips-prop"> +<p>This property holds whether this list view should show tooltips for truncated column texts. +<p>The default is TRUE. + +<p>Set this property's value with <a href="qlistview.html#setShowToolTips">setShowToolTips</a>() and get this property's value with <a href="qlistview.html#showToolTips">showToolTips</a>(). +</doc> +</property> +<property> + <name>QListView::treeStepSize</name> + <doc href="qlistview.html#treeStepSize-prop"> +<p>This property holds the number of pixels a child is offset from its parent. +<p>The default is 20 pixels. +<p> Of course, this property is only meaningful for hierarchical list +views. + +<p>Set this property's value with <a href="qlistview.html#setTreeStepSize">setTreeStepSize</a>() and get this property's value with <a href="qlistview.html#treeStepSize">treeStepSize</a>(). +</doc> +</property> +<property> + <name>QMainWindow::dockWindowsMovable</name> + <doc href="qmainwindow.html#dockWindowsMovable-prop"> +<p>This property holds whether the dock windows are movable. +<p>If TRUE (the default), the user will be able to move movable dock +windows from one QMainWindow dock area to another, including the +<tt>TearOff</tt> area (i.e. where the dock window floats freely as a +window in its own right), and the <a href="qt.html#Dock-enum">Minimized</a> area (where only +the dock window's handle is shown below the menu bar). Moveable +dock windows can also be moved within QMainWindow dock areas, i.e. +to rearrange them within a dock area. +<p> If FALSE the user will not be able to move any dock windows. +<p> By default dock windows are moved transparently (i.e. only an +outline rectangle is shown during the drag), but this setting can +be changed with <a href="qmainwindow.html#setOpaqueMoving">setOpaqueMoving</a>(). +<p> <p>See also <a href="qmainwindow.html#setDockEnabled">setDockEnabled</a>() and <a href="qmainwindow.html#opaqueMoving-prop">opaqueMoving</a>. + +<p>Set this property's value with <a href="qmainwindow.html#setDockWindowsMovable">setDockWindowsMovable</a>() and get this property's value with <a href="qmainwindow.html#dockWindowsMovable">dockWindowsMovable</a>(). +</doc> +</property> +<property> + <name>QMainWindow::opaqueMoving</name> + <doc href="qmainwindow.html#opaqueMoving-prop"> +<p>This property holds whether dock windows are moved opaquely. +<p>If TRUE the dock windows of the main window are shown opaquely +(i.e. it shows the toolbar as it looks when docked) whilst it is +being moved. If FALSE (the default) they are shown transparently, +(i.e. as an outline rectangle). +<p> <b>Warning:</b> Opaque moving of toolbars and dockwindows is known to +have several problems. We recommend avoiding the use of this +feature for the time being. We intend fixing the problems in a +future release. + +<p>Set this property's value with <a href="qmainwindow.html#setOpaqueMoving">setOpaqueMoving</a>() and get this property's value with <a href="qmainwindow.html#opaqueMoving">opaqueMoving</a>(). +</doc> +</property> +<property> + <name>QMainWindow::rightJustification</name> + <doc href="qmainwindow.html#rightJustification-prop"> +<b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> <p>This property holds whether the main window right-justifies its dock windows. +<p>If disabled (the default), stretchable dock windows are expanded, +and non-stretchable dock windows are given the minimum space they +need. Since most dock windows are not stretchable, this usually +results in an unjustified right edge (or unjustified bottom edge +for a vertical dock area). If enabled, the main window will +right-justify its dock windows. +<p> <p>See also <a href="qdockwindow.html#setVerticalStretchable">QDockWindow::setVerticalStretchable</a>() and <a href="qdockwindow.html#setHorizontalStretchable">QDockWindow::setHorizontalStretchable</a>(). + +<p>Set this property's value with <a href="qmainwindow.html#setRightJustification">setRightJustification</a>() and get this property's value with <a href="qmainwindow.html#rightJustification">rightJustification</a>(). +</doc> +</property> +<property> + <name>QMainWindow::usesBigPixmaps</name> + <doc href="qmainwindow.html#usesBigPixmaps-prop"> +<p>This property holds whether big pixmaps are enabled. +<p>If FALSE (the default), the tool buttons will use small pixmaps; +otherwise big pixmaps will be used. +<p> Tool buttons and other widgets that wish to respond to this +setting are responsible for reading the correct state on startup, +and for connecting to the main window's widget's +<a href="qmainwindow.html#pixmapSizeChanged">pixmapSizeChanged</a>() signal. + +<p>Set this property's value with <a href="qmainwindow.html#setUsesBigPixmaps">setUsesBigPixmaps</a>() and get this property's value with <a href="qmainwindow.html#usesBigPixmaps">usesBigPixmaps</a>(). +</doc> +</property> +<property> + <name>QMainWindow::usesTextLabel</name> + <doc href="qmainwindow.html#usesTextLabel-prop"> +<p>This property holds whether text labels for toolbar buttons are enabled. +<p>If disabled (the default), the tool buttons will not use text +labels. If enabled, text labels will be used. +<p> Tool buttons and other widgets that wish to respond to this +setting are responsible for reading the correct state on startup, +and for connecting to the main window's widget's +<a href="qmainwindow.html#usesTextLabelChanged">usesTextLabelChanged</a>() signal. +<p> <p>See also <a href="qtoolbutton.html#usesTextLabel-prop">QToolButton::usesTextLabel</a>. + +<p>Set this property's value with <a href="qmainwindow.html#setUsesTextLabel">setUsesTextLabel</a>() and get this property's value with <a href="qmainwindow.html#usesTextLabel">usesTextLabel</a>(). +</doc> +</property> +<property> + <name>QMenuBar::defaultUp</name> + <doc href="qmenubar.html#defaultUp-prop"> +<p>This property holds the popup orientation. +<p>The default popup orientation. By default, menus pop "down" the +screen. By setting the property to TRUE, the menu will pop "up". +You might call this for menus that are <em>below</em> the document to +which they refer. +<p> If the menu would not fit on the screen, the other direction is +used automatically. + +<p>Set this property's value with <a href="qmenubar.html#setDefaultUp">setDefaultUp</a>() and get this property's value with <a href="qmenubar.html#isDefaultUp">isDefaultUp</a>(). +</doc> +</property> +<property> + <name>QMenuBar::separator</name> + <doc href="qmenubar.html#separator-prop"> +<p>This property holds in which cases a menubar sparator is drawn. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> +<p>Set this property's value with <a href="qmenubar.html#setSeparator">setSeparator</a>() and get this property's value with <a href="qmenubar.html#separator">separator</a>(). +</doc> +</property> +<property> + <name>QMessageBox::icon</name> + <doc href="qmessagebox.html#icon-prop"> +<p>This property holds the message box's icon. +<p>The icon of the message box can be one of the following predefined +icons: +<ul> +<li> QMessageBox::NoIcon +<li> QMessageBox::Question +<li> QMessageBox::Information +<li> QMessageBox::Warning +<li> QMessageBox::Critical +</ul> +<p> The actual pixmap used for displaying the icon depends on the +current <a href="qwidget.html#style">GUI style</a>. You can also set +a custom pixmap icon using the <a href="qmessagebox.html#iconPixmap-prop">QMessageBox::iconPixmap</a> +property. The default icon is QMessageBox::NoIcon. +<p> <p>See also <a href="qmessagebox.html#iconPixmap-prop">iconPixmap</a>. + +<p>Set this property's value with <a href="qmessagebox.html#setIcon">setIcon</a>() and get this property's value with <a href="qmessagebox.html#icon">icon</a>(). +</doc> +</property> +<property> + <name>QMessageBox::iconPixmap</name> + <doc href="qmessagebox.html#iconPixmap-prop"> +<p>This property holds the current icon. +<p>The icon currently used by the message box. Note that it's often +hard to draw one pixmap that looks appropriate in both <a href="motif-extension.html#Motif">Motif</a> and +Windows GUI styles; you may want to draw two pixmaps. +<p> <p>See also <a href="qmessagebox.html#icon-prop">icon</a>. + +<p>Set this property's value with <a href="qmessagebox.html#setIconPixmap">setIconPixmap</a>() and get this property's value with <a href="qmessagebox.html#iconPixmap">iconPixmap</a>(). +</doc> +</property> +<property> + <name>QMessageBox::text</name> + <doc href="qmessagebox.html#text-prop"> +<p>This property holds the message box text to be displayed. +<p>The text will be interpreted either as a plain text or as rich +text, depending on the text format setting (<a href="qmessagebox.html#textFormat-prop">QMessageBox::textFormat</a>). The default setting is <a href="qt.html#TextFormat-enum">AutoText</a>, i.e. +the message box will try to auto-detect the format of the text. +<p> The default value of this property is <a href="qstring.html#QString-null">QString::null</a>. +<p> <p>See also <a href="qmessagebox.html#textFormat-prop">textFormat</a>. + +<p>Set this property's value with <a href="qmessagebox.html#setText">setText</a>() and get this property's value with <a href="qmessagebox.html#text">text</a>(). +</doc> +</property> +<property> + <name>QMessageBox::textFormat</name> + <doc href="qmessagebox.html#textFormat-prop"> +<p>This property holds the format of the text displayed by the message box. +<p>The current text format used by the message box. See the <a href="qt.html#TextFormat-enum">Qt::TextFormat</a> enum for an explanation of the possible options. +<p> The default format is <a href="qt.html#TextFormat-enum">AutoText</a>. +<p> <p>See also <a href="qmessagebox.html#text-prop">text</a>. + +<p>Set this property's value with <a href="qmessagebox.html#setTextFormat">setTextFormat</a>() and get this property's value with <a href="qmessagebox.html#textFormat">textFormat</a>(). +</doc> +</property> +<property> + <name>QMultiLineEdit::alignment</name> + <doc href="qmultilineedit.html#alignment-prop"> <p>This property holds the editor's paragraph alignment. +<p>Sets the alignment to flag, which must be <a href="qt.html#AlignmentFlags-enum">AlignLeft</a>, <a href="qt.html#AlignmentFlags-enum">AlignHCenter</a> or <a href="qt.html#AlignmentFlags-enum">AlignRight</a>. +<p> If flag is an illegal flag nothing happens. +<p> <p>See also <a href="qt.html#AlignmentFlags-enum">Qt::AlignmentFlags</a>. + +<p>Set this property's value with <a href="qmultilineedit.html#setAlignment">setAlignment</a>() and get this property's value with <a href="qmultilineedit.html#alignment">alignment</a>(). +</doc> +</property> +<property> + <name>QMultiLineEdit::atBeginning</name> + <doc href="qmultilineedit.html#atBeginning-prop"> <p>This property holds whether the cursor is placed at the beginning of the text. +<p>Get this property's value with <a href="qmultilineedit.html#atBeginning">atBeginning</a>(). +<p><p>See also <a href="qmultilineedit.html#atEnd-prop">atEnd</a>. + +</doc> +</property> +<property> + <name>QMultiLineEdit::atEnd</name> + <doc href="qmultilineedit.html#atEnd-prop"> <p>This property holds whether the cursor is placed at the end of the text. +<p>Get this property's value with <a href="qmultilineedit.html#atEnd">atEnd</a>(). +<p><p>See also <a href="qmultilineedit.html#atBeginning-prop">atBeginning</a>. + +</doc> +</property> +<property> + <name>QMultiLineEdit::edited</name> + <doc href="qmultilineedit.html#edited-prop"> <p>This property holds whether the document has been edited by the user. +<p>This is the same as <a href="qtextedit.html">QTextEdit</a>'s "modifed" property. +<p> <p>See also <a href="qtextedit.html#modified-prop">QTextEdit::modified</a>. + +<p>Set this property's value with <a href="qmultilineedit.html#setEdited">setEdited</a>() and get this property's value with <a href="qmultilineedit.html#edited">edited</a>(). +</doc> +</property> +<property> + <name>QMultiLineEdit::numLines</name> + <doc href="qmultilineedit.html#numLines-prop"> <p>This property holds the number of paragraphs in the editor. +<p>The count includes any empty paragraph at top and bottom, so for an +empty editor this method returns 1. + +<p>Get this property's value with <a href="qmultilineedit.html#numLines">numLines</a>(). +</doc> +</property> +<property> + <name>QObject::name</name> + <doc href="qobject.html#name-prop"> +<p>This property holds the name of this object. +<p>You can find an object by name (and type) using <a href="qobject.html#child">child</a>(). You can +find a set of objects with <a href="qobject.html#queryList">queryList</a>(). +<p> The object name is set by the constructor or by the <a href="qobject.html#setName">setName</a>() +function. The object name is not very useful in the current +version of Qt, but will become increasingly important in the +future. +<p> If the object does not have a name, the <a href="qobject.html#name">name</a>() function returns +"unnamed", so printf() (used in <a href="qapplication.html#qDebug">qDebug</a>()) will not be asked to +output a null pointer. If you want a null pointer to be returned +for unnamed objects, you can call name( 0 ). +<p> <pre> + <a href="qapplication.html#qDebug">qDebug</a>( "MyClass::setPrecision(): (%s) invalid precision %f", + <a href="qobject.html#name">name</a>(), newPrecision ); + </pre> + +<p> <p>See also <a href="qobject.html#className">className</a>(), <a href="qobject.html#child">child</a>(), and <a href="qobject.html#queryList">queryList</a>(). + +<p>Set this property's value with <a href="qobject.html#setName">setName</a>() and get this property's value with <a href="qobject.html#name">name</a>(). +</doc> +</property> +<property> + <name>QPopupMenu::checkable</name> + <doc href="qpopupmenu.html#checkable-prop"> +<p>This property holds whether the display of check marks on menu items is enabled. +<p>When TRUE, the display of check marks on menu items is enabled. +Checking is always enabled when in Windows-style. +<p> <p>See also <a href="qmenudata.html#setItemChecked">QMenuData::setItemChecked</a>(). + +<p>Set this property's value with <a href="qpopupmenu.html#setCheckable">setCheckable</a>() and get this property's value with <a href="qpopupmenu.html#isCheckable">isCheckable</a>(). +</doc> +</property> +<property> + <name>QProgressBar::centerIndicator</name> + <doc href="qprogressbar.html#centerIndicator-prop"> +<p>This property holds whether the indicator string should be centered. +<p>Changing this property sets <a href="qprogressbar.html#indicatorFollowsStyle-prop">QProgressBar::indicatorFollowsStyle</a> +to FALSE. The default is TRUE. + +<p>Set this property's value with <a href="qprogressbar.html#setCenterIndicator">setCenterIndicator</a>() and get this property's value with <a href="qprogressbar.html#centerIndicator">centerIndicator</a>(). +</doc> +</property> +<property> + <name>QProgressBar::indicatorFollowsStyle</name> + <doc href="qprogressbar.html#indicatorFollowsStyle-prop"> +<p>This property holds whether the display of the indicator string should follow the GUI style. +<p>The default is TRUE. +<p> <p>See also <a href="qprogressbar.html#centerIndicator-prop">centerIndicator</a>. + +<p>Set this property's value with <a href="qprogressbar.html#setIndicatorFollowsStyle">setIndicatorFollowsStyle</a>() and get this property's value with <a href="qprogressbar.html#indicatorFollowsStyle">indicatorFollowsStyle</a>(). +</doc> +</property> +<property> + <name>QProgressBar::percentageVisible</name> + <doc href="qprogressbar.html#percentageVisible-prop"> +<p>This property holds whether the current progress value is displayed. +<p>The default is TRUE. +<p> <p>See also <a href="qprogressbar.html#centerIndicator-prop">centerIndicator</a> and <a href="qprogressbar.html#indicatorFollowsStyle-prop">indicatorFollowsStyle</a>. + +<p>Set this property's value with <a href="qprogressbar.html#setPercentageVisible">setPercentageVisible</a>() and get this property's value with <a href="qprogressbar.html#percentageVisible">percentageVisible</a>(). +</doc> +</property> +<property> + <name>QProgressBar::progress</name> + <doc href="qprogressbar.html#progress-prop"> +<p>This property holds the current amount of progress. +<p>This property is -1 if progress counting has not started. + +<p>Set this property's value with <a href="qprogressbar.html#setProgress">setProgress</a>() and get this property's value with <a href="qprogressbar.html#progress">progress</a>(). +</doc> +</property> +<property> + <name>QProgressBar::progressString</name> + <doc href="qprogressbar.html#progressString-prop"> +<p>This property holds the amount of progress as a string. +<p>This property is <a href="qstring.html#QString-null">QString::null</a> if progress counting has not started. + +<p>Get this property's value with <a href="qprogressbar.html#progressString">progressString</a>(). +</doc> +</property> +<property> + <name>QProgressBar::totalSteps</name> + <doc href="qprogressbar.html#totalSteps-prop"> +<p>This property holds the total number of steps. +<p>If totalSteps is 0, the progress bar will display a busy +indicator. +<p> <p>See also +<p>Set this property's value with <a href="qprogressbar.html#setTotalSteps">setTotalSteps</a>() and get this property's value with <a href="qprogressbar.html#totalSteps">totalSteps</a>(). +</doc> +</property> +<property> + <name>QProgressDialog::autoClose</name> + <doc href="qprogressdialog.html#autoClose-prop"> +<p>This property holds whether the dialog gets hidden by <a href="qprogressdialog.html#reset">reset</a>(). +<p>The default is TRUE. +<p> <p>See also <a href="qprogressdialog.html#autoReset-prop">autoReset</a>. + +<p>Set this property's value with <a href="qprogressdialog.html#setAutoClose">setAutoClose</a>() and get this property's value with <a href="qprogressdialog.html#autoClose">autoClose</a>(). +</doc> +</property> +<property> + <name>QProgressDialog::autoReset</name> + <doc href="qprogressdialog.html#autoReset-prop"> +<p>This property holds whether the progress dialog calls <a href="qprogressdialog.html#reset">reset</a>() as soon as <a href="qprogressdialog.html#progress">progress</a>() equals <a href="qprogressdialog.html#totalSteps">totalSteps</a>(). +<p>The default is TRUE. +<p> <p>See also <a href="qprogressdialog.html#autoClose-prop">autoClose</a>. + +<p>Set this property's value with <a href="qprogressdialog.html#setAutoReset">setAutoReset</a>() and get this property's value with <a href="qprogressdialog.html#autoReset">autoReset</a>(). +</doc> +</property> +<property> + <name>QProgressDialog::labelText</name> + <doc href="qprogressdialog.html#labelText-prop"> +<p>This property holds the label's text. +<p>The default text is <a href="qstring.html#QString-null">QString::null</a>. + +<p>Set this property's value with <a href="qprogressdialog.html#setLabelText">setLabelText</a>() and get this property's value with <a href="qprogressdialog.html#labelText">labelText</a>(). +</doc> +</property> +<property> + <name>QProgressDialog::minimumDuration</name> + <doc href="qprogressdialog.html#minimumDuration-prop"> +<p>This property holds the time that must pass before the dialog appears. +<p>If the expected duration of the task is less than the +minimumDuration, the dialog will not appear at all. This prevents +the dialog popping up for tasks that are quickly over. For tasks +that are expected to exceed the minimumDuration, the dialog will +pop up after the minimumDuration time or as soon as any progress +is set. +<p> If set to 0, the dialog is always shown as soon as any progress is +set. The default is 4000 milliseconds. + +<p>Set this property's value with <a href="qprogressdialog.html#setMinimumDuration">setMinimumDuration</a>() and get this property's value with <a href="qprogressdialog.html#minimumDuration">minimumDuration</a>(). +</doc> +</property> +<property> + <name>QProgressDialog::progress</name> + <doc href="qprogressdialog.html#progress-prop"> +<p>This property holds the current amount of progress made. +<p>For the progress dialog to work as expected, you should initially set +this property to 0 and finally set it to +<a href="qprogressdialog.html#totalSteps">QProgressDialog::totalSteps</a>(); you can call <a href="qprogressdialog.html#setProgress">setProgress</a>() any number of times +in-between. +<p> <b>Warning:</b> If the progress dialog is modal +(see <a href="qprogressdialog.html#QProgressDialog">QProgressDialog::QProgressDialog</a>()), +this function calls <a href="qapplication.html#processEvents">QApplication::processEvents</a>(), so take care that +this does not cause undesirable re-entrancy in your code. For example, +don't use a QProgressDialog inside a <a href="qwidget.html#paintEvent">paintEvent</a>()! +<p> <p>See also <a href="qprogressdialog.html#totalSteps-prop">totalSteps</a>. + +<p>Set this property's value with <a href="qprogressdialog.html#setProgress">setProgress</a>() and get this property's value with <a href="qprogressdialog.html#progress">progress</a>(). +</doc> +</property> +<property> + <name>QProgressDialog::totalSteps</name> + <doc href="qprogressdialog.html#totalSteps-prop"> +<p>This property holds the total number of steps. +<p>The default is 0. + +<p>Set this property's value with <a href="qprogressdialog.html#setTotalSteps">setTotalSteps</a>() and get this property's value with <a href="qprogressdialog.html#totalSteps">totalSteps</a>(). +</doc> +</property> +<property> + <name>QProgressDialog::wasCanceled</name> + <doc href="qprogressdialog.html#wasCanceled-prop"> +<p>This property holds whether the dialog was canceled. +<p>Get this property's value with <a href="qprogressdialog.html#wasCanceled">wasCanceled</a>(). +<p><p>See also <a href="qprogressdialog.html#progress-prop">progress</a>. + +</doc> +</property> +<property> + <name>QProgressDialog::wasCancelled</name> + <doc href="qprogressdialog.html#wasCancelled-prop"> +<p>This property holds whether the dialog was canceled. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> Use <a href="qprogressdialog.html#wasCanceled-prop">wasCanceled</a> instead. + +<p>Get this property's value with <a href="qprogressdialog.html#wasCancelled">wasCancelled</a>(). +</doc> +</property> +<property> + <name>QPushButton::autoDefault</name> + <doc href="qpushbutton.html#autoDefault-prop"> +<p>This property holds whether the push button is the auto default button. +<p>If this property is set to TRUE then the push button is the auto +default button in a dialog. +<p> 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 +space free around auto-default buttons, i.e. auto-default buttons +may have a slightly larger size hint. +<p> This property's default is TRUE for buttons that have a <a href="qdialog.html">QDialog</a> +parent; otherwise it defaults to FALSE. +<p> See the <a href="qpushbutton.html#default-prop">default</a> property for details of how <a href="qpushbutton.html#default-prop">default</a> and +auto-default interact. + +<p>Set this property's value with <a href="qpushbutton.html#setAutoDefault">setAutoDefault</a>() and get this property's value with <a href="qpushbutton.html#autoDefault">autoDefault</a>(). +</doc> +</property> +<property> + <name>QPushButton::default</name> + <doc href="qpushbutton.html#default-prop"> +<p>This property holds whether the push button is the default button. +<p>If this property is set to TRUE then the push button will be +pressed if the user presses the Enter (or Return) key in a dialog. +<p> Regardless of focus, if the user presses Enter: If there is a +default button the default button is pressed; otherwise, if +there are one or more <a href="qpushbutton.html#autoDefault-prop">autoDefault</a> buttons the first <a href="qpushbutton.html#autoDefault-prop">autoDefault</a> +button that is next in the tab order is pressed. If there are no +default or <a href="qpushbutton.html#autoDefault-prop">autoDefault</a> buttons only pressing Space on a button +with focus, mouse clicking, or using an accelerator will press a +button. +<p> In a dialog, only one push button at a time can be the default +button. This button is then displayed with an additional frame +(depending on the GUI style). +<p> The default button behavior is provided only in dialogs. Buttons +can always be clicked from the keyboard by pressing Enter (or +Return) or the Spacebar when the button has focus. +<p> This property's default is FALSE. + +<p>Set this property's value with <a href="qpushbutton.html#setDefault">setDefault</a>() and get this property's value with <a href="qpushbutton.html#isDefault">isDefault</a>(). +</doc> +</property> +<property> + <name>QPushButton::flat</name> + <doc href="qpushbutton.html#flat-prop"> +<p>This property holds whether the border is disabled. +<p>This property's default is FALSE. + +<p>Set this property's value with <a href="qpushbutton.html#setFlat">setFlat</a>() and get this property's value with <a href="qpushbutton.html#isFlat">isFlat</a>(). +</doc> +</property> +<property> + <name>QPushButton::iconSet</name> + <doc href="qpushbutton.html#iconSet-prop"> +<p>This property holds the icon set on the push button. +<p>This property will return 0 if the push button has no iconset. + +<p>Set this property's value with <a href="qpushbutton.html#setIconSet">setIconSet</a>() and get this property's value with <a href="qpushbutton.html#iconSet">iconSet</a>(). +</doc> +</property> +<property> + <name>QPushButton::menuButton</name> + <doc href="qpushbutton.html#menuButton-prop"> <p>This property holds whether the push button has a menu button on it. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> If this property is set to TRUE, then a down arrow is drawn on the push +button to indicate that a menu will pop up if the user clicks on the +arrow. + +<p>Get this property's value with <a href="qpushbutton.html#isMenuButton">isMenuButton</a>(). +</doc> +</property> +<property> + <name>QRadioButton::checked</name> + <doc href="qradiobutton.html#checked-prop"> +<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="qradiobutton.html#setChecked">setChecked</a>() and get this property's value with <a href="qradiobutton.html#isChecked">isChecked</a>(). +</doc> +</property> +<property> + <name>QScrollBar::draggingSlider</name> + <doc href="qscrollbar.html#draggingSlider-prop"> +<p>This property holds whether the user has clicked the mouse on the slider and is currently dragging it. +<p> +<p>Get this property's value with <a href="qscrollbar.html#draggingSlider">draggingSlider</a>(). +</doc> +</property> +<property> + <name>QScrollBar::lineStep</name> + <doc href="qscrollbar.html#lineStep-prop"> +<p>This property holds the line step. +<p>When setting lineStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be +called if the new line step is different from the previous +setting. +<p> <p>See also <a href="qrangecontrol.html#setSteps">setSteps</a>(), <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>(), and <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qscrollbar.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qscrollbar.html#lineStep">lineStep</a>(). +</doc> +</property> +<property> + <name>QScrollBar::maxValue</name> + <doc href="qscrollbar.html#maxValue-prop"> +<p>This property holds the scroll bar's maximum value. +<p>When setting this property, the <a href="qscrollbar.html#minValue-prop">QScrollBar::minValue</a> is +adjusted if necessary to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qscrollbar.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qscrollbar.html#maxValue">maxValue</a>(). +</doc> +</property> +<property> + <name>QScrollBar::minValue</name> + <doc href="qscrollbar.html#minValue-prop"> +<p>This property holds the scroll bar's minimum value. +<p>When setting this property, the <a href="qscrollbar.html#maxValue-prop">QScrollBar::maxValue</a> is +adjusted if necessary to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qscrollbar.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qscrollbar.html#minValue">minValue</a>(). +</doc> +</property> +<property> + <name>QScrollBar::orientation</name> + <doc href="qscrollbar.html#orientation-prop"> +<p>This property holds the orientation of the scroll bar. +<p>The orientation must be <a href="qt.html#Orientation-enum">Qt::Vertical</a> (the default) or <a href="qt.html#Orientation-enum">Qt::Horizontal</a>. + +<p>Set this property's value with <a href="qscrollbar.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qscrollbar.html#orientation">orientation</a>(). +</doc> +</property> +<property> + <name>QScrollBar::pageStep</name> + <doc href="qscrollbar.html#pageStep-prop"> +<p>This property holds the page step. +<p>When setting pageStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be +called if the new page step is different from the previous +setting. +<p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>(), <a href="qscrollbar.html#lineStep-prop">lineStep</a>, and <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qscrollbar.html#setPageStep">setPageStep</a>() and get this property's value with <a href="qscrollbar.html#pageStep">pageStep</a>(). +</doc> +</property> +<property> + <name>QScrollBar::tracking</name> + <doc href="qscrollbar.html#tracking-prop"> +<p>This property holds whether scroll bar tracking is enabled. +<p>If tracking is enabled (the default), the scroll bar emits the +<a href="qscrollbar.html#valueChanged">valueChanged</a>() signal while the slider is being dragged. If +tracking is disabled, the scroll bar emits the valueChanged() +signal only when the user releases the mouse button after moving +the slider. + +<p>Set this property's value with <a href="qscrollbar.html#setTracking">setTracking</a>() and get this property's value with <a href="qscrollbar.html#tracking">tracking</a>(). +</doc> +</property> +<property> + <name>QScrollBar::value</name> + <doc href="qscrollbar.html#value-prop"> +<p>This property holds the scroll bar's value. +<p>Set this property's value with <a href="qscrollbar.html#setValue">setValue</a>() and get this property's value with <a href="qscrollbar.html#value">value</a>(). +<p><p>See also <a href="qrangecontrol.html#value">QRangeControl::value</a>() and <a href="qrangecontrol.html#prevValue">prevValue</a>(). + +</doc> +</property> +<property> + <name>QScrollView::contentsHeight</name> + <doc href="qscrollview.html#contentsHeight-prop"> +<p>This property holds the height of the contents area. +<p> +<p>Get this property's value with <a href="qscrollview.html#contentsHeight">contentsHeight</a>(). +</doc> +</property> +<property> + <name>QScrollView::contentsWidth</name> + <doc href="qscrollview.html#contentsWidth-prop"> +<p>This property holds the width of the contents area. +<p> +<p>Get this property's value with <a href="qscrollview.html#contentsWidth">contentsWidth</a>(). +</doc> +</property> +<property> + <name>QScrollView::contentsX</name> + <doc href="qscrollview.html#contentsX-prop"> +<p>This property holds the X coordinate of the contents that are at the left edge of the viewport. +<p> +<p>Get this property's value with <a href="qscrollview.html#contentsX">contentsX</a>(). +</doc> +</property> +<property> + <name>QScrollView::contentsY</name> + <doc href="qscrollview.html#contentsY-prop"> +<p>This property holds the Y coordinate of the contents that are at the top edge of the viewport. +<p> +<p>Get this property's value with <a href="qscrollview.html#contentsY">contentsY</a>(). +</doc> +</property> +<property> + <name>QScrollView::dragAutoScroll</name> + <doc href="qscrollview.html#dragAutoScroll-prop"> +<p>This property holds whether autoscrolling in drag move events is enabled. +<p>If this property is set to TRUE (the default), the QScrollView +automatically scrolls the contents in drag move events if the user +moves the cursor close to a border of the view. Of course this +works only if the viewport accepts drops. Specifying FALSE +disables this autoscroll feature. +<p> <b>Warning:</b> Enabling this property might not be enough to +effectively turn on autoscrolling. If you put a custom widget in +the QScrollView, you might need to call QDragEvent::ignore() on +the event in the <a href="qwidget.html#dragEnterEvent">dragEnterEvent</a>() and <a href="qwidget.html#dragMoveEvent">dragMoveEvent</a>() +reimplementations. + +<p>Set this property's value with <a href="qscrollview.html#setDragAutoScroll">setDragAutoScroll</a>() and get this property's value with <a href="qscrollview.html#dragAutoScroll">dragAutoScroll</a>(). +</doc> +</property> +<property> + <name>QScrollView::hScrollBarMode</name> + <doc href="qscrollview.html#hScrollBarMode-prop"> +<p>This property holds the mode for the horizontal scroll bar. +<p>The default mode is <a href="qscrollview.html#ScrollBarMode-enum">QScrollView::Auto</a>. +<p> <p>See also <a href="qscrollview.html#vScrollBarMode-prop">vScrollBarMode</a>. + +<p>Set this property's value with <a href="qscrollview.html#setHScrollBarMode">setHScrollBarMode</a>() and get this property's value with <a href="qscrollview.html#hScrollBarMode">hScrollBarMode</a>(). +</doc> +</property> +<property> + <name>QScrollView::resizePolicy</name> + <doc href="qscrollview.html#resizePolicy-prop"> +<p>This property holds the resize policy. +<p>The default is <a href="qscrollview.html#ResizePolicy-enum">Default</a>. +<p> <p>See also <a href="qscrollview.html#ResizePolicy-enum">ResizePolicy</a>. + +<p>Set this property's value with <a href="qscrollview.html#setResizePolicy">setResizePolicy</a>() and get this property's value with <a href="qscrollview.html#resizePolicy">resizePolicy</a>(). +</doc> +</property> +<property> + <name>QScrollView::vScrollBarMode</name> + <doc href="qscrollview.html#vScrollBarMode-prop"> +<p>This property holds the mode for the vertical scroll bar. +<p>The default mode is <a href="qscrollview.html#ScrollBarMode-enum">QScrollView::Auto</a>. +<p> <p>See also <a href="qscrollview.html#hScrollBarMode-prop">hScrollBarMode</a>. + +<p>Set this property's value with <a href="qscrollview.html#setVScrollBarMode">setVScrollBarMode</a>() and get this property's value with <a href="qscrollview.html#vScrollBarMode">vScrollBarMode</a>(). +</doc> +</property> +<property> + <name>QScrollView::visibleHeight</name> + <doc href="qscrollview.html#visibleHeight-prop"> +<p>This property holds the vertical amount of the content that is visible. +<p> +<p>Get this property's value with <a href="qscrollview.html#visibleHeight">visibleHeight</a>(). +</doc> +</property> +<property> + <name>QScrollView::visibleWidth</name> + <doc href="qscrollview.html#visibleWidth-prop"> +<p>This property holds the horizontal amount of the content that is visible. +<p> +<p>Get this property's value with <a href="qscrollview.html#visibleWidth">visibleWidth</a>(). +</doc> +</property> +<property> + <name>QSlider::lineStep</name> + <doc href="qslider.html#lineStep-prop"> +<p>This property holds the current line step. +<p>When setting lineStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be +called if the new line step is different from the previous +setting. +<p> <p>See also <a href="qrangecontrol.html#setSteps">setSteps</a>(), <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>(), and <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qslider.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qslider.html#lineStep">lineStep</a>(). +</doc> +</property> +<property> + <name>QSlider::maxValue</name> + <doc href="qslider.html#maxValue-prop"> +<p>This property holds the current maximum value of the slider. +<p>When setting this property, the <a href="qslider.html#minValue-prop">QSlider::minValue</a> is adjusted, +if necessary, to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qslider.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qslider.html#maxValue">maxValue</a>(). +</doc> +</property> +<property> + <name>QSlider::minValue</name> + <doc href="qslider.html#minValue-prop"> +<p>This property holds the current minimum value of the slider. +<p>When setting this property, the <a href="qslider.html#maxValue-prop">QSlider::maxValue</a> is adjusted, +if necessary, to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qslider.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qslider.html#minValue">minValue</a>(). +</doc> +</property> +<property> + <name>QSlider::orientation</name> + <doc href="qslider.html#orientation-prop"> +<p>This property holds the slider's orientation. +<p>The orientation must be <a href="qt.html#Orientation-enum">Qt::Vertical</a> (the default) or <a href="qt.html#Orientation-enum">Qt::Horizontal</a>. + +<p>Set this property's value with <a href="qslider.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qslider.html#orientation">orientation</a>(). +</doc> +</property> +<property> + <name>QSlider::pageStep</name> + <doc href="qslider.html#pageStep-prop"> +<p>This property holds the current page step. +<p>When setting pageStep, the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function will be +called if the new page step is different from the previous +setting. +<p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>(), <a href="qslider.html#lineStep-prop">lineStep</a>, and <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qslider.html#setPageStep">setPageStep</a>() and get this property's value with <a href="qslider.html#pageStep">pageStep</a>(). +</doc> +</property> +<property> + <name>QSlider::tickInterval</name> + <doc href="qslider.html#tickInterval-prop"> +<p>This property holds the interval between tickmarks. +<p>This is a value interval, not a pixel interval. If it is 0, the +slider will choose between <a href="qslider.html#lineStep">lineStep</a>() and <a href="qslider.html#pageStep">pageStep</a>(). The initial +value of tickInterval is 0. +<p> <p>See also <a href="qrangecontrol.html#lineStep">QRangeControl::lineStep</a>() and <a href="qrangecontrol.html#pageStep">QRangeControl::pageStep</a>(). + +<p>Set this property's value with <a href="qslider.html#setTickInterval">setTickInterval</a>() and get this property's value with <a href="qslider.html#tickInterval">tickInterval</a>(). +</doc> +</property> +<property> + <name>QSlider::tickmarks</name> + <doc href="qslider.html#tickmarks-prop"> +<p>This property holds the tickmark settings for this slider. +<p>The valid values are in <a href="qslider.html#TickSetting-enum">QSlider::TickSetting</a>. The default is +<a href="qslider.html#TickSetting-enum">NoMarks</a>. +<p> <p>See also <a href="qslider.html#tickInterval-prop">tickInterval</a>. + +<p>Set this property's value with <a href="qslider.html#setTickmarks">setTickmarks</a>() and get this property's value with <a href="qslider.html#tickmarks">tickmarks</a>(). +</doc> +</property> +<property> + <name>QSlider::tracking</name> + <doc href="qslider.html#tracking-prop"> +<p>This property holds whether slider tracking is enabled. +<p>If tracking is enabled (the default), the slider emits the +<a href="qslider.html#valueChanged">valueChanged</a>() signal whenever the slider is being dragged. If +tracking is disabled, the slider emits the valueChanged() signal +when the user releases the mouse button (unless the value happens +to be the same as before). + +<p>Set this property's value with <a href="qslider.html#setTracking">setTracking</a>() and get this property's value with <a href="qslider.html#tracking">tracking</a>(). +</doc> +</property> +<property> + <name>QSlider::value</name> + <doc href="qslider.html#value-prop"> +<p>This property holds the current slider value. +<p>Set this property's value with <a href="qslider.html#setValue">setValue</a>() and get this property's value with <a href="qslider.html#value">value</a>(). +<p><p>See also <a href="qrangecontrol.html#value">QRangeControl::value</a>() and <a href="qrangecontrol.html#prevValue">prevValue</a>(). + +</doc> +</property> +<property> + <name>QSpinBox::buttonSymbols</name> + <doc href="qspinbox.html#buttonSymbols-prop"> +<p>This property holds the current button symbol mode. +<p>The possible values can be either <a href="qspinbox.html#ButtonSymbols-enum">UpDownArrows</a> or <a href="qspinbox.html#ButtonSymbols-enum">PlusMinus</a>. +The default is <a href="qspinbox.html#ButtonSymbols-enum">UpDownArrows</a>. +<p> <p>See also <a href="qspinbox.html#ButtonSymbols-enum">ButtonSymbols</a>. + +<p>Set this property's value with <a href="qspinbox.html#setButtonSymbols">setButtonSymbols</a>() and get this property's value with <a href="qspinbox.html#buttonSymbols">buttonSymbols</a>(). +</doc> +</property> +<property> + <name>QSpinBox::cleanText</name> + <doc href="qspinbox.html#cleanText-prop"> +<p>This property holds the spin box's text with no <a href="qspinbox.html#prefix">prefix</a>(), <a href="qspinbox.html#suffix">suffix</a>() or leading or trailing whitespace. +<p>Get this property's value with <a href="qspinbox.html#cleanText">cleanText</a>(). +<p><p>See also <a href="qspinbox.html#text-prop">text</a>, <a href="qspinbox.html#prefix-prop">prefix</a>, and <a href="qspinbox.html#suffix-prop">suffix</a>. + +</doc> +</property> +<property> + <name>QSpinBox::lineStep</name> + <doc href="qspinbox.html#lineStep-prop"> +<p>This property holds the line step. +<p>When the user uses the arrows to change the spin box's value the +value will be incremented/decremented by the amount of the line +step. +<p> The <a href="qspinbox.html#setLineStep">setLineStep</a>() function calls the virtual <a href="qrangecontrol.html#stepChange">stepChange</a>() function +if the new line step is different from the previous setting. +<p> <p>See also <a href="qrangecontrol.html#setSteps">QRangeControl::setSteps</a>() and <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qspinbox.html#setLineStep">setLineStep</a>() and get this property's value with <a href="qspinbox.html#lineStep">lineStep</a>(). +</doc> +</property> +<property> + <name>QSpinBox::maxValue</name> + <doc href="qspinbox.html#maxValue-prop"> +<p>This property holds the maximum value of the spin box. +<p>When setting this property, <a href="qspinbox.html#minValue-prop">QSpinBox::minValue</a> is adjusted, if +necessary, to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>() and <a href="qspinbox.html#specialValueText-prop">specialValueText</a>. + +<p>Set this property's value with <a href="qspinbox.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qspinbox.html#maxValue">maxValue</a>(). +</doc> +</property> +<property> + <name>QSpinBox::minValue</name> + <doc href="qspinbox.html#minValue-prop"> +<p>This property holds the minimum value of the spin box. +<p>When setting this property, <a href="qspinbox.html#maxValue-prop">QSpinBox::maxValue</a> is adjusted, if +necessary, to ensure that the range remains valid. +<p> <p>See also <a href="qrangecontrol.html#setRange">setRange</a>() and <a href="qspinbox.html#specialValueText-prop">specialValueText</a>. + +<p>Set this property's value with <a href="qspinbox.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qspinbox.html#minValue">minValue</a>(). +</doc> +</property> +<property> + <name>QSpinBox::prefix</name> + <doc href="qspinbox.html#prefix-prop"> +<p>This property holds the spin box's prefix. +<p>The prefix is prepended to the start of the displayed value. +Typical use is to display a unit of measurement or a currency +symbol. For example: +<p> <pre> + sb-&gt;setPrefix( "$" ); + </pre> + +<p> To turn off the prefix display, set this property to an empty +string. The default is no prefix. The prefix is not displayed for +the <a href="qspinbox.html#minValue">minValue</a>() if <a href="qspinbox.html#specialValueText">specialValueText</a>() is not empty. +<p> If no prefix is set, <a href="qspinbox.html#prefix">prefix</a>() returns <a href="qstring.html#QString-null">QString::null</a>. +<p> <p>See also <a href="qspinbox.html#suffix-prop">suffix</a>. + +<p>Set this property's value with <a href="qspinbox.html#setPrefix">setPrefix</a>() and get this property's value with <a href="qspinbox.html#prefix">prefix</a>(). +</doc> +</property> +<property> + <name>QSpinBox::specialValueText</name> + <doc href="qspinbox.html#specialValueText-prop"> +<p>This property holds the special-value text. +<p>If set, the spin box will display this text instead of a numeric +value whenever the current value is equal to minVal(). Typical use +is to indicate that this choice has a special (default) meaning. +<p> For example, if your spin box allows the user to choose the margin +width in a print dialog and your application is able to +automatically choose a good margin width, you can set up the spin +box like this: +<pre> + QSpinBox marginBox( -1, 20, 1, parent, "marginBox" ); + marginBox-&gt;<a href="qspinbox.html#setSuffix">setSuffix</a>( " mm" ); + marginBox-&gt;<a href="qspinbox.html#setSpecialValueText">setSpecialValueText</a>( "Auto" ); + </pre> + +The user will then be able to choose a margin width from 0-20 +millimeters or select "Auto" to leave it to the application to +choose. Your code must then interpret the spin box value of -1 as +the user requesting automatic margin width. +<p> All values are displayed with the <a href="qspinbox.html#prefix">prefix</a>() and <a href="qspinbox.html#suffix">suffix</a>() (if set), +<em>except</em> for the special value, which only shows the special +value text. +<p> To turn off the special-value text display, call this function +with an empty string. The default is no special-value text, i.e. +the numeric value is shown as usual. +<p> If no special-value text is set, <a href="qspinbox.html#specialValueText">specialValueText</a>() returns +<a href="qstring.html#QString-null">QString::null</a>. + +<p>Set this property's value with <a href="qspinbox.html#setSpecialValueText">setSpecialValueText</a>() and get this property's value with <a href="qspinbox.html#specialValueText">specialValueText</a>(). +</doc> +</property> +<property> + <name>QSpinBox::suffix</name> + <doc href="qspinbox.html#suffix-prop"> +<p>This property holds the suffix of the spin box. +<p>The suffix is appended to the end of the displayed value. Typical +use is to display a unit of measurement or a currency symbol. For +example: +<p> <pre> + sb-&gt;setSuffix( " km" ); + </pre> + +<p> To turn off the suffix display, set this property to an empty +string. The default is no suffix. The suffix is not displayed for +the <a href="qspinbox.html#minValue">minValue</a>() if <a href="qspinbox.html#specialValueText">specialValueText</a>() is not empty. +<p> If no suffix is set, <a href="qspinbox.html#suffix">suffix</a>() returns a <a href="qstring.html#QString-null">QString::null</a>. +<p> <p>See also <a href="qspinbox.html#prefix-prop">prefix</a>. + +<p>Set this property's value with <a href="qspinbox.html#setSuffix">setSuffix</a>() and get this property's value with <a href="qspinbox.html#suffix">suffix</a>(). +</doc> +</property> +<property> + <name>QSpinBox::text</name> + <doc href="qspinbox.html#text-prop"> +<p>This property holds the spin box's text, including any <a href="qspinbox.html#prefix">prefix</a>() and <a href="qspinbox.html#suffix">suffix</a>(). +<p>There is no default text. +<p> <p>See also <a href="qspinbox.html#value-prop">value</a>. + +<p>Get this property's value with <a href="qspinbox.html#text">text</a>(). +</doc> +</property> +<property> + <name>QSpinBox::value</name> + <doc href="qspinbox.html#value-prop"> +<p>This property holds the value of the spin box. +<p>Set this property's value with <a href="qspinbox.html#setValue">setValue</a>() and get this property's value with <a href="qspinbox.html#value">value</a>(). +<p><p>See also <a href="qrangecontrol.html#setValue">QRangeControl::setValue</a>(). + +</doc> +</property> +<property> + <name>QSpinBox::wrapping</name> + <doc href="qspinbox.html#wrapping-prop"> +<p>This property holds whether it is possible to step the value from the highest value to the lowest value and vice versa. +<p>By default, wrapping is turned off. +<p> If you have a range of 0..100 and wrapping is off when the user +reaches 100 and presses the Up Arrow nothing will happen; but if +wrapping is on the value will change from 100 to 0, then to 1, +etc. When wrapping is on, navigating past the highest value takes +you to the lowest and vice versa. +<p> <p>See also <a href="qspinbox.html#minValue-prop">minValue</a>, <a href="qspinbox.html#maxValue-prop">maxValue</a>, and <a href="qrangecontrol.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qspinbox.html#setWrapping">setWrapping</a>() and get this property's value with <a href="qspinbox.html#wrapping">wrapping</a>(). +</doc> +</property> +<property> + <name>QSplitter::childrenCollapsible</name> + <doc href="qsplitter.html#childrenCollapsible-prop"> +<p>This property holds whether child widgets can be resized down to size 0 by the user. +<p>By default, children are collapsible. It is possible to enable +and disable the collapsing of individual children; see +<a href="qsplitter.html#setCollapsible">setCollapsible</a>(). + +<p>Set this property's value with <a href="qsplitter.html#setChildrenCollapsible">setChildrenCollapsible</a>() and get this property's value with <a href="qsplitter.html#childrenCollapsible">childrenCollapsible</a>(). +</doc> +</property> +<property> + <name>QSplitter::handleWidth</name> + <doc href="qsplitter.html#handleWidth-prop"> +<p>This property holds the width of the splitter handle. +<p> +<p>Set this property's value with <a href="qsplitter.html#setHandleWidth">setHandleWidth</a>() and get this property's value with <a href="qsplitter.html#handleWidth">handleWidth</a>(). +</doc> +</property> +<property> + <name>QSplitter::opaqueResize</name> + <doc href="qsplitter.html#opaqueResize-prop"> +<p>This property holds whether resizing is opaque. +<p>Opaque resizing is off by default. + +<p>Set this property's value with <a href="qsplitter.html#setOpaqueResize">setOpaqueResize</a>() and get this property's value with <a href="qsplitter.html#opaqueResize">opaqueResize</a>(). +</doc> +</property> +<property> + <name>QSplitter::orientation</name> + <doc href="qsplitter.html#orientation-prop"> +<p>This property holds the orientation of the splitter. +<p>By default the orientation is horizontal (the widgets are side by +side). The possible orientations are <a href="qt.html#Orientation-enum">Horizontal</a> and +<a href="qt.html#Orientation-enum">Vertical</a>. + +<p>Set this property's value with <a href="qsplitter.html#setOrientation">setOrientation</a>() and get this property's value with <a href="qsplitter.html#orientation">orientation</a>(). +</doc> +</property> +<property> + <name>QSqlDatabase::connectOptions</name> + <doc href="qsqldatabase.html#connectOptions-prop"> +<p>This property holds the database connect options. +<p>The format of the options string is a semi-colon separated list of +option names or option = value pairs. The options depend on the +database client used: +<p> <center><table cellpadding="4" cellspacing="2" border="0"> +<tr bgcolor="#a2c511"> <th valign="top">ODBC <th valign="top">MySQL <th valign="top">PostgreSQL +<tr bgcolor="#f0f0f0"> +<p> <td valign="top"> +<ul> +<li> SQL_ATTR_ACCESS_MODE +<li> SQL_ATTR_LOGIN_TIMEOUT +<li> SQL_ATTR_CONNECTION_TIMEOUT +<li> SQL_ATTR_CURRENT_CATALOG +<li> SQL_ATTR_METADATA_ID +<li> SQL_ATTR_PACKET_SIZE +<li> SQL_ATTR_TRACEFILE +<li> SQL_ATTR_TRACE +</ul> +<p> <td valign="top"> +<ul> +<li> CLIENT_COMPRESS +<li> CLIENT_FOUND_ROWS +<li> CLIENT_IGNORE_SPACE +<li> CLIENT_SSL +<li> CLIENT_ODBC +<li> CLIENT_NO_SCHEMA +<li> CLIENT_INTERACTIVE +</ul> +<p> <td valign="top"> +<ul> +<li> connect_timeout +<li> options +<li> tty +<li> requiressl +<li> service +</ul> +<tr bgcolor="#a2c511"> <th valign="top">DB2 <th valign="top">OCI <th valign="top">TDS +<tr bgcolor="#d0d0d0"> +<p> <td valign="top"> +<ul> +<li> SQL_ATTR_ACCESS_MODE +<li> SQL_ATTR_LOGIN_TIMEOUT +</ul> +<p> <td valign="top"> +<em>none</em> +<p> <td valign="top"> +<em>none</em> +<p> </table></center> +<p> Example of usage: +<pre> + ... + // MySQL connection + db-&gt;setConnectOptions( "CLIENT_SSL;CLIENT_IGNORE_SPACE" ); // use an SSL connection to the server + if ( !db-&gt;open() ) { + db-&gt;setConnectOptions(); // clears the connect option string + ... + } + ... + // PostgreSQL connection + db-&gt;setConnectOptions( "requiressl=1" ); // enable PostgreSQL SSL connections + if ( !db-&gt;open() ) { + db-&gt;setConnectOptions(); // clear options + ... + } + ... + // ODBC connection + db-&gt;setConnectOptions( "SQL_ATTR_ACCESS_MODE=SQL_MODE_READ_ONLY;SQL_ATTR_TRACE=SQL_OPT_TRACE_ON" ); // set ODBC options + if ( !db-&gt;open() ) { + db-&gt;setConnectOptions(); // don't try to set this option + ... + } + </pre> + +<p> Please refer to the client library documentation for more +information about the different options. The options will be set +prior to opening the database connection. Setting new options +without re-opening the connection does nothing. +<p> <p>See also +<p>Set this property's value with <a href="qsqldatabase.html#setConnectOptions">setConnectOptions</a>() and get this property's value with <a href="qsqldatabase.html#connectOptions">connectOptions</a>(). +</doc> +</property> +<property> + <name>QSqlDatabase::databaseName</name> + <doc href="qsqldatabase.html#databaseName-prop"> +<p>This property holds the name of the database. +<p>Note that the database name is the TNS Service Name for the <a href="sql-driver.html#QOCI8">QOCI8</a> +(Oracle) driver. +<p> For the <a href="sql-driver.html#QODBC3">QODBC3</a> driver it can either be a DSN, a DSN filename (the +file must have a <tt>.dsn</tt> extension), or a connection string. MS +Access users can for example use the following connection string +to open a <tt>.mdb</tt> file directly, instead of having to create a DSN +entry in the ODBC manager: +<p> <pre> + ... + db = QSqlDatabase::<a href="qsqldatabase.html#addDatabase">addDatabase</a>( "QODBC3" ); + db-&gt;setDatabaseName( "DRIVER={Microsoft Access Driver (*.mdb)};FIL={MS Access};DBQ=myaccessfile.mdb" ); + if ( db-&gt;open() ) { + // success! + } + ... + </pre> + +("FIL" is the required spelling in Microsoft's API.) +<p> There is no default value. + +<p>Set this property's value with <a href="qsqldatabase.html#setDatabaseName">setDatabaseName</a>() and get this property's value with <a href="qsqldatabase.html#databaseName">databaseName</a>(). +</doc> +</property> +<property> + <name>QSqlDatabase::hostName</name> + <doc href="qsqldatabase.html#hostName-prop"> +<p>This property holds the host name where the database resides. +<p>There is no default value. + +<p>Set this property's value with <a href="qsqldatabase.html#setHostName">setHostName</a>() and get this property's value with <a href="qsqldatabase.html#hostName">hostName</a>(). +</doc> +</property> +<property> + <name>QSqlDatabase::password</name> + <doc href="qsqldatabase.html#password-prop"> +<p>This property holds the password used to connect to the database. +<p>There is no default value. +<p> <b>Warning:</b> This function stores the password in plain text within +Qt. Use the <a href="qsqldatabase.html#open">open</a>() call that takes a password as parameter to +avoid this behaviour. +<p> <p>See also <a href="qsqldatabase.html#open">open</a>(). + +<p>Set this property's value with <a href="qsqldatabase.html#setPassword">setPassword</a>() and get this property's value with <a href="qsqldatabase.html#password">password</a>(). +</doc> +</property> +<property> + <name>QSqlDatabase::port</name> + <doc href="qsqldatabase.html#port-prop"> +<p>This property holds the port used to connect to the database. +<p>There is no default value. + +<p>Set this property's value with <a href="qsqldatabase.html#setPort">setPort</a>() and get this property's value with <a href="qsqldatabase.html#port">port</a>(). +</doc> +</property> +<property> + <name>QSqlDatabase::userName</name> + <doc href="qsqldatabase.html#userName-prop"> +<p>This property holds the user name connected to the database. +<p>There is no default value. + +<p>Set this property's value with <a href="qsqldatabase.html#setUserName">setUserName</a>() and get this property's value with <a href="qsqldatabase.html#userName">userName</a>(). +</doc> +</property> +<property> + <name>QStatusBar::sizeGripEnabled</name> + <doc href="qstatusbar.html#sizeGripEnabled-prop"> +<p>This property holds whether the <a href="qsizegrip.html">QSizeGrip</a> in the bottom right of the status bar is enabled. +<p>Enables or disables the QSizeGrip in the bottom right of the +status bar. By default, the size grip is enabled. + +<p>Set this property's value with <a href="qstatusbar.html#setSizeGripEnabled">setSizeGripEnabled</a>() and get this property's value with <a href="qstatusbar.html#isSizeGripEnabled">isSizeGripEnabled</a>(). +</doc> +</property> +<property> + <name>QTabBar::count</name> + <doc href="qtabbar.html#count-prop"> +<p>This property holds the number of tabs in the tab bar. +<p>Get this property's value with <a href="qtabbar.html#count">count</a>(). +<p><p>See also <a href="qtabbar.html#tab">tab</a>(). + +</doc> +</property> +<property> + <name>QTabBar::currentTab</name> + <doc href="qtabbar.html#currentTab-prop"> +<p>This property holds the id of the tab bar's visible tab. +<p>If no tab page is currently visible, the property's value is -1. +Even if the property's value is not -1, you cannot assume that the +user can see the relevant page, or that the tab is enabled. When +you need to display something the value of this property +represents the best page to display. +<p> When this property is set to <em>id</em>, it will raise the tab with the +id <em>id</em> and emit the <a href="qtabbar.html#selected">selected</a>() signal. +<p> <p>See also <a href="qtabbar.html#selected">selected</a>() and <a href="qtabbar.html#isTabEnabled">isTabEnabled</a>(). + +<p>Set this property's value with <a href="qtabbar.html#setCurrentTab">setCurrentTab</a>() and get this property's value with <a href="qtabbar.html#currentTab">currentTab</a>(). +</doc> +</property> +<property> + <name>QTabBar::keyboardFocusTab</name> + <doc href="qtabbar.html#keyboardFocusTab-prop"> +<p>This property holds the id of the tab that has the <a href="focus.html#keyboard-focus">keyboard focus</a>. +<p>This property contains the id of the tab that has the keyboard +focus or -1 if the tab bar does not have the keyboard focus. + +<p>Get this property's value with <a href="qtabbar.html#keyboardFocusTab">keyboardFocusTab</a>(). +</doc> +</property> +<property> + <name>QTabBar::shape</name> + <doc href="qtabbar.html#shape-prop"> +<p>This property holds the shape of the tabs in the tab bar. +<p>The value of this property is one of the following: <a href="qtabbar.html#Shape-enum">RoundedAbove</a> (default), <a href="qtabbar.html#Shape-enum">RoundedBelow</a>, <a href="qtabbar.html#Shape-enum">TriangularAbove</a> or <a href="qtabbar.html#Shape-enum">TriangularBelow</a>. +<p> <p>See also <a href="qtabbar.html#Shape-enum">Shape</a>. + +<p>Set this property's value with <a href="qtabbar.html#setShape">setShape</a>() and get this property's value with <a href="qtabbar.html#shape">shape</a>(). +</doc> +</property> +<property> + <name>QTabWidget::count</name> + <doc href="qtabwidget.html#count-prop"> +<p>This property holds the number of tabs in the tab bar. +<p> +<p>Get this property's value with <a href="qtabwidget.html#count">count</a>(). +</doc> +</property> +<property> + <name>QTabWidget::currentPage</name> + <doc href="qtabwidget.html#currentPage-prop"> +<p>This property holds the index position of the current tab page. +<p>Set this property's value with <a href="qtabwidget.html#setCurrentPage">setCurrentPage</a>() and get this property's value with <a href="qtabwidget.html#currentPageIndex">currentPageIndex</a>(). +<p><p>See also <a href="qtabbar.html#currentTab-prop">QTabBar::currentTab</a>. + +</doc> +</property> +<property> + <name>QTabWidget::margin</name> + <doc href="qtabwidget.html#margin-prop"> +<p>This property holds the margin in this tab widget. +<p>The margin is the distance between the innermost pixel of the +frame and the outermost pixel of the pages. + +<p>Set this property's value with <a href="qtabwidget.html#setMargin">setMargin</a>() and get this property's value with <a href="qtabwidget.html#margin">margin</a>(). +</doc> +</property> +<property> + <name>QTabWidget::tabPosition</name> + <doc href="qtabwidget.html#tabPosition-prop"> +<p>This property holds the position of the tabs in this tab widget. +<p>Possible values for this property are <a href="qtabwidget.html#TabPosition-enum">QTabWidget::Top</a> and <a href="qtabwidget.html#TabPosition-enum">QTabWidget::Bottom</a>. +<p> <p>See also <a href="qtabwidget.html#TabPosition-enum">TabPosition</a>. + +<p>Set this property's value with <a href="qtabwidget.html#setTabPosition">setTabPosition</a>() and get this property's value with <a href="qtabwidget.html#tabPosition">tabPosition</a>(). +</doc> +</property> +<property> + <name>QTabWidget::tabShape</name> + <doc href="qtabwidget.html#tabShape-prop"> +<p>This property holds the shape of the tabs in this tab widget. +<p>Possible values for this property are <a href="qtabwidget.html#TabShape-enum">QTabWidget::Rounded</a> +(default) or <a href="qtabwidget.html#TabShape-enum">QTabWidget::Triangular</a>. +<p> <p>See also <a href="qtabwidget.html#TabShape-enum">TabShape</a>. + +<p>Set this property's value with <a href="qtabwidget.html#setTabShape">setTabShape</a>() and get this property's value with <a href="qtabwidget.html#tabShape">tabShape</a>(). +</doc> +</property> +<property> + <name>QTable::columnMovingEnabled</name> + <doc href="qtable.html#columnMovingEnabled-prop"> +<p>This property holds whether columns can be moved by the user. +<p>The default is FALSE. Columns are moved by dragging whilst holding +down the Ctrl key. +<p> <b>Warning:</b> If QTable is used to move header sections as a result of user +interaction, the mapping between header indexes and section exposed by +<a href="qheader.html">QHeader</a> will not reflect the order of the headers in the table; i.e., +QTable does not call <a href="qheader.html#moveSection">QHeader::moveSection</a>() to move sections but handles +move operations internally. +<p> <p>See also <a href="qtable.html#rowMovingEnabled-prop">rowMovingEnabled</a>. + +<p>Set this property's value with <a href="qtable.html#setColumnMovingEnabled">setColumnMovingEnabled</a>() and get this property's value with <a href="qtable.html#columnMovingEnabled">columnMovingEnabled</a>(). +</doc> +</property> +<property> + <name>QTable::focusStyle</name> + <doc href="qtable.html#focusStyle-prop"> +<p>This property holds how the current (focus) cell is drawn. +<p>The default style is <a href="qtable.html#FocusStyle-enum">SpreadSheet</a>. +<p> <p>See also <a href="qtable.html#FocusStyle-enum">QTable::FocusStyle</a>. + +<p>Set this property's value with <a href="qtable.html#setFocusStyle">setFocusStyle</a>() and get this property's value with <a href="qtable.html#focusStyle">focusStyle</a>(). +</doc> +</property> +<property> + <name>QTable::numCols</name> + <doc href="qtable.html#numCols-prop"> +<p>This property holds the number of columns in the table. +<p>Set this property's value with <a href="qtable.html#setNumCols">setNumCols</a>() and get this property's value with <a href="qtable.html#numCols">numCols</a>(). +<p><p>See also <a href="qtable.html#numRows-prop">numRows</a>. + +</doc> +</property> +<property> + <name>QTable::numRows</name> + <doc href="qtable.html#numRows-prop"> +<p>This property holds the number of rows in the table. +<p>Set this property's value with <a href="qtable.html#setNumRows">setNumRows</a>() and get this property's value with <a href="qtable.html#numRows">numRows</a>(). +<p><p>See also <a href="qtable.html#numCols-prop">numCols</a>. + +</doc> +</property> +<property> + <name>QTable::numSelections</name> + <doc href="qtable.html#numSelections-prop"> +<p>This property holds the number of selections. +<p>Get this property's value with <a href="qtable.html#numSelections">numSelections</a>(). +<p><p>See also <a href="qtable.html#currentSelection">currentSelection</a>(). + +</doc> +</property> +<property> + <name>QTable::readOnly</name> + <doc href="qtable.html#readOnly-prop"> +<p>This property holds whether the table is read-only. +<p>Whether a cell in the table is editable or read-only depends on +the cell's <a href="qtableitem.html#EditType-enum">EditType</a>, and this setting: +see <a href="qtableitem.html#wheneditable">QTableItem::EditType</a>. +<p> <p>See also <a href="qwidget.html#enabled-prop">QWidget::enabled</a>, <a href="qtable.html#setColumnReadOnly">setColumnReadOnly</a>(), and <a href="qtable.html#setRowReadOnly">setRowReadOnly</a>(). + +<p>Set this property's value with <a href="qtable.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qtable.html#isReadOnly">isReadOnly</a>(). +</doc> +</property> +<property> + <name>QTable::rowMovingEnabled</name> + <doc href="qtable.html#rowMovingEnabled-prop"> +<p>This property holds whether rows can be moved by the user. +<p>The default is FALSE. Rows are moved by dragging whilst holding +down the Ctrl key. +<p> <b>Warning:</b> If QTable is used to move header sections as a result of user +interaction, the mapping between header indexes and section exposed by +<a href="qheader.html">QHeader</a> will not reflect the order of the headers in the table; i.e., +QTable does not call <a href="qheader.html#moveSection">QHeader::moveSection</a>() to move sections but handles +move operations internally. +<p> <p>See also <a href="qtable.html#columnMovingEnabled-prop">columnMovingEnabled</a>. + +<p>Set this property's value with <a href="qtable.html#setRowMovingEnabled">setRowMovingEnabled</a>() and get this property's value with <a href="qtable.html#rowMovingEnabled">rowMovingEnabled</a>(). +</doc> +</property> +<property> + <name>QTable::selectionMode</name> + <doc href="qtable.html#selectionMode-prop"> +<p>This property holds the current selection mode. +<p>The default mode is <a href="qtable.html#SelectionMode-enum">Multi</a> which allows the user to select +multiple ranges of cells. +<p> <p>See also <a href="qtable.html#SelectionMode-enum">SelectionMode</a> and <a href="qtable.html#selectionMode-prop">selectionMode</a>. + +<p>Set this property's value with <a href="qtable.html#setSelectionMode">setSelectionMode</a>() and get this property's value with <a href="qtable.html#selectionMode">selectionMode</a>(). +</doc> +</property> +<property> + <name>QTable::showGrid</name> + <doc href="qtable.html#showGrid-prop"> +<p>This property holds whether the table's grid is displayed. +<p>The grid is shown by default. + +<p>Set this property's value with <a href="qtable.html#setShowGrid">setShowGrid</a>() and get this property's value with <a href="qtable.html#showGrid">showGrid</a>(). +</doc> +</property> +<property> + <name>QTable::sorting</name> + <doc href="qtable.html#sorting-prop"> +<p>This property holds whether a click on the header of a column sorts that column. +<p>Set this property's value with <a href="qtable.html#setSorting">setSorting</a>() and get this property's value with <a href="qtable.html#sorting">sorting</a>(). +<p><p>See also <a href="qtable.html#sortColumn">sortColumn</a>(). + +</doc> +</property> +<property> + <name>QTextBrowser::source</name> + <doc href="qtextbrowser.html#source-prop"> +<p>This property holds the name of the displayed document. +<p>This is a <a href="qstring.html#QString-null">QString::null</a> if no document is displayed or if the +source is unknown. +<p> Setting this property uses the <a href="qtextedit.html#mimeSourceFactory">mimeSourceFactory</a>() to lookup the +named document. It also checks for optional anchors and scrolls +the document accordingly. +<p> If the first tag in the document is <tt>&lt;qt type=detail&gt;</tt>, the +document is displayed as a popup rather than as new document in +the browser window itself. Otherwise, the document is displayed +normally in the text browser with the text set to the contents of +the named document with <a href="qtextedit.html#setText">setText</a>(). +<p> If you are using the filesystem access capabilities of the mime +source factory, you must ensure that the factory knows about the +encoding of specified files; otherwise no data will be available. +The default factory handles a couple of common file extensions +such as <tt>*.html</tt> and <tt>*.txt</tt> with reasonable defaults. See +<a href="qmimesourcefactory.html#data">QMimeSourceFactory::data</a>() for details. + +<p>Set this property's value with <a href="qtextbrowser.html#setSource">setSource</a>() and get this property's value with <a href="qtextbrowser.html#source">source</a>(). +</doc> +</property> +<property> + <name>QTextEdit::autoFormatting</name> + <doc href="qtextedit.html#autoFormatting-prop"> +<p>This property holds the enabled set of auto formatting features. +<p>The value can be any combination of the values in the <a href="qtextedit.html#AutoFormatting-enum">AutoFormatting</a> enum. The default is <a href="qtextedit.html#AutoFormatting-enum">AutoAll</a>. Choose <a href="qtextedit.html#AutoFormatting-enum">AutoNone</a> +to disable all automatic formatting. +<p> Currently, the only automatic formatting feature provided is <a href="qtextedit.html#AutoFormatting-enum">AutoBulletList</a>; future versions of Qt may offer more. + +<p>Set this property's value with <a href="qtextedit.html#setAutoFormatting">setAutoFormatting</a>() and get this property's value with <a href="qtextedit.html#autoFormatting">autoFormatting</a>(). +</doc> +</property> +<property> + <name>QTextEdit::documentTitle</name> + <doc href="qtextedit.html#documentTitle-prop"> +<p>This property holds the title of the document parsed from the text. +<p>For <a href="qt.html#TextFormat-enum">PlainText</a> the title will be an empty string. For <a href="qt.html#TextFormat-enum">RichText</a> the title will be the text between the <tt>&lt;title&gt;</tt> tags, +if present, otherwise an empty string. + +<p>Get this property's value with <a href="qtextedit.html#documentTitle">documentTitle</a>(). +</doc> +</property> +<property> + <name>QTextEdit::hasSelectedText</name> + <doc href="qtextedit.html#hasSelectedText-prop"> +<p>This property holds whether some text is selected in selection 0. +<p> +<p>Get this property's value with <a href="qtextedit.html#hasSelectedText">hasSelectedText</a>(). +</doc> +</property> +<property> + <name>QTextEdit::length</name> + <doc href="qtextedit.html#length-prop"> +<p>This property holds the number of characters in the text. +<p> +<p>Get this property's value with <a href="qtextedit.html#length">length</a>(). +</doc> +</property> +<property> + <name>QTextEdit::linkUnderline</name> + <doc href="qtextedit.html#linkUnderline-prop"> +<p>This property holds whether hypertext links will be underlined. +<p>If TRUE (the default) hypertext links will be displayed +underlined. If FALSE links will not be displayed underlined. + +<p>Set this property's value with <a href="qtextedit.html#setLinkUnderline">setLinkUnderline</a>() and get this property's value with <a href="qtextedit.html#linkUnderline">linkUnderline</a>(). +</doc> +</property> +<property> + <name>QTextEdit::modified</name> + <doc href="qtextedit.html#modified-prop"> +<p>This property holds whether the document has been modified by the user. +<p> +<p>Set this property's value with <a href="qtextedit.html#setModified">setModified</a>() and get this property's value with <a href="qtextedit.html#isModified">isModified</a>(). +</doc> +</property> +<property> + <name>QTextEdit::overwriteMode</name> + <doc href="qtextedit.html#overwriteMode-prop"> +<p>This property holds the text edit's overwrite mode. +<p>If FALSE (the default) characters entered by the user are inserted +with any characters to the right being moved out of the way. If +TRUE, the editor is in overwrite mode, i.e. characters entered by +the user overwrite any characters to the right of the cursor +position. + +<p>Set this property's value with <a href="qtextedit.html#setOverwriteMode">setOverwriteMode</a>() and get this property's value with <a href="qtextedit.html#isOverwriteMode">isOverwriteMode</a>(). +</doc> +</property> +<property> + <name>QTextEdit::paper</name> + <doc href="qtextedit.html#paper-prop"> +<p>This property holds the background (paper) brush. +<p>The brush that is currently used to draw the background of the +text edit. The initial setting is an empty brush. + +<p>Set this property's value with <a href="qtextedit.html#setPaper">setPaper</a>() and get this property's value with <a href="qtextedit.html#paper">paper</a>(). +</doc> +</property> +<property> + <name>QTextEdit::readOnly</name> + <doc href="qtextedit.html#readOnly-prop"> +<p>This property holds whether the text edit is read-only. +<p>In a read-only text edit the user can only navigate through the +text and select text; modifying the text is not possible. +<p> This property's default is FALSE. + +<p>Set this property's value with <a href="qtextedit.html#setReadOnly">setReadOnly</a>() and get this property's value with <a href="qtextedit.html#isReadOnly">isReadOnly</a>(). +</doc> +</property> +<property> + <name>QTextEdit::selectedText</name> + <doc href="qtextedit.html#selectedText-prop"> +<p>This property holds the selected text (from selection 0) or an empty string if there is no currently selected text (in selection 0). +<p>The text is always returned as <a href="qt.html#TextFormat-enum">PlainText</a> if the <a href="qtextedit.html#textFormat">textFormat</a>() is +<a href="qt.html#TextFormat-enum">PlainText</a> or <a href="qt.html#TextFormat-enum">AutoText</a>, otherwise it is returned as HTML. +<p> <p>See also <a href="qtextedit.html#hasSelectedText-prop">hasSelectedText</a>. + +<p>Get this property's value with <a href="qtextedit.html#selectedText">selectedText</a>(). +</doc> +</property> +<property> + <name>QTextEdit::tabChangesFocus</name> + <doc href="qtextedit.html#tabChangesFocus-prop"> <p>This property holds whether TAB changes focus or is accepted as input. +<p>In some occasions text edits should not allow the user to input +tabulators or change indentation using the TAB key, as this breaks +the focus chain. The default is FALSE. +<p> +<p>Set this property's value with <a href="qtextedit.html#setTabChangesFocus">setTabChangesFocus</a>() and get this property's value with <a href="qtextedit.html#tabChangesFocus">tabChangesFocus</a>(). +</doc> +</property> +<property> + <name>QTextEdit::tabStopWidth</name> + <doc href="qtextedit.html#tabStopWidth-prop"> +<p>This property holds the tab stop width in pixels. +<p> +<p>Set this property's value with <a href="qtextedit.html#setTabStopWidth">setTabStopWidth</a>() and get this property's value with <a href="qtextedit.html#tabStopWidth">tabStopWidth</a>(). +</doc> +</property> +<property> + <name>QTextEdit::text</name> + <doc href="qtextedit.html#text-prop"> +<p>This property holds the text edit's text. +<p>There is no default text. +<p> On setting, any previous text is deleted. +<p> The text may be interpreted either as plain text or as rich text, +depending on the <a href="qtextedit.html#textFormat">textFormat</a>(). The default setting is <a href="qt.html#TextFormat-enum">AutoText</a>, +i.e. the text edit auto-detects the format of the text. +<p> For richtext, calling <a href="qtextedit.html#text">text</a>() on an editable QTextEdit will cause +the text to be regenerated from the textedit. This may mean that +the <a href="qstring.html">QString</a> returned may not be exactly the same as the one that +was set. +<p> <p>See also <a href="qtextedit.html#textFormat-prop">textFormat</a>. + +<p>Set this property's value with <a href="qtextedit.html#setText">setText</a>() and get this property's value with <a href="qtextedit.html#text">text</a>(). +</doc> +</property> +<property> + <name>QTextEdit::textFormat</name> + <doc href="qtextedit.html#textFormat-prop"> +<p>This property holds the text format: rich text, plain text, log text or auto text. +<p>The text format is one of the following: +<ul> +<li> PlainText - all characters, except newlines, are displayed +verbatim, including spaces. Whenever a newline appears in the text +the text edit inserts a hard line break and begins a new +paragraph. +<li> RichText - rich text rendering. The available styles are +defined in the default stylesheet <a href="qstylesheet.html#defaultSheet">QStyleSheet::defaultSheet</a>(). +<li> LogText - optimized mode for very large texts. Supports a very +limited set of formatting tags (color, bold, underline and italic +settings). +<li> AutoText - this is the default. The text edit autodetects which +rendering style is best, <a href="qt.html#TextFormat-enum">PlainText</a> or <a href="qt.html#TextFormat-enum">RichText</a>. This is done +by using the <a href="qstylesheet.html#mightBeRichText">QStyleSheet::mightBeRichText</a>() function. +</ul> + +<p>Set this property's value with <a href="qtextedit.html#setTextFormat">setTextFormat</a>() and get this property's value with <a href="qtextedit.html#textFormat">textFormat</a>(). +</doc> +</property> +<property> + <name>QTextEdit::undoDepth</name> + <doc href="qtextedit.html#undoDepth-prop"> +<p>This property holds the depth of the undo history. +<p>The maximum number of steps in the undo/redo history. The default +is 100. +<p> <p>See also <a href="qtextedit.html#undo">undo</a>() and <a href="qtextedit.html#redo">redo</a>(). + +<p>Set this property's value with <a href="qtextedit.html#setUndoDepth">setUndoDepth</a>() and get this property's value with <a href="qtextedit.html#undoDepth">undoDepth</a>(). +</doc> +</property> +<property> + <name>QTextEdit::undoRedoEnabled</name> + <doc href="qtextedit.html#undoRedoEnabled-prop"> +<p>This property holds whether undo/redo is enabled. +<p>When changing this property, the undo/redo history is cleared. +<p> The default is TRUE. + +<p>Set this property's value with <a href="qtextedit.html#setUndoRedoEnabled">setUndoRedoEnabled</a>() and get this property's value with <a href="qtextedit.html#isUndoRedoEnabled">isUndoRedoEnabled</a>(). +</doc> +</property> +<property> + <name>QTextEdit::wordWrap</name> + <doc href="qtextedit.html#wordWrap-prop"> +<p>This property holds the word wrap mode. +<p>The default mode is <a href="qtextedit.html#WordWrap-enum">WidgetWidth</a> which causes words to be +wrapped at the right edge of the text edit. Wrapping occurs at +whitespace, keeping whole words intact. If you want wrapping to +occur within words use <a href="qtextedit.html#setWrapPolicy">setWrapPolicy</a>(). If you set a wrap mode of +<a href="qtextedit.html#WordWrap-enum">FixedPixelWidth</a> or <a href="qtextedit.html#WordWrap-enum">FixedColumnWidth</a> you should also call +<a href="qtextedit.html#setWrapColumnOrWidth">setWrapColumnOrWidth</a>() with the width you want. +<p> <p>See also <a href="qtextedit.html#WordWrap-enum">WordWrap</a>, <a href="qtextedit.html#wrapColumnOrWidth-prop">wrapColumnOrWidth</a>, and <a href="qtextedit.html#wrapPolicy-prop">wrapPolicy</a>. + +<p>Set this property's value with <a href="qtextedit.html#setWordWrap">setWordWrap</a>() and get this property's value with <a href="qtextedit.html#wordWrap">wordWrap</a>(). +</doc> +</property> +<property> + <name>QTextEdit::wrapColumnOrWidth</name> + <doc href="qtextedit.html#wrapColumnOrWidth-prop"> +<p>This property holds the position (in pixels or columns depending on the wrap mode) where text will be wrapped. +<p>If the wrap mode is <a href="qtextedit.html#WordWrap-enum">FixedPixelWidth</a>, the value is the number of +pixels from the left edge of the text edit at which text should be +wrapped. If the wrap mode is <a href="qtextedit.html#WordWrap-enum">FixedColumnWidth</a>, the value is the +column number (in character columns) from the left edge of the +text edit at which text should be wrapped. +<p> <p>See also <a href="qtextedit.html#wordWrap-prop">wordWrap</a>. + +<p>Set this property's value with <a href="qtextedit.html#setWrapColumnOrWidth">setWrapColumnOrWidth</a>() and get this property's value with <a href="qtextedit.html#wrapColumnOrWidth">wrapColumnOrWidth</a>(). +</doc> +</property> +<property> + <name>QTextEdit::wrapPolicy</name> + <doc href="qtextedit.html#wrapPolicy-prop"> +<p>This property holds the word wrap policy, at whitespace or anywhere. +<p>Defines where text can be wrapped when word wrap mode is not <a href="qtextedit.html#WordWrap-enum">NoWrap</a>. The choices are <a href="qtextedit.html#WrapPolicy-enum">AtWordBoundary</a> (the default), <a href="qtextedit.html#WrapPolicy-enum">Anywhere</a> and <a href="qtextedit.html#WrapPolicy-enum">AtWordOrDocumentBoundary</a> +<p> <p>See also <a href="qtextedit.html#wordWrap-prop">wordWrap</a>. + +<p>Set this property's value with <a href="qtextedit.html#setWrapPolicy">setWrapPolicy</a>() and get this property's value with <a href="qtextedit.html#wrapPolicy">wrapPolicy</a>(). +</doc> +</property> +<property> + <name>QTimeEdit::autoAdvance</name> + <doc href="qtimeedit.html#autoAdvance-prop"> +<p>This property holds whether the editor automatically advances to the next section. +<p>If autoAdvance is TRUE, the editor will automatically advance +focus to the next time section if a user has completed a section. +The default is FALSE. + +<p>Set this property's value with <a href="qtimeedit.html#setAutoAdvance">setAutoAdvance</a>() and get this property's value with <a href="qtimeedit.html#autoAdvance">autoAdvance</a>(). +</doc> +</property> +<property> + <name>QTimeEdit::display</name> + <doc href="qtimeedit.html#display-prop"> +<p>This property holds the sections that are displayed in the time edit. +<p>The value can be any combination of the values in the Display enum. +By default, the widget displays hours, minutes and seconds. + +<p>Set this property's value with <a href="qtimeedit.html#setDisplay">setDisplay</a>() and get this property's value with <a href="qtimeedit.html#display">display</a>(). +</doc> +</property> +<property> + <name>QTimeEdit::maxValue</name> + <doc href="qtimeedit.html#maxValue-prop"> +<p>This property holds the maximum time value. +<p>Setting the maximum time value is equivalent to calling +<a href="qtimeedit.html#setRange">QTimeEdit::setRange</a>( <a href="qtimeedit.html#minValue">minValue</a>(), <em>t</em> ), where <em>t</em> is the maximum +time. The default maximum time is 23:59:59. +<p> <p>See also <a href="qtimeedit.html#minValue-prop">minValue</a> and <a href="qtimeedit.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qtimeedit.html#setMaxValue">setMaxValue</a>() and get this property's value with <a href="qtimeedit.html#maxValue">maxValue</a>(). +</doc> +</property> +<property> + <name>QTimeEdit::minValue</name> + <doc href="qtimeedit.html#minValue-prop"> +<p>This property holds the minimum time value. +<p>Setting the minimum time value is equivalent to calling +<a href="qtimeedit.html#setRange">QTimeEdit::setRange</a>( <em>t</em>, <a href="qtimeedit.html#maxValue">maxValue</a>() ), where <em>t</em> is the minimum +time. The default minimum time is 00:00:00. +<p> <p>See also <a href="qtimeedit.html#maxValue-prop">maxValue</a> and <a href="qtimeedit.html#setRange">setRange</a>(). + +<p>Set this property's value with <a href="qtimeedit.html#setMinValue">setMinValue</a>() and get this property's value with <a href="qtimeedit.html#minValue">minValue</a>(). +</doc> +</property> +<property> + <name>QTimeEdit::time</name> + <doc href="qtimeedit.html#time-prop"> +<p>This property holds the editor's time value. +<p>When changing the time property, if the time is less than +<a href="qtimeedit.html#minValue">minValue</a>(), or is greater than <a href="qtimeedit.html#maxValue">maxValue</a>(), nothing happens. + +<p>Set this property's value with <a href="qtimeedit.html#setTime">setTime</a>() and get this property's value with <a href="qtimeedit.html#time">time</a>(). +</doc> +</property> +<property> + <name>QToolBar::label</name> + <doc href="qtoolbar.html#label-prop"> +<p>This property holds the toolbar's label. +<p>If the toolbar is floated the label becomes the toolbar window's +caption. There is no default label text. + +<p>Set this property's value with <a href="qtoolbar.html#setLabel">setLabel</a>() and get this property's value with <a href="qtoolbar.html#label">label</a>(). +</doc> +</property> +<property> + <name>QToolBox::count</name> + <doc href="qtoolbox.html#count-prop"> +<p>This property holds the number of items contained in the toolbox. +<p> +<p>Get this property's value with <a href="qtoolbox.html#count">count</a>(). +</doc> +</property> +<property> + <name>QToolBox::currentIndex</name> + <doc href="qtoolbox.html#currentIndex-prop"> +<p>This property holds the index of the current item, or -1 if the toolbox is empty. +<p>Set this property's value with <a href="qtoolbox.html#setCurrentIndex">setCurrentIndex</a>() and get this property's value with <a href="qtoolbox.html#currentIndex">currentIndex</a>(). +<p><p>See also <a href="qtoolbox.html#currentItem">currentItem</a>(), <a href="qtoolbox.html#indexOf">indexOf</a>(), and <a href="qtoolbox.html#item">item</a>(). + +</doc> +</property> +<property> + <name>QToolButton::autoRaise</name> + <doc href="qtoolbutton.html#autoRaise-prop"> +<p>This property holds whether auto-raising is enabled. +<p>The default is disabled (i.e. FALSE). + +<p>Set this property's value with <a href="qtoolbutton.html#setAutoRaise">setAutoRaise</a>() and get this property's value with <a href="qtoolbutton.html#autoRaise">autoRaise</a>(). +</doc> +</property> +<property> + <name>QToolButton::iconSet</name> + <doc href="qtoolbutton.html#iconSet-prop"> +<p>This property holds the icon set providing the icon shown on the button. +<p>Setting this property sets <a href="qtoolbutton.html#pixmap-prop">QToolButton::pixmap</a> to a null +pixmap. There is no default iconset. +<p> <p>See also <a href="qtoolbutton.html#pixmap-prop">pixmap</a>, <a href="qtoolbutton.html#toggleButton-prop">toggleButton</a>, and <a href="qtoolbutton.html#on-prop">on</a>. + +<p>Set this property's value with <a href="qtoolbutton.html#setIconSet">setIconSet</a>() and get this property's value with <a href="qtoolbutton.html#iconSet">iconSet</a>(). +</doc> +</property> +<property> + <name>QToolButton::offIconSet</name> + <doc href="qtoolbutton.html#offIconSet-prop"> +<p>This property holds the icon set that is used when the button is in an "off" state. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> Since Qt 3.0, <a href="qiconset.html">QIconSet</a> contains both the On and Off icons. There is +now an <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a> property that replaces both <a href="qtoolbutton.html#onIconSet-prop">QToolButton::onIconSet</a> and <a href="qtoolbutton.html#offIconSet-prop">QToolButton::offIconSet</a>. +<p> For ease of porting, this property is a synonym for <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a>. You probably want to go over your application +code and use the QIconSet On/Off mechanism. +<p> <p>See also <a href="qtoolbutton.html#iconSet-prop">iconSet</a> and <a href="qiconset.html#State-enum">QIconSet::State</a>. + +<p>Set this property's value with <a href="qtoolbutton.html#setOffIconSet">setOffIconSet</a>() and get this property's value with <a href="qtoolbutton.html#offIconSet">offIconSet</a>(). +</doc> +</property> +<property> + <name>QToolButton::onIconSet</name> + <doc href="qtoolbutton.html#onIconSet-prop"> +<p>This property holds the icon set that is used when the button is in an "on" state. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> Since Qt 3.0, <a href="qiconset.html">QIconSet</a> contains both the On and Off icons. There is +now an <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a> property that replaces both <a href="qtoolbutton.html#onIconSet-prop">QToolButton::onIconSet</a> and <a href="qtoolbutton.html#offIconSet-prop">QToolButton::offIconSet</a>. +<p> For ease of porting, this property is a synonym for <a href="qtoolbutton.html#iconSet-prop">QToolButton::iconSet</a>. You probably want to go over your application +code and use the QIconSet On/Off mechanism. +<p> <p>See also <a href="qtoolbutton.html#iconSet-prop">iconSet</a> and <a href="qiconset.html#State-enum">QIconSet::State</a>. + +<p>Set this property's value with <a href="qtoolbutton.html#setOnIconSet">setOnIconSet</a>() and get this property's value with <a href="qtoolbutton.html#onIconSet">onIconSet</a>(). +</doc> +</property> +<property> + <name>QToolButton::popupDelay</name> + <doc href="qtoolbutton.html#popupDelay-prop"> +<p>This property holds the time delay between pressing the button and the appearance of the associated popup menu in milliseconds. +<p>Usually this is around half a second. A value of 0 draws the down +arrow button to the side of the button which can be used to open +up the popup menu. +<p> <p>See also <a href="qtoolbutton.html#setPopup">setPopup</a>(). + +<p>Set this property's value with <a href="qtoolbutton.html#setPopupDelay">setPopupDelay</a>() and get this property's value with <a href="qtoolbutton.html#popupDelay">popupDelay</a>(). +</doc> +</property> +<property> + <name>QToolButton::textLabel</name> + <doc href="qtoolbutton.html#textLabel-prop"> +<p>This property holds the label of this button. +<p>Setting this property automatically sets the text as a tool tip +too. There is no default text. + +<p>Set this property's value with <a href="qtoolbutton.html#setTextLabel">setTextLabel</a>() and get this property's value with <a href="qtoolbutton.html#textLabel">textLabel</a>(). +</doc> +</property> +<property> + <name>QToolButton::textPosition</name> + <doc href="qtoolbutton.html#textPosition-prop"> +<p>This property holds the position of the text label of this button. +<p> +<p>Set this property's value with <a href="qtoolbutton.html#setTextPosition">setTextPosition</a>() and get this property's value with <a href="qtoolbutton.html#textPosition">textPosition</a>(). +</doc> +</property> +<property> + <name>QToolButton::usesBigPixmap</name> + <doc href="qtoolbutton.html#usesBigPixmap-prop"> +<p>This property holds whether this toolbutton uses big pixmaps. +<p>QToolButton automatically connects this property to the relevant +signal in the <a href="qmainwindow.html">QMainWindow</a> in which it resides. We strongly +recommend that you use <a href="qmainwindow.html#setUsesBigPixmaps">QMainWindow::setUsesBigPixmaps</a>() instead. +<p> This property's default is TRUE. +<p> <b>Warning:</b> If you set some buttons (in a QMainWindow) to have big +pixmaps and others to have small pixmaps, QMainWindow may not get +the geometry right. + +<p>Set this property's value with <a href="qtoolbutton.html#setUsesBigPixmap">setUsesBigPixmap</a>() and get this property's value with <a href="qtoolbutton.html#usesBigPixmap">usesBigPixmap</a>(). +</doc> +</property> +<property> + <name>QToolButton::usesTextLabel</name> + <doc href="qtoolbutton.html#usesTextLabel-prop"> +<p>This property holds whether the toolbutton displays a text label below the button pixmap. +<p>The default is FALSE. +<p> QToolButton automatically connects this slot to the relevant +signal in the <a href="qmainwindow.html">QMainWindow</a> in which is resides. + +<p>Set this property's value with <a href="qtoolbutton.html#setUsesTextLabel">setUsesTextLabel</a>() and get this property's value with <a href="qtoolbutton.html#usesTextLabel">usesTextLabel</a>(). +</doc> +</property> +<property> + <name>QToolTipGroup::delay</name> + <doc href="qtooltipgroup.html#delay-prop"> +<p>This property holds whether the display of the group text is delayed. +<p>If set to TRUE (the default), the group text is displayed at the +same time as the tool tip. Otherwise, the group text is displayed +immediately when the cursor enters the widget. + +<p>Set this property's value with <a href="qtooltipgroup.html#setDelay">setDelay</a>() and get this property's value with <a href="qtooltipgroup.html#delay">delay</a>(). +</doc> +</property> +<property> + <name>QToolTipGroup::enabled</name> + <doc href="qtooltipgroup.html#enabled-prop"> +<p>This property holds whether tool tips in the group are enabled. +<p>This property's default is TRUE. + +<p>Set this property's value with <a href="qtooltipgroup.html#setEnabled">setEnabled</a>() and get this property's value with <a href="qtooltipgroup.html#enabled">enabled</a>(). +</doc> +</property> +<property> + <name>QWidget::acceptDrops</name> + <doc href="qwidget.html#acceptDrops-prop"> +<p>This property holds whether drop events are enabled for this widget. +<p>Setting this property to TRUE announces to the system that this +widget <em>may</em> be able to accept drop events. +<p> If the widget is the desktop (<a href="qwidget.html#isDesktop">QWidget::isDesktop</a>()), this may +fail if another application is using the desktop; you can call +<a href="qwidget.html#acceptDrops">acceptDrops</a>() to test if this occurs. +<p> <b>Warning:</b> +Do not modify this property in a Drag&Drop event handler. + +<p>Set this property's value with <a href="qwidget.html#setAcceptDrops">setAcceptDrops</a>() and get this property's value with <a href="qwidget.html#acceptDrops">acceptDrops</a>(). +</doc> +</property> +<property> + <name>QWidget::autoMask</name> + <doc href="qwidget.html#autoMask-prop"> +<p>This property holds whether the auto mask feature is enabled for the widget. +<p>Transparent widgets use a mask to define their visible region. +QWidget has some built-in support to make the task of +recalculating the mask easier. When setting auto mask to TRUE, +<a href="qwidget.html#updateMask">updateMask</a>() will be called whenever the widget is resized or +changes its focus state. Note that you must reimplement +updateMask() (which should include a call to <a href="qwidget.html#setMask">setMask</a>()) or nothing +will happen. +<p> Note: when you re-implement <a href="qwidget.html#resizeEvent">resizeEvent</a>(), <a href="qwidget.html#focusInEvent">focusInEvent</a>() or +<a href="qwidget.html#focusOutEvent">focusOutEvent</a>() in your custom widgets and still want to ensure +that the auto mask calculation works, you should add: +<p> <pre> + if ( <a href="qwidget.html#autoMask">autoMask</a>() ) + <a href="qwidget.html#updateMask">updateMask</a>(); + </pre> + +<p> at the end of your event handlers. This is true for all member +functions that change the appearance of the widget in a way that +requires a recalculation of the mask. +<p> While being a technically appealing concept, masks have a big +drawback: when using complex masks that cannot be expressed easily +with relatively simple regions, they can be very slow on some +window systems. The classic example is a transparent label. The +complex shape of its contents makes it necessary to represent its +mask by a bitmap, which consumes both memory and time. If all you +want is to blend the background of several neighboring widgets +together seamlessly, you will probably want to use +<a href="qwidget.html#setBackgroundOrigin">setBackgroundOrigin</a>() rather than a mask. +<p> <p>See also <a href="qwidget.html#updateMask">updateMask</a>(), <a href="qwidget.html#setMask">setMask</a>(), <a href="qwidget.html#clearMask">clearMask</a>(), and <a href="qwidget.html#backgroundOrigin-prop">backgroundOrigin</a>. + +<p>Set this property's value with <a href="qwidget.html#setAutoMask">setAutoMask</a>() and get this property's value with <a href="qwidget.html#autoMask">autoMask</a>(). +</doc> +</property> +<property> + <name>QWidget::backgroundBrush</name> + <doc href="qwidget.html#backgroundBrush-prop"> +<p>This property holds the widget's background brush. +<p>The background brush depends on a widget's palette and its +background mode. +<p> <p>See also <a href="qwidget.html#backgroundColor">backgroundColor</a>(), <a href="qwidget.html#backgroundPixmap">backgroundPixmap</a>(), <a href="qwidget.html#eraseColor">eraseColor</a>(), <a href="qwidget.html#palette-prop">palette</a>, and <a href="qapplication.html#setPalette">QApplication::setPalette</a>(). + +<p>Get this property's value with <a href="qwidget.html#backgroundBrush">backgroundBrush</a>(). +</doc> +</property> +<property> + <name>QWidget::backgroundMode</name> + <doc href="qwidget.html#backgroundMode-prop"> +<p>This property holds the color role used for painting the background of the widget. +<p>setPaletteBackgroundColor() reads this property to determine which +entry of the <a href="qwidget.html#palette-prop">palette</a> to set. +<p> For most widgets the default suffices (<a href="qt.html#BackgroundMode-enum">PaletteBackground</a>, +typically gray), but some need to use <a href="qt.html#BackgroundMode-enum">PaletteBase</a> (the +background color for text output, typically white) or another +role. +<p> <a href="qlistbox.html">QListBox</a>, which is "sunken" and uses the base color to contrast +with its environment, does this in its constructor: +<p> <pre> + <a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>( <a href="qt.html#BackgroundMode-enum">PaletteBase</a> ); + </pre> + +<p> You will never need to set the background mode of a built-in +widget in Qt, but you might consider setting it in your custom +widgets, so that <a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>() works as expected. +<p> Note that two of the BackgroundMode values make no sense for +<a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>(), namely <a href="qt.html#BackgroundMode-enum">FixedPixmap</a> and <a href="qt.html#BackgroundMode-enum">FixedColor</a>. You +must call <a href="qwidget.html#setBackgroundPixmap">setBackgroundPixmap</a>() and setPaletteBackgroundColor() +instead. + +<p>Set this property's value with <a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>() and get this property's value with <a href="qwidget.html#backgroundMode">backgroundMode</a>(). +</doc> +</property> +<property> + <name>QWidget::backgroundOrigin</name> + <doc href="qwidget.html#backgroundOrigin-prop"> +<p>This property holds the origin of the widget's background. +<p>The origin is either WidgetOrigin (the default), ParentOrigin, +WindowOrigin or AncestorOrigin. +<p> This only makes a difference if the widget has a background +pixmap, in which case positioning matters. Using <a href="qwidget.html#BackgroundOrigin-enum">WindowOrigin</a> +for several neighboring widgets makes the background blend +together seamlessly. <a href="qwidget.html#BackgroundOrigin-enum">AncestorOrigin</a> allows blending backgrounds +seamlessly when an ancestor of the widget has an origin other than +<a href="qwidget.html#BackgroundOrigin-enum">WindowOrigin</a>. +<p> <p>See also <a href="qwidget.html#backgroundPixmap">backgroundPixmap</a>() and <a href="qwidget.html#backgroundMode-prop">backgroundMode</a>. + +<p>Set this property's value with <a href="qwidget.html#setBackgroundOrigin">setBackgroundOrigin</a>() and get this property's value with <a href="qwidget.html#backgroundOrigin">backgroundOrigin</a>(). +</doc> +</property> +<property> + <name>QWidget::baseSize</name> + <doc href="qwidget.html#baseSize-prop"> +<p>This property holds the base size of the widget. +<p>The base size is used to calculate a proper widget size if the +widget defines <a href="qwidget.html#sizeIncrement">sizeIncrement</a>(). +<p> <p>See also <a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a>. + +<p>Set this property's value with <a href="qwidget.html#setBaseSize">setBaseSize</a>() and get this property's value with <a href="qwidget.html#baseSize">baseSize</a>(). +</doc> +</property> +<property> + <name>QWidget::caption</name> + <doc href="qwidget.html#caption-prop"> +<p>This property holds the window caption (title). +<p>This property only makes sense for top-level widgets. If no +caption has been set, the caption is <a href="qstring.html#QString-null">QString::null</a>. +<p> <p>See also <a href="qwidget.html#icon-prop">icon</a> and <a href="qwidget.html#iconText-prop">iconText</a>. + +<p>Set this property's value with <a href="qwidget.html#setCaption">setCaption</a>() and get this property's value with <a href="qwidget.html#caption">caption</a>(). +</doc> +</property> +<property> + <name>QWidget::childrenRect</name> + <doc href="qwidget.html#childrenRect-prop"> +<p>This property holds the bounding rectangle of the widget's children. +<p>Hidden children are excluded. +<p> <p>See also <a href="qwidget.html#childrenRegion-prop">childrenRegion</a> and <a href="qwidget.html#geometry-prop">geometry</a>. + +<p>Get this property's value with <a href="qwidget.html#childrenRect">childrenRect</a>(). +</doc> +</property> +<property> + <name>QWidget::childrenRegion</name> + <doc href="qwidget.html#childrenRegion-prop"> +<p>This property holds the combined region occupied by the widget's children. +<p>Hidden children are excluded. +<p> <p>See also <a href="qwidget.html#childrenRect-prop">childrenRect</a> and <a href="qwidget.html#geometry-prop">geometry</a>. + +<p>Get this property's value with <a href="qwidget.html#childrenRegion">childrenRegion</a>(). +</doc> +</property> +<property> + <name>QWidget::colorGroup</name> + <doc href="qwidget.html#colorGroup-prop"> +<p>This property holds the current color group of the widget palette. +<p>The color group is determined by the state of the widget. A +disabled widget has the <a href="qpalette.html#disabled">QPalette::disabled</a>() color group, a widget +with <a href="focus.html#keyboard-focus">keyboard focus</a> has the <a href="qpalette.html#active">QPalette::active</a>() color group, and an +inactive widget has the <a href="qpalette.html#inactive">QPalette::inactive</a>() color group. +<p> <p>See also <a href="qwidget.html#palette-prop">palette</a>. + +<p>Get this property's value with <a href="qwidget.html#colorGroup">colorGroup</a>(). +</doc> +</property> +<property> + <name>QWidget::cursor</name> + <doc href="qwidget.html#cursor-prop"> +<p>This property holds the cursor shape for this widget. +<p>The mouse cursor will assume this shape when it's over this +widget. See the <a href="qt.html#CursorShape-enum">list of predefined cursor + objects</a> for a range of useful shapes. +<p> An editor widget might use an I-beam cursor: +<pre> + <a href="qwidget.html#setCursor">setCursor</a>( <a href="qt.html#CursorShape-enum">IbeamCursor</a> ); + </pre> + +<p> If no cursor has been set, or after a call to <a href="qwidget.html#unsetCursor">unsetCursor</a>(), the +parent's cursor is used. The function unsetCursor() has no effect +on top-level widgets. +<p> <p>See also <a href="qapplication.html#setOverrideCursor">QApplication::setOverrideCursor</a>(). + +<p>Set this property's value with <a href="qwidget.html#setCursor">setCursor</a>(), get this property's value with <a href="qwidget.html#cursor">cursor</a>(), and reset this property's value with <a href="qwidget.html#unsetCursor">unsetCursor</a>(). +</doc> +</property> +<property> + <name>QWidget::customWhatsThis</name> + <doc href="qwidget.html#customWhatsThis-prop"> +<p>This property holds whether the widget wants to handle What's This help manually. +<p>The default implementation of <a href="qwidget.html#customWhatsThis">customWhatsThis</a>() returns FALSE, +which means the widget will not receive any events in Whats This +mode. +<p> The widget may leave What's This mode by calling +<a href="qwhatsthis.html#leaveWhatsThisMode">QWhatsThis::leaveWhatsThisMode</a>(), with or without actually +displaying any help text. +<p> You can also reimplement customWhatsThis() if your widget is a +"passive interactor" supposed to work under all circumstances. +Simply don't call QWhatsThis::leaveWhatsThisMode() in that case. +<p> <p>See also <a href="qwhatsthis.html#inWhatsThisMode">QWhatsThis::inWhatsThisMode</a>() and <a href="qwhatsthis.html#leaveWhatsThisMode">QWhatsThis::leaveWhatsThisMode</a>(). + +<p>Get this property's value with <a href="qwidget.html#customWhatsThis">customWhatsThis</a>(). +</doc> +</property> +<property> + <name>QWidget::enabled</name> + <doc href="qwidget.html#enabled-prop"> +<p>This property holds whether the widget is enabled. +<p>An enabled widget receives keyboard and mouse events; a disabled +widget does not. In fact, an enabled widget only receives keyboard +events when it is in focus. +<p> Some widgets display themselves differently when they are +disabled. For example a button might draw its label grayed out. If +your widget needs to know when it becomes enabled or disabled, you +can reimplement the <a href="qwidget.html#enabledChange">enabledChange</a>() function. +<p> Disabling a widget implicitly disables all its children. Enabling +respectively enables all child widgets unless they have been +explicitly disabled. +<p> <p>See also <a href="qwidget.html#enabled-prop">enabled</a>, <a href="qwidget.html#isEnabledTo">isEnabledTo</a>(), <a href="qkeyevent.html">QKeyEvent</a>, <a href="qmouseevent.html">QMouseEvent</a>, and <a href="qwidget.html#enabledChange">enabledChange</a>(). + +<p>Set this property's value with <a href="qwidget.html#setEnabled">setEnabled</a>() and get this property's value with <a href="qwidget.html#isEnabled">isEnabled</a>(). +</doc> +</property> +<property> + <name>QWidget::focus</name> + <doc href="qwidget.html#focus-prop"> +<p>This property holds whether this widget (or its focus proxy) has the keyboard input focus. +<p>Effectively equivalent to <tt>qApp-&gt;focusWidget() == this</tt>. +<p> <p>See also <a href="qwidget.html#setFocus">setFocus</a>(), <a href="qwidget.html#clearFocus">clearFocus</a>(), <a href="qwidget.html#focusPolicy-prop">focusPolicy</a>, and <a href="qapplication.html#focusWidget">QApplication::focusWidget</a>(). + +<p>Get this property's value with <a href="qwidget.html#hasFocus">hasFocus</a>(). +</doc> +</property> +<property> + <name>QWidget::focusEnabled</name> + <doc href="qwidget.html#focusEnabled-prop"> +<p>This property holds whether the widget accepts <a href="focus.html#keyboard-focus">keyboard focus</a>. +<p>Keyboard focus is initially disabled (i.e. <a href="qwidget.html#focusPolicy">focusPolicy</a>() == +<a href="qwidget.html#FocusPolicy-enum">QWidget::NoFocus</a>). +<p> You must enable keyboard focus for a widget if it processes +keyboard events. This is normally done from the widget's +constructor. For instance, the <a href="qlineedit.html">QLineEdit</a> constructor calls +<a href="qwidget.html#setFocusPolicy">setFocusPolicy</a>(QWidget::StrongFocus). +<p> <p>See also <a href="qwidget.html#focusPolicy-prop">focusPolicy</a>, <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(), and <a href="qwidget.html#enabled-prop">enabled</a>. + +<p>Get this property's value with <a href="qwidget.html#isFocusEnabled">isFocusEnabled</a>(). +</doc> +</property> +<property> + <name>QWidget::focusPolicy</name> + <doc href="qwidget.html#focusPolicy-prop"> +<p>This property holds the way the widget accepts <a href="focus.html#keyboard-focus">keyboard focus</a>. +<p>The policy is <a href="qwidget.html#FocusPolicy-enum">QWidget::TabFocus</a> if the widget accepts keyboard +focus by tabbing, <a href="qwidget.html#FocusPolicy-enum">QWidget::ClickFocus</a> if the widget accepts +focus by clicking, <a href="qwidget.html#FocusPolicy-enum">QWidget::StrongFocus</a> if it accepts both, and +<a href="qwidget.html#FocusPolicy-enum">QWidget::NoFocus</a> (the default) if it does not accept focus at +all. +<p> You must enable keyboard focus for a widget if it processes +keyboard events. This is normally done from the widget's +constructor. For instance, the <a href="qlineedit.html">QLineEdit</a> constructor calls +<a href="qwidget.html#setFocusPolicy">setFocusPolicy</a>(QWidget::StrongFocus). +<p> <p>See also <a href="qwidget.html#focusEnabled-prop">focusEnabled</a>, <a href="qwidget.html#focusInEvent">focusInEvent</a>(), <a href="qwidget.html#focusOutEvent">focusOutEvent</a>(), <a href="qwidget.html#keyPressEvent">keyPressEvent</a>(), <a href="qwidget.html#keyReleaseEvent">keyReleaseEvent</a>(), and <a href="qwidget.html#enabled-prop">enabled</a>. + +<p>Set this property's value with <a href="qwidget.html#setFocusPolicy">setFocusPolicy</a>() and get this property's value with <a href="qwidget.html#focusPolicy">focusPolicy</a>(). +</doc> +</property> +<property> + <name>QWidget::font</name> + <doc href="qwidget.html#font-prop"> +<p>This property holds the font currently set for the widget. +<p>The <a href="qwidget.html#fontInfo">fontInfo</a>() function reports the actual font that is being used +by the widget. +<p> As long as no special font has been set, or after <a href="qwidget.html#unsetFont">unsetFont</a>() is +called, this is either a special font for the widget class, the +parent's font or (if this widget is a top level widget), the +default application font. +<p> This code fragment sets a 12 point helvetica bold font: +<pre> + <a href="qfont.html">QFont</a> f( "Helvetica", 12, QFont::Bold ); + <a href="qwidget.html#setFont">setFont</a>( f ); + </pre> + +<p> In addition to setting the font, <a href="qwidget.html#setFont">setFont</a>() informs all children +about the change. +<p> <p>See also <a href="qwidget.html#fontChange">fontChange</a>(), <a href="qwidget.html#fontInfo">fontInfo</a>(), <a href="qwidget.html#fontMetrics">fontMetrics</a>(), and <a href="qwidget.html#ownFont-prop">ownFont</a>. + +<p>Set this property's value with <a href="qwidget.html#setFont">setFont</a>(), get this property's value with <a href="qwidget.html#font">font</a>(), and reset this property's value with <a href="qwidget.html#unsetFont">unsetFont</a>(). +</doc> +</property> +<property> + <name>QWidget::frameGeometry</name> + <doc href="qwidget.html#frameGeometry-prop"> +<p>This property holds geometry of the widget relative to its parent including any window frame. +<p>See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of geometry issues with top-level widgets. +<p> <p>See also <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#x-prop">x</a>, <a href="qwidget.html#y-prop">y</a>, and <a href="qwidget.html#pos-prop">pos</a>. + +<p>Get this property's value with <a href="qwidget.html#frameGeometry">frameGeometry</a>(). +</doc> +</property> +<property> + <name>QWidget::frameSize</name> + <doc href="qwidget.html#frameSize-prop"> +<p>This property holds the size of the widget including any window frame. +<p> +<p>Get this property's value with <a href="qwidget.html#frameSize">frameSize</a>(). +</doc> +</property> +<property> + <name>QWidget::fullScreen</name> + <doc href="qwidget.html#fullScreen-prop"> +<p>This property holds whether the widget is full screen. +<p>Get this property's value with <a href="qwidget.html#isFullScreen">isFullScreen</a>(). +<p><p>See also <a href="qwidget.html#windowState">windowState</a>(), <a href="qwidget.html#minimized-prop">minimized</a>, and <a href="qwidget.html#maximized-prop">maximized</a>. + +</doc> +</property> +<property> + <name>QWidget::geometry</name> + <doc href="qwidget.html#geometry-prop"> +<p>This property holds the geometry of the widget relative to its parent and excluding the window frame. +<p>When changing the geometry, the widget, if visible, receives a +move event (<a href="qwidget.html#moveEvent">moveEvent</a>()) and/or a resize event (<a href="qwidget.html#resizeEvent">resizeEvent</a>()) +immediately. If the widget is not currently visible, it is +guaranteed to receive appropriate events before it is shown. +<p> The size component is adjusted if it lies outside the range +defined by <a href="qwidget.html#minimumSize">minimumSize</a>() and <a href="qwidget.html#maximumSize">maximumSize</a>(). +<p> <a href="qwidget.html#setGeometry">setGeometry</a>() is virtual, and all other overloaded setGeometry() +implementations in Qt call it. +<p> <b>Warning:</b> Calling setGeometry() inside resizeEvent() or moveEvent() +can lead to infinite recursion. +<p> See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of top-level widget geometry. +<p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#rect-prop">rect</a>, <a href="qwidget.html#pos-prop">pos</a>, <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#moveEvent">moveEvent</a>(), <a href="qwidget.html#resizeEvent">resizeEvent</a>(), <a href="qwidget.html#minimumSize-prop">minimumSize</a>, and <a href="qwidget.html#maximumSize-prop">maximumSize</a>. + +<p>Set this property's value with <a href="qwidget.html#setGeometry">setGeometry</a>() and get this property's value with <a href="qwidget.html#geometry">geometry</a>(). +</doc> +</property> +<property> + <name>QWidget::height</name> + <doc href="qwidget.html#height-prop"> +<p>This property holds the height of the widget excluding any window frame. +<p>See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of top-level widget geometry. +<p> <p>See also <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#width-prop">width</a>, and <a href="qwidget.html#size-prop">size</a>. + +<p>Get this property's value with <a href="qwidget.html#height">height</a>(). +</doc> +</property> +<property> + <name>QWidget::hidden</name> + <doc href="qwidget.html#hidden-prop"> +<p>This property holds whether the widget is explicitly hidden. +<p>If FALSE, the widget is visible or would become visible if all its +ancestors became visible. +<p> <p>See also <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#isVisibleTo">isVisibleTo</a>(), and <a href="qwidget.html#shown-prop">shown</a>. + +<p>Set this property's value with <a href="qwidget.html#setHidden">setHidden</a>() and get this property's value with <a href="qwidget.html#isHidden">isHidden</a>(). +</doc> +</property> +<property> + <name>QWidget::icon</name> + <doc href="qwidget.html#icon-prop"> +<p>This property holds the widget's icon. +<p>This property only makes sense for top-level widgets. If no icon +has been set, <a href="qwidget.html#icon">icon</a>() returns 0. +<p> <p>See also <a href="qwidget.html#iconText-prop">iconText</a>, <a href="qwidget.html#caption-prop">caption</a>, and <a href="appicon.html">Setting the Application Icon</a>. + +<p>Set this property's value with <a href="qwidget.html#setIcon">setIcon</a>() and get this property's value with <a href="qwidget.html#icon">icon</a>(). +</doc> +</property> +<property> + <name>QWidget::iconText</name> + <doc href="qwidget.html#iconText-prop"> +<p>This property holds the widget's icon text. +<p>This property only makes sense for top-level widgets. If no icon +text has been set, this functions returns <a href="qstring.html#QString-null">QString::null</a>. +<p> <p>See also <a href="qwidget.html#icon-prop">icon</a> and <a href="qwidget.html#caption-prop">caption</a>. + +<p>Set this property's value with <a href="qwidget.html#setIconText">setIconText</a>() and get this property's value with <a href="qwidget.html#iconText">iconText</a>(). +</doc> +</property> +<property> + <name>QWidget::inputMethodEnabled</name> + <doc href="qwidget.html#inputMethodEnabled-prop"> +<p>This property holds enables or disables the use of input methods for this widget. +<p>Most Widgets (as eg. buttons) that do not handle text input should have +the input method disabled if they have focus. This is the default. +<p> If a widget handles text input it should set this property to TRUE. + +<p>Set this property's value with <a href="qwidget.html#setInputMethodEnabled">setInputMethodEnabled</a>() and get this property's value with <a href="qwidget.html#isInputMethodEnabled">isInputMethodEnabled</a>(). +</doc> +</property> +<property> + <name>QWidget::isActiveWindow</name> + <doc href="qwidget.html#isActiveWindow-prop"> +<p>This property holds whether this widget is the active window. +<p>The active window is the window that contains the widget +that has <a href="focus.html#keyboard-focus">keyboard focus</a>. +<p> When popup windows are visible, this property is TRUE for both the +active window <em>and</em> for the popup. +<p> <p>See also <a href="qwidget.html#setActiveWindow">setActiveWindow</a>() and <a href="qapplication.html#activeWindow">QApplication::activeWindow</a>(). + +<p>Get this property's value with <a href="qwidget.html#isActiveWindow">isActiveWindow</a>(). +</doc> +</property> +<property> + <name>QWidget::isDesktop</name> + <doc href="qwidget.html#isDesktop-prop"> +<p>This property holds whether the widget is a desktop widget, i.e. represents the desktop. +<p>A desktop widget is also a top-level widget. +<p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a> and <a href="qapplication.html#desktop">QApplication::desktop</a>(). + +<p>Get this property's value with <a href="qwidget.html#isDesktop">isDesktop</a>(). +</doc> +</property> +<property> + <name>QWidget::isDialog</name> + <doc href="qwidget.html#isDialog-prop"> +<p>This property holds whether the widget is a dialog widget. +<p>A dialog widget is a secondary top-level widget, i.e. a top-level +widget with a parent. +<p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a> and <a href="qdialog.html">QDialog</a>. + +<p>Get this property's value with <a href="qwidget.html#isDialog">isDialog</a>(). +</doc> +</property> +<property> + <name>QWidget::isModal</name> + <doc href="qwidget.html#isModal-prop"> +<p>This property holds whether the widget is a modal widget. +<p>This property only makes sense for top-level widgets. A modal +widget prevents widgets in all other top-level widgets from +getting any input. +<p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a>, <a href="qwidget.html#isDialog-prop">isDialog</a>, and <a href="qdialog.html">QDialog</a>. + +<p>Get this property's value with <a href="qwidget.html#isModal">isModal</a>(). +</doc> +</property> +<property> + <name>QWidget::isPopup</name> + <doc href="qwidget.html#isPopup-prop"> +<p>This property holds whether the widget is a popup widget. +<p>A popup widget is created by specifying the <a href="qt.html#WidgetFlags">widget flag</a> <a href="qt.html#WidgetFlags-enum">WType_Popup</a> to the widget constructor. A popup widget is also a +top-level widget. +<p> <p>See also <a href="qwidget.html#isTopLevel-prop">isTopLevel</a>. + +<p>Get this property's value with <a href="qwidget.html#isPopup">isPopup</a>(). +</doc> +</property> +<property> + <name>QWidget::isTopLevel</name> + <doc href="qwidget.html#isTopLevel-prop"> +<p>This property holds whether the widget is a top-level widget. +<p>A top-level widget is a widget which usually has a frame and a +<a href="qwidget.html#caption-prop">caption (title)</a>. <a href="qwidget.html#isPopup">Popup</a> and <a href="qwidget.html#isDesktop">desktop</a> widgets are also top-level widgets. +<p> A top-level widget can have a <a href="qwidget.html#parentWidget">parent + widget</a>. It will then be grouped with its parent and deleted +when the parent is deleted, minimized when the parent is minimized +etc. If supported by the window manager, it will also have a +common taskbar entry with its parent. +<p> <a href="qdialog.html">QDialog</a> and <a href="qmainwindow.html">QMainWindow</a> widgets are by default top-level, even if +a parent widget is specified in the constructor. This behavior is +specified by the <a href="qt.html#WidgetFlags-enum">WType_TopLevel</a> widget flag. +<p> <p>See also <a href="qwidget.html#topLevelWidget">topLevelWidget</a>(), <a href="qwidget.html#isDialog-prop">isDialog</a>, <a href="qwidget.html#isModal-prop">isModal</a>, <a href="qwidget.html#isPopup-prop">isPopup</a>, <a href="qwidget.html#isDesktop-prop">isDesktop</a>, and <a href="qwidget.html#parentWidget">parentWidget</a>(). + +<p>Get this property's value with <a href="qwidget.html#isTopLevel">isTopLevel</a>(). +</doc> +</property> +<property> + <name>QWidget::maximized</name> + <doc href="qwidget.html#maximized-prop"> +<p>This property holds whether this widget is maximized. +<p>This property is only relevant for top-level widgets. +<p> Note that due to limitations in some window-systems, this does not +always report the expected results (e.g. if the user on X11 +maximizes the window via the window manager, Qt has no way of +distinguishing this from any other resize). This is expected to +improve as window manager protocols evolve. +<p> <p>See also <a href="qwidget.html#windowState">windowState</a>(), <a href="qwidget.html#showMaximized">showMaximized</a>(), <a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#showNormal">showNormal</a>(), and <a href="qwidget.html#minimized-prop">minimized</a>. + +<p>Get this property's value with <a href="qwidget.html#isMaximized">isMaximized</a>(). +</doc> +</property> +<property> + <name>QWidget::maximumHeight</name> + <doc href="qwidget.html#maximumHeight-prop"> +<p>This property holds the widget's maximum height. +<p>This property corresponds to <a href="qwidget.html#maximumSize">maximumSize</a>().<a href="qwidget.html#height">height</a>(). +<p> <p>See also <a href="qwidget.html#maximumSize-prop">maximumSize</a> and <a href="qwidget.html#maximumWidth-prop">maximumWidth</a>. + +<p>Set this property's value with <a href="qwidget.html#setMaximumHeight">setMaximumHeight</a>() and get this property's value with <a href="qwidget.html#maximumHeight">maximumHeight</a>(). +</doc> +</property> +<property> + <name>QWidget::maximumSize</name> + <doc href="qwidget.html#maximumSize-prop"> +<p>This property holds the widget's maximum size. +<p>The widget cannot be resized to a larger size than the maximum +widget size. +<p> <p>See also <a href="qwidget.html#maximumWidth-prop">maximumWidth</a>, <a href="qwidget.html#maximumHeight-prop">maximumHeight</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, and <a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a>. + +<p>Set this property's value with <a href="qwidget.html#setMaximumSize">setMaximumSize</a>() and get this property's value with <a href="qwidget.html#maximumSize">maximumSize</a>(). +</doc> +</property> +<property> + <name>QWidget::maximumWidth</name> + <doc href="qwidget.html#maximumWidth-prop"> +<p>This property holds the widget's maximum width. +<p>This property corresponds to <a href="qwidget.html#maximumSize">maximumSize</a>().<a href="qwidget.html#width">width</a>(). +<p> <p>See also <a href="qwidget.html#maximumSize-prop">maximumSize</a> and <a href="qwidget.html#maximumHeight-prop">maximumHeight</a>. + +<p>Set this property's value with <a href="qwidget.html#setMaximumWidth">setMaximumWidth</a>() and get this property's value with <a href="qwidget.html#maximumWidth">maximumWidth</a>(). +</doc> +</property> +<property> + <name>QWidget::microFocusHint</name> + <doc href="qwidget.html#microFocusHint-prop"> +<p>This property holds the currently set micro focus hint for this widget. +<p>See the documentation of <a href="qwidget.html#setMicroFocusHint">setMicroFocusHint</a>() for more information. + +<p>Get this property's value with <a href="qwidget.html#microFocusHint">microFocusHint</a>(). +</doc> +</property> +<property> + <name>QWidget::minimized</name> + <doc href="qwidget.html#minimized-prop"> +<p>This property holds whether this widget is minimized (iconified). +<p>This property is only relevant for top-level widgets. +<p> <p>See also <a href="qwidget.html#showMinimized">showMinimized</a>(), <a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#showNormal">showNormal</a>(), and <a href="qwidget.html#maximized-prop">maximized</a>. + +<p>Get this property's value with <a href="qwidget.html#isMinimized">isMinimized</a>(). +</doc> +</property> +<property> + <name>QWidget::minimumHeight</name> + <doc href="qwidget.html#minimumHeight-prop"> +<p>This property holds the widget's minimum height. +<p>This property corresponds to <a href="qwidget.html#minimumSize">minimumSize</a>().<a href="qwidget.html#height">height</a>(). +<p> <p>See also <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#minimumWidth-prop">minimumWidth</a>. + +<p>Set this property's value with <a href="qwidget.html#setMinimumHeight">setMinimumHeight</a>() and get this property's value with <a href="qwidget.html#minimumHeight">minimumHeight</a>(). +</doc> +</property> +<property> + <name>QWidget::minimumSize</name> + <doc href="qwidget.html#minimumSize-prop"> +<p>This property holds the widget's minimum size. +<p>The widget cannot be resized to a smaller size than the minimum +widget size. The widget's size is forced to the minimum size if +the current size is smaller. +<p> If you use a layout inside the widget, the minimum size will be +set by the layout and not by <a href="qwidget.html#setMinimumSize">setMinimumSize</a>(), unless you set the +layout's resize mode to QLayout::FreeResize. +<p> <p>See also <a href="qwidget.html#minimumWidth-prop">minimumWidth</a>, <a href="qwidget.html#minimumHeight-prop">minimumHeight</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a>, <a href="qwidget.html#sizeIncrement-prop">sizeIncrement</a>, and <a href="qlayout.html#resizeMode-prop">QLayout::resizeMode</a>. + +<p>Set this property's value with <a href="qwidget.html#setMinimumSize">setMinimumSize</a>() and get this property's value with <a href="qwidget.html#minimumSize">minimumSize</a>(). +</doc> +</property> +<property> + <name>QWidget::minimumSizeHint</name> + <doc href="qwidget.html#minimumSizeHint-prop"> +<p>This property holds the recommended minimum size for the widget. +<p>If the value of this property is an invalid size, no minimum size +is recommended. +<p> The default implementation of <a href="qwidget.html#minimumSizeHint">minimumSizeHint</a>() returns an invalid +size if there is no layout for this widget, and returns the +layout's minimum size otherwise. Most built-in widgets reimplement +minimumSizeHint(). +<p> <a href="qlayout.html">QLayout</a> will never resize a widget to a size smaller than +minimumSizeHint. +<p> <p>See also <a href="qsize.html#isValid">QSize::isValid</a>(), <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, and <a href="qwidget.html#sizePolicy-prop">sizePolicy</a>. + +<p>Get this property's value with <a href="qwidget.html#minimumSizeHint">minimumSizeHint</a>(). +</doc> +</property> +<property> + <name>QWidget::minimumWidth</name> + <doc href="qwidget.html#minimumWidth-prop"> +<p>This property holds the widget's minimum width. +<p>This property corresponds to <a href="qwidget.html#minimumSize">minimumSize</a>().<a href="qwidget.html#width">width</a>(). +<p> <p>See also <a href="qwidget.html#minimumSize-prop">minimumSize</a> and <a href="qwidget.html#minimumHeight-prop">minimumHeight</a>. + +<p>Set this property's value with <a href="qwidget.html#setMinimumWidth">setMinimumWidth</a>() and get this property's value with <a href="qwidget.html#minimumWidth">minimumWidth</a>(). +</doc> +</property> +<property> + <name>QWidget::mouseTracking</name> + <doc href="qwidget.html#mouseTracking-prop"> +<p>This property holds whether mouse tracking is enabled for the widget. +<p>If mouse tracking is disabled (the default), the widget only +receives mouse move events when at least one mouse button is +pressed while the mouse is being moved. +<p> If mouse tracking is enabled, the widget receives mouse move +events even if no buttons are pressed. +<p> <p>See also <a href="qwidget.html#mouseMoveEvent">mouseMoveEvent</a>() and <a href="qapplication.html#setGlobalMouseTracking">QApplication::setGlobalMouseTracking</a>(). + +<p>Set this property's value with <a href="qwidget.html#setMouseTracking">setMouseTracking</a>() and get this property's value with <a href="qwidget.html#hasMouseTracking">hasMouseTracking</a>(). +</doc> +</property> +<property> + <name>QWidget::ownCursor</name> + <doc href="qwidget.html#ownCursor-prop"> +<p>This property holds whether the widget uses its own cursor. +<p>If FALSE, the widget uses its parent widget's cursor. +<p> <p>See also <a href="qwidget.html#cursor-prop">cursor</a>. + +<p>Get this property's value with <a href="qwidget.html#ownCursor">ownCursor</a>(). +</doc> +</property> +<property> + <name>QWidget::ownFont</name> + <doc href="qwidget.html#ownFont-prop"> +<p>This property holds whether the widget uses its own font. +<p>If FALSE, the widget uses its parent widget's font. +<p> <p>See also <a href="qwidget.html#font-prop">font</a>. + +<p>Get this property's value with <a href="qwidget.html#ownFont">ownFont</a>(). +</doc> +</property> +<property> + <name>QWidget::ownPalette</name> + <doc href="qwidget.html#ownPalette-prop"> +<p>This property holds whether the widget uses its own palette. +<p>If FALSE, the widget uses its parent widget's palette. +<p> <p>See also <a href="qwidget.html#palette-prop">palette</a>. + +<p>Get this property's value with <a href="qwidget.html#ownPalette">ownPalette</a>(). +</doc> +</property> +<property> + <name>QWidget::palette</name> + <doc href="qwidget.html#palette-prop"> +<p>This property holds the widget's palette. +<p>As long as no special palette has been set, or after <a href="qwidget.html#unsetPalette">unsetPalette</a>() +has been called, this is either a special palette for the widget +class, the parent's palette or (if this widget is a top level +widget), the default application palette. +<p> Instead of defining an entirely new palette, you can also use the +<a href="qwidget.html#paletteBackgroundColor-prop">paletteBackgroundColor</a>, +<a href="qwidget.html#paletteBackgroundPixmap-prop">paletteBackgroundPixmap</a> and +<a href="qwidget.html#paletteForegroundColor-prop">paletteForegroundColor</a> +convenience properties to change a widget's +background and foreground appearance only. +<p> <p>See also <a href="qwidget.html#ownPalette-prop">ownPalette</a>, <a href="qwidget.html#colorGroup-prop">colorGroup</a>, and <a href="qapplication.html#palette">QApplication::palette</a>(). + +<p>Set this property's value with <a href="qwidget.html#setPalette">setPalette</a>(), get this property's value with <a href="qwidget.html#palette">palette</a>(), and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>(). +</doc> +</property> +<property> + <name>QWidget::paletteBackgroundColor</name> + <doc href="qwidget.html#paletteBackgroundColor-prop"> +<p>This property holds the background color of the widget. +<p>The palette background color is usually set implicitly by +<a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>(), although it can also be set explicitly by +<a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>(). setPaletteBackgroundColor() is a +convenience function that creates and sets a modified <a href="qpalette.html">QPalette</a> +with <a href="qwidget.html#setPalette">setPalette</a>(). The palette is modified according to the +widget's background mode. For example, if the background mode is +<a href="qt.html#BackgroundMode-enum">PaletteButton</a> the color used for the palette's <a href="qcolorgroup.html#ColorRole-enum">QColorGroup::Button</a> color entry is set. +<p> If there is a background pixmap (set using +<a href="qwidget.html#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>()), then the return value of this +function is indeterminate. +<p> <p>See also <a href="qwidget.html#paletteBackgroundPixmap-prop">paletteBackgroundPixmap</a>, <a href="qwidget.html#paletteForegroundColor-prop">paletteForegroundColor</a>, <a href="qwidget.html#palette-prop">palette</a>, and <a href="qwidget.html#colorGroup-prop">colorGroup</a>. + +<p>Set this property's value with <a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>(), get this property's value with <a href="qwidget.html#paletteBackgroundColor">paletteBackgroundColor</a>(), and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>(). +</doc> +</property> +<property> + <name>QWidget::paletteBackgroundPixmap</name> + <doc href="qwidget.html#paletteBackgroundPixmap-prop"> +<p>This property holds the background pixmap of the widget. +<p>The palette background pixmap is usually set implicitly by +<a href="qwidget.html#setBackgroundMode">setBackgroundMode</a>(), although it can also be set explicitly by +<a href="qwidget.html#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>(). setPaletteBackgroundPixmap() is a +convenience function that creates and sets a modified <a href="qpalette.html">QPalette</a> +with <a href="qwidget.html#setPalette">setPalette</a>(). The palette is modified according to the +widget's background mode. For example, if the background mode is +<a href="qt.html#BackgroundMode-enum">PaletteButton</a> the pixmap used for the palette's +<a href="qcolorgroup.html#ColorRole-enum">QColorGroup::Button</a> color entry is set. +<p> If there is a plain background color (set using +<a href="qwidget.html#setPaletteBackgroundColor">setPaletteBackgroundColor</a>()), then this function returns 0. +<p> <p>See also <a href="qwidget.html#paletteBackgroundColor-prop">paletteBackgroundColor</a>, <a href="qwidget.html#paletteForegroundColor-prop">paletteForegroundColor</a>, <a href="qwidget.html#palette-prop">palette</a>, and <a href="qwidget.html#colorGroup-prop">colorGroup</a>. + +<p>Set this property's value with <a href="qwidget.html#setPaletteBackgroundPixmap">setPaletteBackgroundPixmap</a>(), get this property's value with <a href="qwidget.html#paletteBackgroundPixmap">paletteBackgroundPixmap</a>(), and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>(). +</doc> +</property> +<property> + <name>QWidget::paletteForegroundColor</name> + <doc href="qwidget.html#paletteForegroundColor-prop"> +<p>This property holds the foreground color of the widget. +<p>setPaletteForegroundColor() is a convenience function that creates +and sets a modified <a href="qpalette.html">QPalette</a> with <a href="qwidget.html#setPalette">setPalette</a>(). The palette is +modified according to the widget's <em>background mode</em>. For +example, if the background mode is <a href="qt.html#BackgroundMode-enum">PaletteButton</a> the palette entry +<a href="qcolorgroup.html#ColorRole-enum">QColorGroup::ButtonText</a> is set to color. +<p> <p>See also <a href="qwidget.html#palette-prop">palette</a>, <a href="qapplication.html#setPalette">QApplication::setPalette</a>(), <a href="qwidget.html#backgroundMode-prop">backgroundMode</a>, <a href="qwidget.html#foregroundColor">foregroundColor</a>(), <a href="qwidget.html#backgroundMode-prop">backgroundMode</a>, and <a href="qwidget.html#setEraseColor">setEraseColor</a>(). + +<p>Set this property's value with <a href="qwidget.html#setPaletteForegroundColor">setPaletteForegroundColor</a>(), get this property's value with <a href="qwidget.html#paletteForegroundColor">paletteForegroundColor</a>(), and reset this property's value with <a href="qwidget.html#unsetPalette">unsetPalette</a>(). +</doc> +</property> +<property> + <name>QWidget::pos</name> + <doc href="qwidget.html#pos-prop"> +<p>This property holds the position of the widget within its parent widget. +<p>If the widget is a top-level widget, the position is that of the +widget on the desktop, including its frame. +<p> When changing the position, the widget, if visible, receives a +move event (<a href="qwidget.html#moveEvent">moveEvent</a>()) immediately. If the widget is not +currently visible, it is guaranteed to receive an event before it +is shown. +<p> <a href="qwidget.html#move">move</a>() is virtual, and all other overloaded move() implementations +in Qt call it. +<p> <b>Warning:</b> Calling move() or <a href="qwidget.html#setGeometry">setGeometry</a>() inside moveEvent() can +lead to infinite recursion. +<p> See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of top-level widget geometry. +<p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#x-prop">x</a>, and <a href="qwidget.html#y-prop">y</a>. + +<p>Set this property's value with <a href="qwidget.html#move">move</a>() and get this property's value with <a href="qwidget.html#pos">pos</a>(). +</doc> +</property> +<property> + <name>QWidget::rect</name> + <doc href="qwidget.html#rect-prop"> +<p>This property holds the internal geometry of the widget excluding any window frame. +<p>The rect property equals <a href="qrect.html">QRect</a>(0, 0, <a href="qwidget.html#width">width</a>(), <a href="qwidget.html#height">height</a>()). +<p> See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of top-level widget geometry. +<p> <p>See also <a href="qwidget.html#size-prop">size</a>. + +<p>Get this property's value with <a href="qwidget.html#rect">rect</a>(). +</doc> +</property> +<property> + <name>QWidget::shown</name> + <doc href="qwidget.html#shown-prop"> +<p>This property holds whether the widget is shown. +<p>If TRUE, the widget is visible or would become visible if all its +ancestors became visible. +<p> <p>See also <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#visible-prop">visible</a>, <a href="qwidget.html#isVisibleTo">isVisibleTo</a>(), and <a href="qwidget.html#hidden-prop">hidden</a>. + +<p>Set this property's value with <a href="qwidget.html#setShown">setShown</a>() and get this property's value with <a href="qwidget.html#isShown">isShown</a>(). +</doc> +</property> +<property> + <name>QWidget::size</name> + <doc href="qwidget.html#size-prop"> +<p>This property holds the size of the widget excluding any window frame. +<p>When resizing, the widget, if visible, receives a resize event +(<a href="qwidget.html#resizeEvent">resizeEvent</a>()) immediately. If the widget is not currently +visible, it is guaranteed to receive an event before it is shown. +<p> The size is adjusted if it lies outside the range defined by +<a href="qwidget.html#minimumSize">minimumSize</a>() and <a href="qwidget.html#maximumSize">maximumSize</a>(). Furthermore, the size is always +at least <a href="qsize.html">QSize</a>(1, 1). For toplevel widgets, the minimum size +might be larger, depending on the window manager. +<p> If you want a top-level window to have a fixed size, call +setResizeMode( QLayout::FreeResize ) on its layout. +<p> <a href="qwidget.html#resize">resize</a>() is virtual, and all other overloaded resize() +implementations in Qt call it. +<p> <b>Warning:</b> Calling resize() or <a href="qwidget.html#setGeometry">setGeometry</a>() inside resizeEvent() can +lead to infinite recursion. +<p> <p>See also <a href="qwidget.html#pos-prop">pos</a>, <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, <a href="qwidget.html#maximumSize-prop">maximumSize</a>, and <a href="qwidget.html#resizeEvent">resizeEvent</a>(). + +<p>Set this property's value with <a href="qwidget.html#resize">resize</a>() and get this property's value with <a href="qwidget.html#size">size</a>(). +</doc> +</property> +<property> + <name>QWidget::sizeHint</name> + <doc href="qwidget.html#sizeHint-prop"> +<p>This property holds the recommended size for the widget. +<p>If the value of this property is an invalid size, no size is +recommended. +<p> The default implementation of <a href="qwidget.html#sizeHint">sizeHint</a>() returns an invalid size +if there is no layout for this widget, and returns the layout's +preferred size otherwise. +<p> <p>See also <a href="qsize.html#isValid">QSize::isValid</a>(), <a href="qwidget.html#minimumSizeHint-prop">minimumSizeHint</a>, <a href="qwidget.html#sizePolicy-prop">sizePolicy</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, and <a href="qwidget.html#updateGeometry">updateGeometry</a>(). + +<p>Get this property's value with <a href="qwidget.html#sizeHint">sizeHint</a>(). +</doc> +</property> +<property> + <name>QWidget::sizeIncrement</name> + <doc href="qwidget.html#sizeIncrement-prop"> +<p>This property holds the size increment of the widget. +<p>When the user resizes the window, the size will move in steps of +<a href="qwidget.html#sizeIncrement">sizeIncrement</a>().<a href="qwidget.html#width">width</a>() pixels horizontally and +sizeIncrement.<a href="qwidget.html#height">height</a>() pixels vertically, with <a href="qwidget.html#baseSize">baseSize</a>() as the +basis. Preferred widget sizes are for non-negative integers <em>i</em> +and <em>j</em>: +<pre> + <a href="qwidget.html#width-prop">width</a> = <a href="qwidget.html#baseSize">baseSize</a>().width() + i * sizeIncrement().width(); + <a href="qwidget.html#height-prop">height</a> = <a href="qwidget.html#baseSize">baseSize</a>().height() + j * sizeIncrement().height(); + </pre> + +<p> Note that while you can set the size increment for all widgets, it +only affects top-level widgets. +<p> <b>Warning:</b> The size increment has no effect under Windows, and may +be disregarded by the window manager on X. +<p> <p>See also <a href="qwidget.html#size-prop">size</a>, <a href="qwidget.html#minimumSize-prop">minimumSize</a>, and <a href="qwidget.html#maximumSize-prop">maximumSize</a>. + +<p>Set this property's value with <a href="qwidget.html#setSizeIncrement">setSizeIncrement</a>() and get this property's value with <a href="qwidget.html#sizeIncrement">sizeIncrement</a>(). +</doc> +</property> +<property> + <name>QWidget::sizePolicy</name> + <doc href="qwidget.html#sizePolicy-prop"> +<p>This property holds the default layout behavior of the widget. +<p>If there is a <a href="qlayout.html">QLayout</a> that manages this widget's children, the +size policy specified by that layout is used. If there is no such +QLayout, the result of this function is used. +<p> The default policy is Preferred/Preferred, which means that the +widget can be freely resized, but prefers to be the size +<a href="qwidget.html#sizeHint">sizeHint</a>() returns. Button-like widgets set the size policy to +specify that they may stretch horizontally, but are fixed +vertically. The same applies to lineedit controls (such as +<a href="qlineedit.html">QLineEdit</a>, <a href="qspinbox.html">QSpinBox</a> or an editable <a href="qcombobox.html">QComboBox</a>) and other +horizontally orientated widgets (such as <a href="qprogressbar.html">QProgressBar</a>). +<a href="qtoolbutton.html">QToolButton</a>'s are normally square, so they allow growth in both +directions. Widgets that support different directions (such as +<a href="qslider.html">QSlider</a>, <a href="qscrollbar.html">QScrollBar</a> or <a href="qheader.html">QHeader</a>) specify stretching in the +respective direction only. Widgets that can provide scrollbars +(usually subclasses of <a href="qscrollview.html">QScrollView</a>) tend to specify that they can +use additional space, and that they can make do with less than +sizeHint(). +<p> <p>See also <a href="qwidget.html#sizeHint-prop">sizeHint</a>, <a href="qlayout.html">QLayout</a>, <a href="qsizepolicy.html">QSizePolicy</a>, and <a href="qwidget.html#updateGeometry">updateGeometry</a>(). + +<p>Set this property's value with <a href="qwidget.html#setSizePolicy">setSizePolicy</a>() and get this property's value with <a href="qwidget.html#sizePolicy">sizePolicy</a>(). +</doc> +</property> +<property> + <name>QWidget::underMouse</name> + <doc href="qwidget.html#underMouse-prop"> +<p>This property holds whether the widget is under the mouse cursor. +<p>This value is not updated properly during drag and drop +operations. +<p> <p>See also <a href="qevent.html#Type-enum">QEvent::Enter</a> and <a href="qevent.html#Type-enum">QEvent::Leave</a>. + +<p>Get this property's value with <a href="qwidget.html#hasMouse">hasMouse</a>(). +</doc> +</property> +<property> + <name>QWidget::updatesEnabled</name> + <doc href="qwidget.html#updatesEnabled-prop"> +<p>This property holds whether updates are enabled. +<p>Calling <a href="qwidget.html#update">update</a>() and <a href="qwidget.html#repaint">repaint</a>() has no effect if updates are +disabled. Paint events from the window system are processed +normally even if updates are disabled. +<p> <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>() is normally used to disable updates for a +short period of time, for instance to avoid screen flicker during +large changes. +<p> Example: +<pre> + <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>( FALSE ); + bigVisualChanges(); + <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>( TRUE ); + <a href="qwidget.html#repaint">repaint</a>(); + </pre> + +<p> <p>See also <a href="qwidget.html#update">update</a>(), <a href="qwidget.html#repaint">repaint</a>(), and <a href="qwidget.html#paintEvent">paintEvent</a>(). + +<p>Set this property's value with <a href="qwidget.html#setUpdatesEnabled">setUpdatesEnabled</a>() and get this property's value with <a href="qwidget.html#isUpdatesEnabled">isUpdatesEnabled</a>(). +</doc> +</property> +<property> + <name>QWidget::visible</name> + <doc href="qwidget.html#visible-prop"> +<p>This property holds whether the widget is visible. +<p>Calling <a href="qwidget.html#show">show</a>() sets the widget to visible status if all its parent +widgets up to the top-level widget are visible. If an ancestor is +not visible, the widget won't become visible until all its +ancestors are shown. +<p> Calling <a href="qwidget.html#hide">hide</a>() hides a widget explicitly. An explicitly hidden +widget will never become visible, even if all its ancestors become +visible, unless you show it. +<p> A widget receives show and hide events when its visibility status +changes. Between a hide and a show event, there is no need to +waste CPU cycles preparing or displaying information to the user. +A video application, for example, might simply stop generating new +frames. +<p> A widget that happens to be obscured by other windows on the +screen is considered to be visible. The same applies to iconified +top-level widgets and windows that exist on another virtual +desktop (on platforms that support this concept). A widget +receives spontaneous show and hide events when its mapping status +is changed by the window system, e.g. a spontaneous hide event +when the user minimizes the window, and a spontaneous show event +when the window is restored again. +<p> <p>See also <a href="qwidget.html#show">show</a>(), <a href="qwidget.html#hide">hide</a>(), <a href="qwidget.html#hidden-prop">hidden</a>, <a href="qwidget.html#isVisibleTo">isVisibleTo</a>(), <a href="qwidget.html#minimized-prop">minimized</a>, <a href="qwidget.html#showEvent">showEvent</a>(), and <a href="qwidget.html#hideEvent">hideEvent</a>(). + +<p>Get this property's value with <a href="qwidget.html#isVisible">isVisible</a>(). +</doc> +</property> +<property> + <name>QWidget::visibleRect</name> + <doc href="qwidget.html#visibleRect-prop"> +<p>This property holds the visible rectangle. +<p><b>This property is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. +<p> No longer necessary, you can simply call <a href="qwidget.html#repaint">repaint</a>(). If you do not +need the rectangle for repaint(), use <a href="qwidget.html#clipRegion">clipRegion</a>() instead. + +<p>Get this property's value with <a href="qwidget.html#visibleRect">visibleRect</a>(). +</doc> +</property> +<property> + <name>QWidget::width</name> + <doc href="qwidget.html#width-prop"> +<p>This property holds the width of the widget excluding any window frame. +<p>See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of top-level widget geometry. +<p> <p>See also <a href="qwidget.html#geometry-prop">geometry</a>, <a href="qwidget.html#height-prop">height</a>, and <a href="qwidget.html#size-prop">size</a>. + +<p>Get this property's value with <a href="qwidget.html#width">width</a>(). +</doc> +</property> +<property> + <name>QWidget::windowOpacity</name> + <doc href="qwidget.html#windowOpacity-prop"> +<p>This property holds the level of opacity for the window. +<p>The valid range of opacity is from 1.0 (completely opaque) to +0.0 (completely transparent). +<p> By default the value of this property is 1.0. +<p> This feature is only present on Mac OS X and Windows 2000 and up. +<p> <b>Warning:</b> Changing this property from opaque to transparent might issue a +paint event that needs to be processed before the window is displayed +correctly. This affects mainly the use of <a href="qpixmap.html#grabWindow">QPixmap::grabWindow</a>(). Also note +that semi-transparent windows update and resize significantely slower than +opaque windows. + +<p>Set this property's value with <a href="qwidget.html#setWindowOpacity">setWindowOpacity</a>() and get this property's value with <a href="qwidget.html#windowOpacity">windowOpacity</a>(). +</doc> +</property> +<property> + <name>QWidget::x</name> + <doc href="qwidget.html#x-prop"> <p>This property holds the x coordinate of the widget relative to its parent including any window frame. +<p>See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of top-level widget geometry. +<p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#y-prop">y</a>, and <a href="qwidget.html#pos-prop">pos</a>. + +<p>Get this property's value with <a href="qwidget.html#x">x</a>(). +</doc> +</property> +<property> + <name>QWidget::y</name> + <doc href="qwidget.html#y-prop"> +<p>This property holds the y coordinate of the widget relative to its parent and including any window frame. +<p>See the <a href="geometry.html">Window Geometry documentation</a> +for an overview of top-level widget geometry. +<p> <p>See also <a href="qwidget.html#frameGeometry-prop">frameGeometry</a>, <a href="qwidget.html#x-prop">x</a>, and <a href="qwidget.html#pos-prop">pos</a>. + +<p>Get this property's value with <a href="qwidget.html#y">y</a>(). +</doc> +</property> +<property> + <name>QWizard::titleFont</name> + <doc href="qwizard.html#titleFont-prop"> +<p>This property holds the font used for page titles. +<p>The default is <a href="qapplication.html#font">QApplication::font</a>(). + +<p>Set this property's value with <a href="qwizard.html#setTitleFont">setTitleFont</a>() and get this property's value with <a href="qwizard.html#titleFont">titleFont</a>(). +</doc> +</property> +<property> + <name>QWorkspace::scrollBarsEnabled</name> + <doc href="qworkspace.html#scrollBarsEnabled-prop"> +<p>This property holds whether the workspace provides scrollbars. +<p>If this property is set to TRUE, it is possible to resize child +windows over the right or the bottom edge out of the visible area +of the workspace. The workspace shows scrollbars to make it +possible for the user to access those windows. If this property is +set to FALSE (the default), resizing windows out of the visible +area of the workspace is not permitted. + +<p>Set this property's value with <a href="qworkspace.html#setScrollBarsEnabled">setScrollBarsEnabled</a>() and get this property's value with <a href="qworkspace.html#scrollBarsEnabled">scrollBarsEnabled</a>(). +</doc> +</property> +</PROP> |