/****************************************************************************+ −
**+ −
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).+ −
** All rights reserved.+ −
** Contact: Nokia Corporation (qt-info@nokia.com)+ −
**+ −
** This file is part of the QtGui module of the Qt Toolkit.+ −
**+ −
** $QT_BEGIN_LICENSE:LGPL$+ −
** No Commercial Usage+ −
** This file contains pre-release code and may not be distributed.+ −
** You may use this file in accordance with the terms and conditions+ −
** contained in the Technology Preview License Agreement accompanying+ −
** this package.+ −
**+ −
** GNU Lesser General Public License Usage+ −
** Alternatively, this file may be used under the terms of the GNU Lesser+ −
** General Public License version 2.1 as published by the Free Software+ −
** Foundation and appearing in the file LICENSE.LGPL included in the+ −
** packaging of this file. Please review the following information to+ −
** ensure the GNU Lesser General Public License version 2.1 requirements+ −
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.+ −
**+ −
** In addition, as a special exception, Nokia gives you certain additional+ −
** rights. These rights are described in the Nokia Qt LGPL Exception+ −
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.+ −
**+ −
** If you have questions regarding the use of this file, please contact+ −
** Nokia at qt-info@nokia.com.+ −
**+ −
**+ −
**+ −
**+ −
**+ −
**+ −
**+ −
**+ −
** $QT_END_LICENSE$+ −
**+ −
****************************************************************************/+ −
+ −
#include "qstyle.h"+ −
#include "qapplication.h"+ −
#include "qpainter.h"+ −
#include "qwidget.h"+ −
#include "qbitmap.h"+ −
#include "qpixmapcache.h"+ −
#include "qstyleoption.h"+ −
#include "private/qstyle_p.h"+ −
#ifndef QT_NO_DEBUG+ −
#include "qdebug.h"+ −
#endif+ −
+ −
#ifdef Q_WS_X11+ −
#include <qx11info_x11.h>+ −
#endif+ −
+ −
#include <limits.h>+ −
+ −
QT_BEGIN_NAMESPACE+ −
+ −
static const int MaxBits = 8 * sizeof(QSizePolicy::ControlType);+ −
+ −
static int unpackControlTypes(QSizePolicy::ControlTypes controls, QSizePolicy::ControlType *array)+ −
{+ −
if (!controls)+ −
return 0;+ −
+ −
// optimization: exactly one bit is set+ −
if ((controls & (controls - 1)) == 0) {+ −
array[0] = QSizePolicy::ControlType(uint(controls));+ −
return 1;+ −
}+ −
+ −
int count = 0;+ −
for (int i = 0; i < MaxBits; ++i) {+ −
if (uint bit = (controls & (0x1 << i)))+ −
array[count++] = QSizePolicy::ControlType(bit);+ −
}+ −
return count;+ −
}+ −
+ −
/*!+ −
\class QStyle+ −
\brief The QStyle class is an abstract base class that encapsulates the look and feel of a GUI.+ −
+ −
\ingroup appearance+ −
+ −
Qt contains a set of QStyle subclasses that emulate the styles of+ −
the different platforms supported by Qt (QWindowsStyle,+ −
QMacStyle, QMotifStyle, etc.). By default, these styles are built+ −
into the QtGui library. Styles can also be made available as+ −
plugins.+ −
+ −
Qt's built-in widgets use QStyle to perform nearly all of their+ −
drawing, ensuring that they look exactly like the equivalent+ −
native widgets. The diagram below shows a QComboBox in eight+ −
different styles.+ −
+ −
\img qstyle-comboboxes.png Eight combo boxes+ −
+ −
Topics:+ −
+ −
\tableofcontents+ −
+ −
\section1 Setting a Style+ −
+ −
The style of the entire application can be set using the+ −
QApplication::setStyle() function. It can also be specified by the+ −
user of the application, using the \c -style command-line option:+ −
+ −
\snippet doc/src/snippets/code/src_gui_styles_qstyle.cpp 0+ −
+ −
If no style is specified, Qt will choose the most appropriate+ −
style for the user's platform or desktop environment.+ −
+ −
A style can also be set on an individual widget using the+ −
QWidget::setStyle() function.+ −
+ −
\section1 Developing Style-Aware Custom Widgets+ −
+ −
If you are developing custom widgets and want them to look good on+ −
all platforms, you can use QStyle functions to perform parts of+ −
the widget drawing, such as drawItemText(), drawItemPixmap(),+ −
drawPrimitive(), drawControl(), and drawComplexControl().+ −
+ −
Most QStyle draw functions take four arguments:+ −
\list+ −
\o an enum value specifying which graphical element to draw+ −
\o a QStyleOption specifying how and where to render that element+ −
\o a QPainter that should be used to draw the element+ −
\o a QWidget on which the drawing is performed (optional)+ −
\endlist+ −
+ −
For example, if you want to draw a focus rectangle on your+ −
widget, you can write:+ −
+ −
\snippet doc/src/snippets/styles/styles.cpp 1+ −
+ −
QStyle gets all the information it needs to render the graphical+ −
element from QStyleOption. The widget is passed as the last+ −
argument in case the style needs it to perform special effects+ −
(such as animated default buttons on Mac OS X), but it isn't+ −
mandatory. In fact, you can use QStyle to draw on any paint+ −
device, not just widgets, by setting the QPainter properly.+ −
+ −
QStyleOption has various subclasses for the various types of+ −
graphical elements that can be drawn. For example,+ −
PE_FrameFocusRect expects a QStyleOptionFocusRect argument.+ −
+ −
To ensure that drawing operations are as fast as possible,+ −
QStyleOption and its subclasses have public data members. See the+ −
QStyleOption class documentation for details on how to use it.+ −
+ −
For convenience, Qt provides the QStylePainter class, which+ −
combines a QStyle, a QPainter, and a QWidget. This makes it+ −
possible to write+ −
+ −
\snippet doc/src/snippets/styles/styles.cpp 5+ −
\dots+ −
\snippet doc/src/snippets/styles/styles.cpp 7+ −
+ −
instead of+ −
+ −
\snippet doc/src/snippets/styles/styles.cpp 2+ −
\dots+ −
\snippet doc/src/snippets/styles/styles.cpp 3+ −
+ −
\section1 Creating a Custom Style+ −
+ −
You can create a custom look and feel for your application by+ −
creating a custom style. There are two approaches to creating a+ −
custom style. In the static approach, you either choose an+ −
existing QStyle class, subclass it, and reimplement virtual+ −
functions to provide the custom behavior, or you create an entire+ −
QStyle class from scratch. In the dynamic approach, you modify the+ −
behavior of your system style at runtime. The static approach is+ −
described below. The dynamic approach is described in QProxyStyle.+ −
+ −
The first step in the static approach is to pick one of the styles+ −
provided by Qt from which you will build your custom style. Your+ −
choice of QStyle class will depend on which style resembles your+ −
desired style the most. The most general class that you can use as+ −
a base is QCommonStyle (not QStyle). This is because Qt requires+ −
its styles to be \l{QCommonStyle}s.+ −
+ −
Depending on which parts of the base style you want to change,+ −
you must reimplement the functions that are used to draw those+ −
parts of the interface. To illustrate this, we will modify the+ −
look of the spin box arrows drawn by QWindowsStyle. The arrows+ −
are \e{primitive elements} that are drawn by the drawPrimitive()+ −
function, so we need to reimplement that function. We need the+ −
following class declaration:+ −
+ −
\snippet doc/src/snippets/customstyle/customstyle.h 0+ −
+ −
To draw its up and down arrows, QSpinBox uses the+ −
PE_IndicatorSpinUp and PE_IndicatorSpinDown primitive elements.+ −
Here's how to reimplement the drawPrimitive() function to draw+ −
them differently:+ −
+ −
\snippet doc/src/snippets/customstyle/customstyle.cpp 2+ −
\snippet doc/src/snippets/customstyle/customstyle.cpp 3+ −
\snippet doc/src/snippets/customstyle/customstyle.cpp 4+ −
+ −
Notice that we don't use the \c widget argument, except to pass it+ −
on to the QWindowStyle::drawPrimitive() function. As mentioned+ −
earlier, the information about what is to be drawn and how it+ −
should be drawn is specified by a QStyleOption object, so there is+ −
no need to ask the widget.+ −
+ −
If you need to use the \c widget argument to obtain additional+ −
information, be careful to ensure that it isn't 0 and that it is+ −
of the correct type before using it. For example:+ −
+ −
\snippet doc/src/snippets/customstyle/customstyle.cpp 0+ −
\dots+ −
\snippet doc/src/snippets/customstyle/customstyle.cpp 1+ −
+ −
When implementing a custom style, you cannot assume that the+ −
widget is a QSpinBox just because the enum value is called+ −
PE_IndicatorSpinUp or PE_IndicatorSpinDown.+ −
+ −
The documentation for the \l{widgets/styles}{Styles} example+ −
covers this topic in more detail.+ −
+ −
\warning Qt style sheets are currently not supported for custom QStyle+ −
subclasses. We plan to address this in some future release.+ −
+ −
+ −
\section1 Using a Custom Style+ −
+ −
There are several ways of using a custom style in a Qt+ −
application. The simplest way is to pass the custom style to the+ −
QApplication::setStyle() static function before creating the+ −
QApplication object:+ −
+ −
\snippet snippets/customstyle/main.cpp using a custom style+ −
+ −
You can call QApplication::setStyle() at any time, but by calling+ −
it before the constructor, you ensure that the user's preference,+ −
set using the \c -style command-line option, is respected.+ −
+ −
You may want to make your custom style available for use in other+ −
applications, which may not be yours and hence not available for+ −
you to recompile. The Qt Plugin system makes it possible to create+ −
styles as plugins. Styles created as plugins are loaded as shared+ −
objects at runtime by Qt itself. Please refer to the \link+ −
plugins-howto.html Qt Plugin\endlink documentation for more+ −
information on how to go about creating a style plugin.+ −
+ −
Compile your plugin and put it into Qt's \c plugins/styles+ −
directory. We now have a pluggable style that Qt can load+ −
automatically. To use your new style with existing applications,+ −
simply start the application with the following argument:+ −
+ −
\snippet doc/src/snippets/code/src_gui_styles_qstyle.cpp 1+ −
+ −
The application will use the look and feel from the custom style you+ −
implemented.+ −
+ −
\section1 Right-to-Left Desktops+ −
+ −
Languages written from right to left (such as Arabic and Hebrew)+ −
usually also mirror the whole layout of widgets, and require the+ −
light to come from the screen's top-right corner instead of+ −
top-left.+ −
+ −
If you create a custom style, you should take special care when+ −
drawing asymmetric elements to make sure that they also look+ −
correct in a mirrored layout. An easy way to test your styles is+ −
to run applications with the \c -reverse command-line option or+ −
to call QApplication::setLayoutDirection() in your \c main()+ −
function.+ −
+ −
Here are some things to keep in mind when making a style work well in a+ −
right-to-left environment:+ −
+ −
\list+ −
\o subControlRect() and subElementRect() return rectangles in screen coordinates+ −
\o QStyleOption::direction indicates in which direction the item should be drawn in+ −
\o If a style is not right-to-left aware it will display items as if it were left-to-right+ −
\o visualRect(), visualPos(), and visualAlignment() are helpful functions that will+ −
translate from logical to screen representations.+ −
\o alignedRect() will return a logical rect aligned for the current direction+ −
\endlist+ −
+ −
\section1 Styles in Item Views+ −
+ −
The painting of items in views is performed by a delegate. Qt's+ −
default delegate, QStyledItemDelegate, is also used for for calculating bounding+ −
rectangles of items, and their sub-elements for the various kind+ −
of item \l{Qt::ItemDataRole}{data roles}+ −
QStyledItemDelegate supports. See the QStyledItemDelegate class+ −
description to find out which datatypes and roles are supported. You+ −
can read more about item data roles in \l{Model/View Programming}.+ −
+ −
When QStyledItemDelegate paints its items, it draws+ −
CE_ItemViewItem, and calculates their size with CT_ItemViewItem.+ −
Note also that it uses SE_ItemViewItemText to set the size of+ −
editors. When implementing a style to customize drawing of item+ −
views, you need to check the implementation of QCommonStyle (and+ −
any other subclasses from which your style+ −
inherits). This way, you find out which and how+ −
other style elements are painted, and you can then reimplement the+ −
painting of elements that should be drawn differently.+ −
+ −
We include a small example where we customize the drawing of item+ −
backgrounds.+ −
+ −
\snippet doc/src/snippets/customviewstyle.cpp 0+ −
+ −
The primitive element PE_PanelItemViewItem is responsible for+ −
painting the background of items, and is called from+ −
\l{QCommonStyle}'s implementation of CE_ItemViewItem.+ −
+ −
To add support for drawing of new datatypes and item data roles,+ −
it is necessary to create a custom delegate. But if you only+ −
need to support the datatypes implemented by the default+ −
delegate, a custom style does not need an accompanying+ −
delegate. The QStyledItemDelegate class description gives more+ −
information on custom delegates.+ −
+ −
The drawing of item view headers is also done by the style, giving+ −
control over size of header items and row and column sizes.+ −
+ −
\sa QStyleOption, QStylePainter, {Styles Example},+ −
{Implementing Styles and Style Aware Widgets}, QStyledItemDelegate+ −
*/+ −
+ −
/*!+ −
Constructs a style object.+ −
*/+ −
QStyle::QStyle()+ −
: QObject(*new QStylePrivate)+ −
{+ −
Q_D(QStyle);+ −
d->proxyStyle = this;+ −
}+ −
+ −
/*!+ −
\internal+ −
+ −
Constructs a style object.+ −
*/+ −
QStyle::QStyle(QStylePrivate &dd)+ −
: QObject(dd)+ −
{+ −
Q_D(QStyle);+ −
d->proxyStyle = this;+ −
}+ −
+ −
/*!+ −
Destroys the style object.+ −
*/+ −
QStyle::~QStyle()+ −
{+ −
}+ −
+ −
/*!+ −
Initializes the appearance of the given \a widget.+ −
+ −
This function is called for every widget at some point after it+ −
has been fully created but just \e before it is shown for the very+ −
first time.+ −
+ −
Note that the default implementation does nothing. Reasonable+ −
actions in this function might be to call the+ −
QWidget::setBackgroundMode() function for the widget. Do not use+ −
the function to set, for example, the geometry; reimplementing+ −
this function do provide a back-door through which the appearance+ −
of a widget can be changed, but with Qt 4.0's style engine there+ −
is rarely necessary to implement this function; reimplement the+ −
drawItemPixmap(), drawItemText(), drawPrimitive(), etc. instead.+ −
+ −
The QWidget::inherits() function may provide enough information to+ −
allow class-specific customizations. But because new QStyle+ −
subclasses are expected to work reasonably with all current and \e+ −
future widgets, limited use of hard-coded customization is+ −
recommended.+ −
+ −
\sa unpolish()+ −
*/+ −
void QStyle::polish(QWidget * /* widget */)+ −
{+ −
}+ −
+ −
/*!+ −
Uninitialize the given \a{widget}'s appearance.+ −
+ −
This function is the counterpart to polish(). It is called for+ −
every polished widget whenever the style is dynamically changed;+ −
the former style has to unpolish its settings before the new style+ −
can polish them again.+ −
+ −
Note that unpolish() will only be called if the widget is+ −
destroyed. This can cause problems in some cases, e.g, if you+ −
remove a widget from the UI, cache it, and then reinsert it after+ −
the style has changed; some of Qt's classes cache their widgets.+ −
+ −
\sa polish()+ −
*/+ −
void QStyle::unpolish(QWidget * /* widget */)+ −
{+ −
}+ −
+ −
/*!+ −
\fn void QStyle::polish(QApplication * application)+ −
\overload+ −
+ −
Late initialization of the given \a application object.+ −
*/+ −
void QStyle::polish(QApplication * /* app */)+ −
{+ −
}+ −
+ −
/*!+ −
\fn void QStyle::unpolish(QApplication * application)+ −
\overload+ −
+ −
Uninitialize the given \a application.+ −
*/+ −
void QStyle::unpolish(QApplication * /* app */)+ −
{+ −
}+ −
+ −
/*!+ −
\fn void QStyle::polish(QPalette & palette)+ −
\overload+ −
+ −
Changes the \a palette according to style specific requirements+ −
for color palettes (if any).+ −
+ −
\sa QPalette, QApplication::setPalette()+ −
*/+ −
void QStyle::polish(QPalette & /* pal */)+ −
{+ −
}+ −
+ −
/*!+ −
\fn QRect QStyle::itemTextRect(const QFontMetrics &metrics, const QRect &rectangle, int alignment, bool enabled, const QString &text) const+ −
+ −
Returns the area within the given \a rectangle in which to draw+ −
the provided \a text according to the specified font \a metrics+ −
and \a alignment. The \a enabled parameter indicates whether or+ −
not the associated item is enabled.+ −
+ −
If the given \a rectangle is larger than the area needed to render+ −
the \a text, the rectangle that is returned will be offset within+ −
\a rectangle according to the specified \a alignment. For+ −
example, if \a alignment is Qt::AlignCenter, the returned+ −
rectangle will be centered within \a rectangle. If the given \a+ −
rectangle is smaller than the area needed, the returned rectangle+ −
will be the smallest rectangle large enough to render the \a text.+ −
+ −
\sa Qt::Alignment+ −
*/+ −
QRect QStyle::itemTextRect(const QFontMetrics &metrics, const QRect &rect, int alignment, bool enabled,+ −
const QString &text) const+ −
{+ −
QRect result;+ −
int x, y, w, h;+ −
rect.getRect(&x, &y, &w, &h);+ −
if (!text.isEmpty()) {+ −
result = metrics.boundingRect(x, y, w, h, alignment, text);+ −
if (!enabled && proxy()->styleHint(SH_EtchDisabledText)) {+ −
result.setWidth(result.width()+1);+ −
result.setHeight(result.height()+1);+ −
}+ −
} else {+ −
result = QRect(x, y, w, h);+ −
}+ −
return result;+ −
}+ −
+ −
/*!+ −
\fn QRect QStyle::itemPixmapRect(const QRect &rectangle, int alignment, const QPixmap &pixmap) const+ −
+ −
Returns the area within the given \a rectangle in which to draw+ −
the specified \a pixmap according to the defined \a alignment.+ −
*/+ −
QRect QStyle::itemPixmapRect(const QRect &rect, int alignment, const QPixmap &pixmap) const+ −
{+ −
QRect result;+ −
int x, y, w, h;+ −
rect.getRect(&x, &y, &w, &h);+ −
if ((alignment & Qt::AlignVCenter) == Qt::AlignVCenter)+ −
y += h/2 - pixmap.height()/2;+ −
else if ((alignment & Qt::AlignBottom) == Qt::AlignBottom)+ −
y += h - pixmap.height();+ −
if ((alignment & Qt::AlignRight) == Qt::AlignRight)+ −
x += w - pixmap.width();+ −
else if ((alignment & Qt::AlignHCenter) == Qt::AlignHCenter)+ −
x += w/2 - pixmap.width()/2;+ −
else if ((alignment & Qt::AlignLeft) != Qt::AlignLeft && QApplication::isRightToLeft())+ −
x += w - pixmap.width();+ −
result = QRect(x, y, pixmap.width(), pixmap.height());+ −
return result;+ −
}+ −
+ −
/*!+ −
\fn void QStyle::drawItemText(QPainter *painter, const QRect &rectangle, int alignment, const QPalette &palette, bool enabled, const QString& text, QPalette::ColorRole textRole) const+ −
+ −
Draws the given \a text in the specified \a rectangle using the+ −
provided \a painter and \a palette.+ −
+ −
The text is drawn using the painter's pen, and aligned and wrapped+ −
according to the specified \a alignment. If an explicit \a+ −
textRole is specified, the text is drawn using the \a palette's+ −
color for the given role. The \a enabled parameter indicates+ −
whether or not the item is enabled; when reimplementing this+ −
function, the \a enabled parameter should influence how the item is+ −
drawn.+ −
+ −
\sa Qt::Alignment, drawItemPixmap()+ −
*/+ −
void QStyle::drawItemText(QPainter *painter, const QRect &rect, int alignment, const QPalette &pal,+ −
bool enabled, const QString& text, QPalette::ColorRole textRole) const+ −
{+ −
if (text.isEmpty())+ −
return;+ −
QPen savedPen;+ −
if (textRole != QPalette::NoRole) {+ −
savedPen = painter->pen();+ −
painter->setPen(QPen(pal.brush(textRole), savedPen.widthF()));+ −
}+ −
if (!enabled) {+ −
if (proxy()->styleHint(SH_DitherDisabledText)) {+ −
QRect br;+ −
painter->drawText(rect, alignment, text, &br);+ −
painter->fillRect(br, QBrush(painter->background().color(), Qt::Dense5Pattern));+ −
return;+ −
} else if (proxy()->styleHint(SH_EtchDisabledText)) {+ −
QPen pen = painter->pen();+ −
painter->setPen(pal.light().color());+ −
painter->drawText(rect.adjusted(1, 1, 1, 1), alignment, text);+ −
painter->setPen(pen);+ −
}+ −
}+ −
painter->drawText(rect, alignment, text);+ −
if (textRole != QPalette::NoRole)+ −
painter->setPen(savedPen);+ −
}+ −
+ −
/*!+ −
\fn void QStyle::drawItemPixmap(QPainter *painter, const QRect &rectangle, int alignment,+ −
const QPixmap &pixmap) const+ −
+ −
Draws the given \a pixmap in the specified \a rectangle, according+ −
to the specified \a alignment, using the provided \a painter.+ −
+ −
\sa drawItemText()+ −
*/+ −
+ −
void QStyle::drawItemPixmap(QPainter *painter, const QRect &rect, int alignment,+ −
const QPixmap &pixmap) const+ −
{+ −
QRect aligned = alignedRect(QApplication::layoutDirection(), QFlag(alignment), pixmap.size(), rect);+ −
QRect inter = aligned.intersected(rect);+ −
+ −
painter->drawPixmap(inter.x(), inter.y(), pixmap, inter.x() - aligned.x(), inter.y() - aligned.y(), inter.width(), inter.height());+ −
}+ −
+ −
/*!+ −
\enum QStyle::PrimitiveElement+ −
+ −
This enum describes the various primitive elements. A+ −
primitive element is a common GUI element, such as a checkbox+ −
indicator or button bevel.+ −
+ −
\omitvalue PE_IndicatorViewItemCheck+ −
\value PE_FrameStatusBar Frame+ −
+ −
\value PE_PanelButtonCommand Button used to initiate an action, for+ −
example, a QPushButton.+ −
+ −
\value PE_FrameDefaultButton This frame around a default button, e.g. in a dialog.+ −
\value PE_PanelButtonBevel Generic panel with a button bevel.+ −
\value PE_PanelButtonTool Panel for a Tool button, used with QToolButton.+ −
\value PE_PanelLineEdit Panel for a QLineEdit.+ −
\value PE_IndicatorButtonDropDown Indicator for a drop down button, for example, a tool+ −
button that displays a menu.+ −
+ −
\value PE_FrameFocusRect Generic focus indicator.+ −
+ −
\value PE_IndicatorArrowUp Generic Up arrow.+ −
\value PE_IndicatorArrowDown Generic Down arrow.+ −
\value PE_IndicatorArrowRight Generic Right arrow.+ −
\value PE_IndicatorArrowLeft Generic Left arrow.+ −
+ −
\value PE_IndicatorSpinUp Up symbol for a spin widget, for example a QSpinBox.+ −
\value PE_IndicatorSpinDown Down symbol for a spin widget.+ −
\value PE_IndicatorSpinPlus Increase symbol for a spin widget.+ −
\value PE_IndicatorSpinMinus Decrease symbol for a spin widget.+ −
+ −
\value PE_IndicatorItemViewItemCheck On/off indicator for a view item.+ −
+ −
\value PE_IndicatorCheckBox On/off indicator, for example, a QCheckBox.+ −
\value PE_IndicatorRadioButton Exclusive on/off indicator, for example, a QRadioButton.+ −
+ −
\value PE_Q3DockWindowSeparator Item separator for Qt 3 compatible dock window+ −
and toolbar contents.+ −
\value PE_IndicatorDockWidgetResizeHandle Resize handle for dock windows.+ −
+ −
\value PE_Frame Generic frame+ −
\value PE_FrameMenu Frame for popup windows/menus; see also QMenu.+ −
\value PE_PanelMenuBar Panel for menu bars.+ −
\value PE_PanelScrollAreaCorner Panel at the bottom-right (or+ −
bottom-left) corner of a scroll area.+ −
+ −
\value PE_FrameDockWidget Panel frame for dock windows and toolbars.+ −
\value PE_FrameTabWidget Frame for tab widgets.+ −
\value PE_FrameLineEdit Panel frame for line edits.+ −
\value PE_FrameGroupBox Panel frame around group boxes.+ −
\value PE_FrameButtonBevel Panel frame for a button bevel.+ −
\value PE_FrameButtonTool Panel frame for a tool button.+ −
+ −
\value PE_IndicatorHeaderArrow Arrow used to indicate sorting on a list or table+ −
header.+ −
\value PE_FrameStatusBarItem Frame for an item of a status bar; see also QStatusBar.+ −
+ −
\value PE_FrameWindow Frame around a MDI window or a docking window.+ −
+ −
\value PE_Q3Separator Qt 3 compatible generic separator.+ −
+ −
\value PE_IndicatorMenuCheckMark Check mark used in a menu.+ −
+ −
\value PE_IndicatorProgressChunk Section of a progress bar indicator; see also QProgressBar.+ −
+ −
\value PE_Q3CheckListController Qt 3 compatible controller part of a list view item.+ −
\value PE_Q3CheckListIndicator Qt 3 compatible checkbox part of a list view item.+ −
\value PE_Q3CheckListExclusiveIndicator Qt 3 compatible radio button part of a list view item.+ −
+ −
\value PE_IndicatorBranch Lines used to represent the branch of a tree in a tree view.+ −
\value PE_IndicatorToolBarHandle The handle of a toolbar.+ −
\value PE_IndicatorToolBarSeparator The separator in a toolbar.+ −
\value PE_PanelToolBar The panel for a toolbar.+ −
\value PE_PanelTipLabel The panel for a tip label.+ −
\value PE_FrameTabBarBase The frame that is drawn for a tab bar, ususally drawn for a tab bar that isn't part of a tab widget.+ −
\value PE_IndicatorTabTear An indicator that a tab is partially scrolled out of the visible tab bar when there are many tabs.+ −
\value PE_IndicatorColumnViewArrow An arrow in a QColumnView.+ −
+ −
\value PE_Widget A plain QWidget.+ −
+ −
\value PE_CustomBase Base value for custom primitive elements.+ −
All values above this are reserved for custom use. Custom values+ −
must be greater than this value.+ −
+ −
\value PE_IndicatorItemViewItemDrop An indicator that is drawn to show where an item in an item view is about to be dropped+ −
during a drag-and-drop operation in an item view.+ −
\value PE_PanelItemViewItem The background for an item in an item view.+ −
\value PE_PanelItemViewRow The background of a row in an item view.+ −
+ −
\value PE_PanelStatusBar The panel for a status bar.+ −
+ −
\value PE_IndicatorTabClose The close button on a tab bar.+ −
\value PE_PanelMenu The panel for a menu.+ −
+ −
\sa drawPrimitive()+ −
*/+ −
+ −
/*!+ −
\typedef QStyle::SFlags+ −
\internal+ −
*/+ −
+ −
/*!+ −
\typedef QStyle::SCFlags+ −
\internal+ −
*/+ −
+ −
/*!+ −
\enum QStyle::StateFlag+ −
+ −
This enum describes flags that are used when drawing primitive+ −
elements.+ −
+ −
Note that not all primitives use all of these flags, and that the+ −
flags may mean different things to different items.+ −
+ −
\value State_None Indicates that the widget does not have a state.+ −
\value State_Active Indicates that the widget is active.+ −
\value State_AutoRaise Used to indicate if auto-raise appearance should be usd on a tool button.+ −
\value State_Children Used to indicate if an item view branch has children.+ −
\value State_DownArrow Used to indicate if a down arrow should be visible on the widget.+ −
\value State_Editing Used to indicate if an editor is opened on the widget.+ −
\value State_Enabled Used to indicate if the widget is enabled.+ −
\value State_HasEditFocus Used to indicate if the widget currently has edit focus.+ −
\value State_HasFocus Used to indicate if the widget has focus.+ −
\value State_Horizontal Used to indicate if the widget is laid out horizontally, for example. a tool bar.+ −
\value State_KeyboardFocusChange Used to indicate if the focus was changed with the keyboard, e.g., tab, backtab or shortcut.+ −
\value State_MouseOver Used to indicate if the widget is under the mouse.+ −
\value State_NoChange Used to indicate a tri-state checkbox.+ −
\value State_Off Used to indicate if the widget is not checked.+ −
\value State_On Used to indicate if the widget is checked.+ −
\value State_Raised Used to indicate if a button is raised.+ −
\value State_ReadOnly Used to indicate if a widget is read-only.+ −
\value State_Selected Used to indicate if a widget is selected.+ −
\value State_Item Used by item views to indicate if a horizontal branch should be drawn.+ −
\value State_Open Used by item views to indicate if the tree branch is open.+ −
\value State_Sibling Used by item views to indicate if a vertical line needs to be drawn (for siblings).+ −
\value State_Sunken Used to indicate if the widget is sunken or pressed.+ −
\value State_UpArrow Used to indicate if an up arrow should be visible on the widget.+ −
\value State_Mini Used to indicate a mini style Mac widget or button.+ −
\value State_Small Used to indicate a small style Mac widget or button.+ −
\omitvalue State_Window+ −
\omitvalue State_Bottom+ −
\omitvalue State_Default+ −
\omitvalue State_FocusAtBorder+ −
\omitvalue State_Top+ −
+ −
\sa drawPrimitive()+ −
*/+ −
+ −
/*!+ −
\fn void QStyle::drawPrimitive(PrimitiveElement element, const QStyleOption *option, \+ −
QPainter *painter, const QWidget *widget) const+ −
+ −
Draws the given primitive \a element with the provided \a painter using the style+ −
options specified by \a option.+ −
+ −
The \a widget argument is optional and may contain a widget that may+ −
aid in drawing the primitive element.+ −
+ −
The table below is listing the primitive elements and their+ −
associated style option subclasses. The style options contain all+ −
the parameters required to draw the elements, including+ −
QStyleOption::state which holds the style flags that are used when+ −
drawing. The table also describes which flags that are set when+ −
casting the given option to the appropriate subclass.+ −
+ −
Note that if a primitive element is not listed here, it is because+ −
it uses a plain QStyleOption object.+ −
+ −
\table+ −
\header \o Primitive Element \o QStyleOption Subclass \o Style Flag \o Remark+ −
\row \o \l PE_FrameFocusRect \o \l QStyleOptionFocusRect+ −
\o \l State_FocusAtBorder+ −
\o Whether the focus is is at the border or inside the widget.+ −
\row \o{1,2} \l PE_IndicatorCheckBox \o{1,2} \l QStyleOptionButton+ −
\o \l State_NoChange \o Indicates a "tri-state" checkbox.+ −
\row \o \l State_On \o Indicates the indicator is checked.+ −
\row \o \l PE_IndicatorRadioButton \o \l QStyleOptionButton+ −
\o \l State_On \o Indicates that a radio button is selected.+ −
\row \o{1,3} \l PE_Q3CheckListExclusiveIndicator, \l PE_Q3CheckListIndicator+ −
\o{1,3} \l QStyleOptionQ3ListView \o \l State_On+ −
\o Indicates whether or not the controller is selected.+ −
\row \o \l State_NoChange \o Indicates a "tri-state" controller.+ −
\row \o \l State_Enabled \o Indicates the controller is enabled.+ −
\row \o{1,4} \l PE_IndicatorBranch \o{1,4} \l QStyleOption+ −
\o \l State_Children \o Indicates that the control for expanding the tree to show child items, should be drawn.+ −
\row \o \l State_Item \o Indicates that a horizontal branch (to show a child item), should be drawn.+ −
\row \o \l State_Open \o Indicates that the tree branch is expanded.+ −
\row \o \l State_Sibling \o Indicates that a vertical line (to show a sibling item), should be drawn.+ −
\row \o \l PE_IndicatorHeaderArrow \o \l QStyleOptionHeader+ −
\o \l State_UpArrow \o Indicates that the arrow should be drawn up;+ −
otherwise it should be down.+ −
\row \o \l PE_FrameGroupBox, \l PE_Frame, \l PE_FrameLineEdit,+ −
\l PE_FrameMenu, \l PE_FrameDockWidget, \l PE_FrameWindow+ −
\o \l QStyleOptionFrame \o \l State_Sunken+ −
\o Indicates that the Frame should be sunken.+ −
\row \o \l PE_IndicatorToolBarHandle \o \l QStyleOption+ −
\o \l State_Horizontal \o Indicates that the window handle is horizontal+ −
instead of vertical.+ −
\row \o \l PE_Q3DockWindowSeparator \o \l QStyleOption+ −
\o \l State_Horizontal \o Indicates that the separator is horizontal+ −
instead of vertical.+ −
\row \o \l PE_IndicatorSpinPlus, \l PE_IndicatorSpinMinus, \l PE_IndicatorSpinUp,+ −
\l PE_IndicatorSpinDown,+ −
\o \l QStyleOptionSpinBox+ −
\o \l State_Sunken \o Indicates that the button is pressed.+ −
\row \o{1,5} \l PE_PanelButtonCommand+ −
\o{1,5} \l QStyleOptionButton+ −
\o \l State_Enabled \o Set if the button is enabled.+ −
\row \o \l State_HasFocus \o Set if the button has input focus.+ −
\row \o \l State_Raised \o Set if the button is not down, not on and not flat.+ −
\row \o \l State_On \o Set if the button is a toggle button and is toggled on.+ −
\row \o \l State_Sunken+ −
\o Set if the button is down (i.e., the mouse button or the+ −
space bar is pressed on the button).+ −
\endtable+ −
+ −
\sa drawComplexControl(), drawControl()+ −
*/+ −
+ −
/*!+ −
\enum QStyle::ControlElement+ −
+ −
This enum represents a control element. A control element is a+ −
part of a widget that performs some action or displays information+ −
to the user.+ −
+ −
\value CE_PushButton A QPushButton, draws CE_PushButtonBevel, CE_PushButtonLabel and PE_FrameFocusRect.+ −
\value CE_PushButtonBevel The bevel and default indicator of a QPushButton.+ −
\value CE_PushButtonLabel The label (an icon with text or pixmap) of a QPushButton.+ −
+ −
\value CE_DockWidgetTitle Dock window title.+ −
\value CE_Splitter Splitter handle; see also QSplitter.+ −
+ −
+ −
\value CE_CheckBox A QCheckBox, draws a PE_IndicatorCheckBox, a CE_CheckBoxLabel and a PE_FrameFocusRect.+ −
\value CE_CheckBoxLabel The label (text or pixmap) of a QCheckBox.+ −
+ −
\value CE_RadioButton A QRadioButton, draws a PE_IndicatorRadioButton, a CE_RadioButtonLabel and a PE_FrameFocusRect.+ −
\value CE_RadioButtonLabel The label (text or pixmap) of a QRadioButton.+ −
+ −
\value CE_TabBarTab The tab and label within a QTabBar.+ −
\value CE_TabBarTabShape The tab shape within a tab bar.+ −
\value CE_TabBarTabLabel The label within a tab.+ −
+ −
\value CE_ProgressBar A QProgressBar, draws CE_ProgressBarGroove, CE_ProgressBarContents and CE_ProgressBarLabel.+ −
\value CE_ProgressBarGroove The groove where the progress+ −
indicator is drawn in a QProgressBar.+ −
\value CE_ProgressBarContents The progress indicator of a QProgressBar.+ −
\value CE_ProgressBarLabel The text label of a QProgressBar.+ −
+ −
\value CE_ToolButtonLabel A tool button's label.+ −
+ −
\value CE_MenuBarItem A menu item in a QMenuBar.+ −
\value CE_MenuBarEmptyArea The empty area of a QMenuBar.+ −
+ −
\value CE_MenuItem A menu item in a QMenu.+ −
\value CE_MenuScroller Scrolling areas in a QMenu when the+ −
style supports scrolling.+ −
\value CE_MenuTearoff A menu item representing the tear off section of+ −
a QMenu.+ −
\value CE_MenuEmptyArea The area in a menu without menu items.+ −
\value CE_MenuHMargin The horizontal extra space on the left/right of a menu.+ −
\value CE_MenuVMargin The vertical extra space on the top/bottom of a menu.+ −
+ −
\value CE_Q3DockWindowEmptyArea The empty area of a QDockWidget.+ −
+ −
\value CE_ToolBoxTab The toolbox's tab and label within a QToolBox.+ −
\value CE_SizeGrip Window resize handle; see also QSizeGrip.+ −
+ −
\value CE_Header A header.+ −
\value CE_HeaderSection A header section.+ −
\value CE_HeaderLabel The header's label.+ −
+ −
\value CE_ScrollBarAddLine Scroll bar line increase indicator.+ −
(i.e., scroll down); see also QScrollBar.+ −
\value CE_ScrollBarSubLine Scroll bar line decrease indicator (i.e., scroll up).+ −
\value CE_ScrollBarAddPage Scolllbar page increase indicator (i.e., page down).+ −
\value CE_ScrollBarSubPage Scroll bar page decrease indicator (i.e., page up).+ −
\value CE_ScrollBarSlider Scroll bar slider.+ −
\value CE_ScrollBarFirst Scroll bar first line indicator (i.e., home).+ −
\value CE_ScrollBarLast Scroll bar last line indicator (i.e., end).+ −
+ −
\value CE_RubberBand Rubber band used in for example an icon view.+ −
+ −
\value CE_FocusFrame Focus frame that is style controlled.+ −
+ −
\value CE_ItemViewItem An item inside an item view.+ −
+ −
\value CE_CustomBase Base value for custom control elements;+ −
custom values must be greater than this value.+ −
\value CE_ComboBoxLabel The label of a non-editable QComboBox.+ −
\value CE_ToolBar A toolbar like QToolBar.+ −
\value CE_ToolBoxTabShape The toolbox's tab shape.+ −
\value CE_ToolBoxTabLabel The toolbox's tab label.+ −
\value CE_HeaderEmptyArea The area of a header view where there are no header sections.+ −
+ −
\value CE_ShapedFrame The frame with the shape specified in the QStyleOptionFrameV3; see QFrame.+ −
+ −
\omitvalue CE_ColumnViewGrip+ −
+ −
\sa drawControl()+ −
*/+ −
+ −
/*!+ −
\fn void QStyle::drawControl(ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget) const+ −
+ −
Draws the given \a element with the provided \a painter with the+ −
style options specified by \a option.+ −
+ −
The \a widget argument is optional and can be used as aid in+ −
drawing the control. The \a option parameter is a pointer to a+ −
QStyleOption object that can be cast to the correct subclass+ −
using the qstyleoption_cast() function.+ −
+ −
The table below is listing the control elements and their+ −
associated style option subclass. The style options contain all+ −
the parameters required to draw the controls, including+ −
QStyleOption::state which holds the style flags that are used when+ −
drawing. The table also describes which flags that are set when+ −
casting the given option to the appropriate subclass.+ −
+ −
Note that if a control element is not listed here, it is because+ −
it uses a plain QStyleOption object.+ −
+ −
\table+ −
\header \o Control Element \o QStyleOption Subclass \o Style Flag \o Remark+ −
\row \o{1,5} \l CE_MenuItem, \l CE_MenuBarItem+ −
\o{1,5} \l QStyleOptionMenuItem+ −
\o \l State_Selected \o The menu item is currently selected item.+ −
\row \o \l State_Enabled \o The item is enabled.+ −
\row \o \l State_DownArrow \o Indicates that a scroll down arrow should be drawn.+ −
\row \o \l State_UpArrow \o Indicates that a scroll up arrow should be drawn+ −
\row \o \l State_HasFocus \o Set if the menu bar has input focus.+ −
+ −
\row \o{1,5} \l CE_PushButton, \l CE_PushButtonBevel, \l CE_PushButtonLabel+ −
\o{1,5} \l QStyleOptionButton+ −
\o \l State_Enabled \o Set if the button is enabled.+ −
\row \o \l State_HasFocus \o Set if the button has input focus.+ −
\row \o \l State_Raised \o Set if the button is not down, not on and not flat.+ −
\row \o \l State_On \o Set if the button is a toggle button and is toggled on.+ −
\row \o \l State_Sunken+ −
\o Set if the button is down (i.e., the mouse button or the+ −
space bar is pressed on the button).+ −
+ −
\row \o{1,6} \l CE_RadioButton, \l CE_RadioButtonLabel,+ −
\l CE_CheckBox, \l CE_CheckBoxLabel+ −
\o{1,6} \l QStyleOptionButton+ −
\o \l State_Enabled \o Set if the button is enabled.+ −
\row \o \l State_HasFocus \o Set if the button has input focus.+ −
\row \o \l State_On \o Set if the button is checked.+ −
\row \o \l State_Off \o Set if the button is not checked.+ −
\row \o \l State_NoChange \o Set if the button is in the NoChange state.+ −
\row \o \l State_Sunken+ −
\o Set if the button is down (i.e., the mouse button or+ −
the space bar is pressed on the button).+ −
+ −
\row \o{1,2} \l CE_ProgressBarContents, \l CE_ProgressBarLabel,+ −
\l CE_ProgressBarGroove+ −
\o{1,2} \l QStyleOptionProgressBar+ −
\o \l State_Enabled \o Set if the progress bar is enabled.+ −
\row \o \l State_HasFocus \o Set if the progress bar has input focus.+ −
+ −
\row \o \l CE_Header, \l CE_HeaderSection, \l CE_HeaderLabel \o \l QStyleOptionHeader \o \o+ −
+ −
\row \o{1,3} \l CE_TabBarTab, CE_TabBarTabShape, CE_TabBarTabLabel+ −
\o{1,3} \l QStyleOptionTab+ −
\o \l State_Enabled \o Set if the tab bar is enabled.+ −
\row \o \l State_Selected \o The tab bar is the currently selected tab bar.+ −
\row \o \l State_HasFocus \o Set if the tab bar tab has input focus.+ −
+ −
\row \o{1,7} \l CE_ToolButtonLabel+ −
\o{1,7} \l QStyleOptionToolButton+ −
\o \l State_Enabled \o Set if the tool button is enabled.+ −
\row \o \l State_HasFocus \o Set if the tool button has input focus.+ −
\row \o \l State_Sunken+ −
\o Set if the tool button is down (i.e., a mouse button or+ −
the space bar is pressed).+ −
\row \o \l State_On \o Set if the tool button is a toggle button and is toggled on.+ −
\row \o \l State_AutoRaise \o Set if the tool button has auto-raise enabled.+ −
\row \o \l State_MouseOver \o Set if the mouse pointer is over the tool button.+ −
\row \o \l State_Raised \o Set if the button is not down and is not on.+ −
+ −
\row \o \l CE_ToolBoxTab \o \l QStyleOptionToolBox+ −
\o \l State_Selected \o The tab is the currently selected tab.+ −
\row \o{1,3} \l CE_HeaderSection \o{1,3} \l QStyleOptionHeader+ −
\o \l State_Sunken \o Indicates that the section is pressed.+ −
\row \o \l State_UpArrow \o Indicates that the sort indicator should be pointing up.+ −
\row \o \l State_DownArrow \o Indicates that the sort indicator should be pointing down.+ −
\endtable+ −
+ −
\sa drawPrimitive(), drawComplexControl()+ −
*/+ −
+ −
/*!+ −
\enum QStyle::SubElement+ −
+ −
This enum represents a sub-area of a widget. Style implementations+ −
use these areas to draw the different parts of a widget.+ −
+ −
\value SE_PushButtonContents Area containing the label (icon+ −
with text or pixmap).+ −
\value SE_PushButtonFocusRect Area for the focus rect (usually+ −
larger than the contents rect).+ −
\value SE_PushButtonLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_CheckBoxIndicator Area for the state indicator (e.g., check mark).+ −
\value SE_CheckBoxContents Area for the label (text or pixmap).+ −
\value SE_CheckBoxFocusRect Area for the focus indicator.+ −
\value SE_CheckBoxClickRect Clickable area, defaults to SE_CheckBoxFocusRect.+ −
\value SE_CheckBoxLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_DateTimeEditLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_RadioButtonIndicator Area for the state indicator.+ −
\value SE_RadioButtonContents Area for the label.+ −
\value SE_RadioButtonFocusRect Area for the focus indicator.+ −
\value SE_RadioButtonClickRect Clickable area, defaults to SE_RadioButtonFocusRect.+ −
\value SE_RadioButtonLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_ComboBoxFocusRect Area for the focus indicator.+ −
+ −
\value SE_SliderFocusRect Area for the focus indicator.+ −
\value SE_SliderLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_SpinBoxLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_Q3DockWindowHandleRect Area for the tear-off handle.+ −
+ −
\value SE_ProgressBarGroove Area for the groove.+ −
\value SE_ProgressBarContents Area for the progress indicator.+ −
\value SE_ProgressBarLabel Area for the text label.+ −
\value SE_ProgressBarLayoutItem Area that counts for the parent layout.+ −
+ −
\omitvalue SE_DialogButtonAccept+ −
\omitvalue SE_DialogButtonReject+ −
\omitvalue SE_DialogButtonApply+ −
\omitvalue SE_DialogButtonHelp+ −
\omitvalue SE_DialogButtonAll+ −
\omitvalue SE_DialogButtonRetry+ −
\omitvalue SE_DialogButtonAbort+ −
\omitvalue SE_DialogButtonIgnore+ −
\omitvalue SE_DialogButtonCustom+ −
\omitvalue SE_ViewItemCheckIndicator+ −
+ −
\value SE_FrameContents Area for a frame's contents.+ −
\value SE_ShapedFrameContents Area for a frame's contents using the shape in QStyleOptionFrameV3; see QFrame+ −
\value SE_FrameLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_HeaderArrow Area for the sort indicator for a header.+ −
\value SE_HeaderLabel Area for the label in a header.+ −
+ −
\value SE_LabelLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_LineEditContents Area for a line edit's contents.+ −
+ −
\value SE_TabWidgetLeftCorner Area for the left corner widget in a tab widget.+ −
\value SE_TabWidgetRightCorner Area for the right corner widget in a tab widget.+ −
\value SE_TabWidgetTabBar Area for the tab bar widget in a tab widget.+ −
\value SE_TabWidgetTabContents Area for the contents of the tab widget.+ −
\value SE_TabWidgetTabPane Area for the pane of a tab widget.+ −
\value SE_TabWidgetLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_ToolBoxTabContents Area for a toolbox tab's icon and label.+ −
+ −
\value SE_ToolButtonLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_ItemViewItemCheckIndicator Area for a view item's check mark.+ −
+ −
\value SE_TabBarTearIndicator Area for the tear indicator on a tab bar with scroll arrows.+ −
+ −
\value SE_TreeViewDisclosureItem Area for the actual disclosure item in a tree branch.+ −
+ −
\value SE_DialogButtonBoxLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_GroupBoxLayoutItem Area that counts for the parent layout.+ −
+ −
\value SE_CustomBase Base value for custom sub-elements.+ −
Custom values must be greater than this value.+ −
+ −
\value SE_DockWidgetFloatButton The float button of a dock+ −
widget.+ −
\value SE_DockWidgetTitleBarText The text bounds of the dock+ −
widgets title.+ −
\value SE_DockWidgetCloseButton The close button of a dock+ −
widget.+ −
\value SE_DockWidgetIcon The icon of a dock widget.+ −
\value SE_ComboBoxLayoutItem Area that counts for the parent layout.+ −
+ −
+ −
\value SE_ItemViewItemDecoration Area for a view item's decoration (icon).+ −
\value SE_ItemViewItemText Area for a view item's text.+ −
\value SE_ItemViewItemFocusRect Area for a view item's focus rect.+ −
+ −
\value SE_TabBarTabLeftButton Area for a widget on the left side of a tab in a tab bar.+ −
\value SE_TabBarTabRightButton Area for a widget on the right side of a tab in a tab bar.+ −
\value SE_TabBarTabText Area for the text on a tab in a tab bar.+ −
+ −
\value SE_ToolBarHandle Area for the handle of a tool bar.+ −
+ −
\sa subElementRect()+ −
*/+ −
+ −
/*!+ −
\fn QRect QStyle::subElementRect(SubElement element, const QStyleOption *option, const QWidget *widget) const+ −
+ −
Returns the sub-area for the given \a element as described in the+ −
provided style \a option. The returned rectangle is defined in+ −
screen coordinates.+ −
+ −
The \a widget argument is optional and can be used to aid+ −
determining the area. The QStyleOption object can be cast to the+ −
appropriate type using the qstyleoption_cast() function. See the+ −
table below for the appropriate \a option casts:+ −
+ −
\table+ −
\header \o Sub Element \o QStyleOption Subclass+ −
\row \o \l SE_PushButtonContents \o \l QStyleOptionButton+ −
\row \o \l SE_PushButtonFocusRect \o \l QStyleOptionButton+ −
\row \o \l SE_CheckBoxIndicator \o \l QStyleOptionButton+ −
\row \o \l SE_CheckBoxContents \o \l QStyleOptionButton+ −
\row \o \l SE_CheckBoxFocusRect \o \l QStyleOptionButton+ −
\row \o \l SE_RadioButtonIndicator \o \l QStyleOptionButton+ −
\row \o \l SE_RadioButtonContents \o \l QStyleOptionButton+ −
\row \o \l SE_RadioButtonFocusRect \o \l QStyleOptionButton+ −
\row \o \l SE_ComboBoxFocusRect \o \l QStyleOptionComboBox+ −
\row \o \l SE_Q3DockWindowHandleRect \o \l QStyleOptionQ3DockWindow+ −
\row \o \l SE_ProgressBarGroove \o \l QStyleOptionProgressBar+ −
\row \o \l SE_ProgressBarContents \o \l QStyleOptionProgressBar+ −
\row \o \l SE_ProgressBarLabel \o \l QStyleOptionProgressBar+ −
\endtable+ −
*/+ −
+ −
/*!+ −
\enum QStyle::ComplexControl+ −
+ −
This enum describes the available complex controls. Complex+ −
controls have different behavior depending upon where the user+ −
clicks on them or which keys are pressed.+ −
+ −
\value CC_SpinBox A spinbox, like QSpinBox.+ −
\value CC_ComboBox A combobox, like QComboBox.+ −
\value CC_ScrollBar A scroll bar, like QScrollBar.+ −
\value CC_Slider A slider, like QSlider.+ −
\value CC_ToolButton A tool button, like QToolButton.+ −
\value CC_TitleBar A Title bar, like those used in QMdiSubWindow.+ −
\value CC_Q3ListView Used for drawing the Q3ListView class.+ −
\value CC_GroupBox A group box, like QGroupBox.+ −
\value CC_Dial A dial, like QDial.+ −
\value CC_MdiControls The minimize, close, and normal+ −
button in the menu bar for a+ −
maximized MDI subwindow.+ −
+ −
\value CC_CustomBase Base value for custom complex controls. Custom+ −
values must be greater than this value.+ −
+ −
\sa SubControl drawComplexControl()+ −
*/+ −
+ −
/*!+ −
\enum QStyle::SubControl+ −
+ −
This enum describes the available sub controls. A subcontrol is a+ −
control element within a complex control (ComplexControl).+ −
+ −
\value SC_None Special value that matches no other sub control.+ −
+ −
\value SC_ScrollBarAddLine Scroll bar add line (i.e., down/right+ −
arrow); see also QScrollBar.+ −
\value SC_ScrollBarSubLine Scroll bar sub line (i.e., up/left arrow).+ −
\value SC_ScrollBarAddPage Scroll bar add page (i.e., page down).+ −
\value SC_ScrollBarSubPage Scroll bar sub page (i.e., page up).+ −
\value SC_ScrollBarFirst Scroll bar first line (i.e., home).+ −
\value SC_ScrollBarLast Scroll bar last line (i.e., end).+ −
\value SC_ScrollBarSlider Scroll bar slider handle.+ −
\value SC_ScrollBarGroove Special sub-control which contains the+ −
area in which the slider handle may move.+ −
+ −
\value SC_SpinBoxUp Spin widget up/increase; see also QSpinBox.+ −
\value SC_SpinBoxDown Spin widget down/decrease.+ −
\value SC_SpinBoxFrame Spin widget frame.+ −
\value SC_SpinBoxEditField Spin widget edit field.+ −
+ −
\value SC_ComboBoxEditField Combobox edit field; see also QComboBox.+ −
\value SC_ComboBoxArrow Combobox arrow button.+ −
\value SC_ComboBoxFrame Combobox frame.+ −
\value SC_ComboBoxListBoxPopup The reference rectangle for the combobox popup.+ −
Used to calculate the position of the popup.+ −
+ −
\value SC_SliderGroove Special sub-control which contains the area+ −
in which the slider handle may move.+ −
\value SC_SliderHandle Slider handle.+ −
\value SC_SliderTickmarks Slider tickmarks.+ −
+ −
\value SC_ToolButton Tool button (see also QToolButton).+ −
\value SC_ToolButtonMenu Sub-control for opening a popup menu in a+ −
tool button; see also Q3PopupMenu.+ −
+ −
\value SC_TitleBarSysMenu System menu button (i.e., restore, close, etc.).+ −
\value SC_TitleBarMinButton Minimize button.+ −
\value SC_TitleBarMaxButton Maximize button.+ −
\value SC_TitleBarCloseButton Close button.+ −
\value SC_TitleBarLabel Window title label.+ −
\value SC_TitleBarNormalButton Normal (restore) button.+ −
\value SC_TitleBarShadeButton Shade button.+ −
\value SC_TitleBarUnshadeButton Unshade button.+ −
\value SC_TitleBarContextHelpButton Context Help button.+ −
+ −
\value SC_Q3ListView The list view area.+ −
\value SC_Q3ListViewExpand Expand item (i.e., show/hide child items).+ −
+ −
\value SC_DialHandle The handle of the dial (i.e. what you use to control the dial).+ −
\value SC_DialGroove The groove for the dial.+ −
\value SC_DialTickmarks The tickmarks for the dial.+ −
+ −
\value SC_GroupBoxFrame The frame of a group box.+ −
\value SC_GroupBoxLabel The title of a group box.+ −
\value SC_GroupBoxCheckBox The optional check box of a group box.+ −
\value SC_GroupBoxContents The group box contents.+ −
+ −
\value SC_MdiNormalButton The normal button for a MDI+ −
subwindow in the menu bar.+ −
\value SC_MdiMinButton The minimize button for a MDI+ −
subwindow in the menu bar.+ −
\value SC_MdiCloseButton The close button for a MDI subwindow+ −
in the menu bar.+ −
+ −
\value SC_All Special value that matches all sub-controls.+ −
\omitvalue SC_Q3ListViewBranch+ −
\omitvalue SC_CustomBase+ −
+ −
\sa ComplexControl+ −
*/+ −
+ −
/*!+ −
\fn void QStyle::drawComplexControl(ComplexControl control, const QStyleOptionComplex *option, QPainter *painter, const QWidget *widget) const+ −
+ −
Draws the given \a control using the provided \a painter with the+ −
style options specified by \a option.+ −
+ −
The \a widget argument is optional and can be used as aid in+ −
drawing the control.+ −
+ −
The \a option parameter is a pointer to a QStyleOptionComplex+ −
object that can be cast to the correct subclass using the+ −
qstyleoption_cast() function. Note that the \c rect member of the+ −
specified \a option must be in logical+ −
coordinates. Reimplementations of this function should use+ −
visualRect() to change the logical coordinates into screen+ −
coordinates before calling the drawPrimitive() or drawControl()+ −
function.+ −
+ −
The table below is listing the complex control elements and their+ −
associated style option subclass. The style options contain all+ −
the parameters required to draw the controls, including+ −
QStyleOption::state which holds the \l {QStyle::StateFlag}{style+ −
flags} that are used when drawing. The table also describes which+ −
flags that are set when casting the given \a option to the+ −
appropriate subclass.+ −
+ −
\table+ −
\header \o Complex Control \o QStyleOptionComplex Subclass \o Style Flag \o Remark+ −
\row \o{1,2} \l{CC_SpinBox} \o{1,2} \l QStyleOptionSpinBox+ −
\o \l State_Enabled \o Set if the spin box is enabled.+ −
\row \o \l State_HasFocus \o Set if the spin box has input focus.+ −
+ −
\row \o{1,2} \l {CC_ComboBox} \o{1,2} \l QStyleOptionComboBox+ −
\o \l State_Enabled \o Set if the combobox is enabled.+ −
\row \o \l State_HasFocus \o Set if the combobox has input focus.+ −
+ −
\row \o{1,2} \l {CC_ScrollBar} \o{1,2} \l QStyleOptionSlider+ −
\o \l State_Enabled \o Set if the scroll bar is enabled.+ −
\row \o \l State_HasFocus \o Set if the scroll bar has input focus.+ −
+ −
\row \o{1,2} \l {CC_Slider} \o{1,2} \l QStyleOptionSlider+ −
\o \l State_Enabled \o Set if the slider is enabled.+ −
\row \o \l State_HasFocus \o Set if the slider has input focus.+ −
+ −
\row \o{1,2} \l {CC_Dial} \o{1,2} \l QStyleOptionSlider+ −
\o \l State_Enabled \o Set if the dial is enabled.+ −
\row \o \l State_HasFocus \o Set if the dial has input focus.+ −
+ −
\row \o{1,6} \l {CC_ToolButton} \o{1,6} \l QStyleOptionToolButton+ −
\o \l State_Enabled \o Set if the tool button is enabled.+ −
\row \o \l State_HasFocus \o Set if the tool button has input focus.+ −
\row \o \l State_DownArrow \o Set if the tool button is down (i.e., a mouse+ −
button or the space bar is pressed).+ −
\row \o \l State_On \o Set if the tool button is a toggle button+ −
and is toggled on.+ −
\row \o \l State_AutoRaise \o Set if the tool button has auto-raise enabled.+ −
\row \o \l State_Raised \o Set if the button is not down, not on, and doesn't+ −
contain the mouse when auto-raise is enabled.+ −
+ −
\row \o \l{CC_TitleBar} \o \l QStyleOptionTitleBar+ −
\o \l State_Enabled \o Set if the title bar is enabled.+ −
+ −
\row \o \l{CC_Q3ListView} \o \l QStyleOptionQ3ListView+ −
\o \l State_Enabled \o Set if the list view is enabled.+ −
+ −
\endtable+ −
+ −
\sa drawPrimitive(), drawControl()+ −
*/+ −
+ −
+ −
/*!+ −
\fn QRect QStyle::subControlRect(ComplexControl control,+ −
const QStyleOptionComplex *option, SubControl subControl,+ −
const QWidget *widget) const = 0+ −
+ −
Returns the rectangle containing the specified \a subControl of+ −
the given complex \a control (with the style specified by \a+ −
option). The rectangle is defined in screen coordinates.+ −
+ −
The \a option argument is a pointer to QStyleOptionComplex or+ −
one of its subclasses, and can be cast to the appropriate type+ −
using the qstyleoption_cast() function. See drawComplexControl()+ −
for details. The \a widget is optional and can contain additional+ −
information for the function.+ −
+ −
\sa drawComplexControl()+ −
*/+ −
+ −
/*!+ −
\fn QStyle::SubControl QStyle::hitTestComplexControl(ComplexControl control,+ −
const QStyleOptionComplex *option, const QPoint &position,+ −
const QWidget *widget) const = 0+ −
+ −
Returns the sub control at the given \a position in the given+ −
complex \a control (with the style options specified by \a+ −
option).+ −
+ −
Note that the \a position is expressed in screen coordinates.+ −
+ −
The \a option argument is a pointer to a QStyleOptionComplex+ −
object (or one of its subclasses). The object can be cast to the+ −
appropriate type using the qstyleoption_cast() function. See+ −
drawComplexControl() for details. The \a widget argument is+ −
optional and can contain additional information for the function.+ −
+ −
\sa drawComplexControl(), subControlRect()+ −
*/+ −
+ −
/*!+ −
\enum QStyle::PixelMetric+ −
+ −
This enum describes the various available pixel metrics. A pixel+ −
metric is a style dependent size represented by a single pixel+ −
value.+ −
+ −
\value PM_ButtonMargin Amount of whitespace between push button+ −
labels and the frame.+ −
\value PM_DockWidgetTitleBarButtonMargin Amount of whitespace between dock widget's+ −
title bar button labels and the frame.+ −
\value PM_ButtonDefaultIndicator Width of the default-button indicator frame.+ −
\value PM_MenuButtonIndicator Width of the menu button indicator+ −
proportional to the widget height.+ −
\value PM_ButtonShiftHorizontal Horizontal contents shift of a+ −
button when the button is down.+ −
\value PM_ButtonShiftVertical Vertical contents shift of a button when the+ −
button is down.+ −
+ −
\value PM_DefaultFrameWidth Default frame width (usually 2).+ −
\value PM_SpinBoxFrameWidth Frame width of a spin box, defaults to PM_DefaultFrameWidth.+ −
\value PM_ComboBoxFrameWidth Frame width of a combo box, defaults to PM_DefaultFrameWidth.+ −
+ −
\value PM_MDIFrameWidth Obsolete. Use PM_MdiSubWindowFrameWidth instead.+ −
\value PM_MdiSubWindowFrameWidth Frame width of an MDI window.+ −
\value PM_MDIMinimizedWidth Obsolete. Use PM_MdiSubWindowMinimizedWidth instead.+ −
\value PM_MdiSubWindowMinimizedWidth Width of a minimized MDI window.+ −
+ −
\value PM_LayoutLeftMargin Default \l{QLayout::setContentsMargins()}{left margin} for a+ −
QLayout.+ −
\value PM_LayoutTopMargin Default \l{QLayout::setContentsMargins()}{top margin} for a QLayout.+ −
\value PM_LayoutRightMargin Default \l{QLayout::setContentsMargins()}{right margin} for a+ −
QLayout.+ −
\value PM_LayoutBottomMargin Default \l{QLayout::setContentsMargins()}{bottom margin} for a+ −
QLayout.+ −
\value PM_LayoutHorizontalSpacing Default \l{QLayout::spacing}{horizontal spacing} for a+ −
QLayout.+ −
\value PM_LayoutVerticalSpacing Default \l{QLayout::spacing}{vertical spacing} for a QLayout.+ −
+ −
\value PM_MaximumDragDistance The maximum allowed distance between+ −
the mouse and a scrollbar when dragging. Exceeding the specified+ −
distance will cause the slider to jump back to the original+ −
position; a value of -1 disables this behavior.+ −
+ −
\value PM_ScrollBarExtent Width of a vertical scroll bar and the+ −
height of a horizontal scroll bar.+ −
\value PM_ScrollBarSliderMin The minimum height of a vertical+ −
scroll bar's slider and the minimum width of a horizontal+ −
scroll bar's slider.+ −
+ −
\value PM_SliderThickness Total slider thickness.+ −
\value PM_SliderControlThickness Thickness of the slider handle.+ −
\value PM_SliderLength Length of the slider.+ −
\value PM_SliderTickmarkOffset The offset between the tickmarks+ −
and the slider.+ −
\value PM_SliderSpaceAvailable The available space for the slider to move.+ −
+ −
\value PM_DockWidgetSeparatorExtent Width of a separator in a+ −
horizontal dock window and the height of a separator in a+ −
vertical dock window.+ −
\value PM_DockWidgetHandleExtent Width of the handle in a+ −
horizontal dock window and the height of the handle in a+ −
vertical dock window.+ −
\value PM_DockWidgetFrameWidth Frame width of a dock window.+ −
\value PM_DockWidgetTitleMargin Margin of the dock window title.+ −
+ −
\value PM_MenuBarPanelWidth Frame width of a menu bar, defaults to PM_DefaultFrameWidth.+ −
\value PM_MenuBarItemSpacing Spacing between menu bar items.+ −
\value PM_MenuBarHMargin Spacing between menu bar items and left/right of bar.+ −
\value PM_MenuBarVMargin Spacing between menu bar items and top/bottom of bar.+ −
+ −
\value PM_ToolBarFrameWidth Width of the frame around toolbars.+ −
\value PM_ToolBarHandleExtent Width of a toolbar handle in a+ −
horizontal toolbar and the height of the handle in a vertical toolbar.+ −
\value PM_ToolBarItemMargin Spacing between the toolbar frame and the items.+ −
\value PM_ToolBarItemSpacing Spacing between toolbar items.+ −
\value PM_ToolBarSeparatorExtent Width of a toolbar separator in a+ −
horizontal toolbar and the height of a separator in a vertical toolbar.+ −
\value PM_ToolBarExtensionExtent Width of a toolbar extension+ −
button in a horizontal toolbar and the height of the button in a+ −
vertical toolbar.+ −
+ −
\value PM_TabBarTabOverlap Number of pixels the tabs should overlap.+ −
(Currently only used in styles, not inside of QTabBar)+ −
\value PM_TabBarTabHSpace Extra space added to the tab width.+ −
\value PM_TabBarTabVSpace Extra space added to the tab height.+ −
\value PM_TabBarBaseHeight Height of the area between the tab bar+ −
and the tab pages.+ −
\value PM_TabBarBaseOverlap Number of pixels the tab bar overlaps+ −
the tab bar base.+ −
\value PM_TabBarScrollButtonWidth+ −
\value PM_TabBarTabShiftHorizontal Horizontal pixel shift when a+ −
tab is selected.+ −
\value PM_TabBarTabShiftVertical Vertical pixel shift when a+ −
tab is selected.+ −
+ −
\value PM_ProgressBarChunkWidth Width of a chunk in a progress bar indicator.+ −
+ −
\value PM_SplitterWidth Width of a splitter.+ −
+ −
\value PM_TitleBarHeight Height of the title bar.+ −
+ −
\value PM_IndicatorWidth Width of a check box indicator.+ −
\value PM_IndicatorHeight Height of a checkbox indicator.+ −
\value PM_ExclusiveIndicatorWidth Width of a radio button indicator.+ −
\value PM_ExclusiveIndicatorHeight Height of a radio button indicator.+ −
+ −
\value PM_MenuPanelWidth Border width (applied on all sides) for a QMenu.+ −
\value PM_MenuHMargin Additional border (used on left and right) for a QMenu.+ −
\value PM_MenuVMargin Additional border (used for bottom and top) for a QMenu.+ −
\value PM_MenuScrollerHeight Height of the scroller area in a QMenu.+ −
\value PM_MenuTearoffHeight Height of a tear off area in a QMenu.+ −
\value PM_MenuDesktopFrameWidth The frame width for the menu on the desktop.+ −
+ −
\value PM_CheckListButtonSize Area (width/height) of the+ −
checkbox/radio button in a Q3CheckListItem.+ −
\value PM_CheckListControllerSize Area (width/height) of the+ −
controller in a Q3CheckListItem.+ −
+ −
\omitvalue PM_DialogButtonsSeparator+ −
\omitvalue PM_DialogButtonsButtonWidth+ −
\omitvalue PM_DialogButtonsButtonHeight+ −
+ −
\value PM_HeaderMarkSize The size of the sort indicator in a header.+ −
\value PM_HeaderGripMargin The size of the resize grip in a header.+ −
\value PM_HeaderMargin The size of the margin between the sort indicator and the text.+ −
\value PM_SpinBoxSliderHeight The height of the optional spin box slider.+ −
+ −
\value PM_ToolBarIconSize Default tool bar icon size+ −
\value PM_SmallIconSize Default small icon size+ −
\value PM_LargeIconSize Default large icon size+ −
+ −
\value PM_FocusFrameHMargin Horizontal margin that the focus frame will outset the widget by.+ −
\value PM_FocusFrameVMargin Vertical margin that the focus frame will outset the widget by.+ −
\value PM_IconViewIconSize The default size for icons in an icon view.+ −
\value PM_ListViewIconSize The default size for icons in a list view.+ −
+ −
\value PM_ToolTipLabelFrameWidth The frame width for a tool tip label.+ −
\value PM_CheckBoxLabelSpacing The spacing between a check box indicator and its label.+ −
\value PM_RadioButtonLabelSpacing The spacing between a radio button indicator and its label.+ −
\value PM_TabBarIconSize The default icon size for a tab bar.+ −
\value PM_SizeGripSize The size of a size grip.+ −
\value PM_MessageBoxIconSize The size of the standard icons in a message box+ −
\value PM_ButtonIconSize The default size of button icons+ −
\value PM_TextCursorWidth The width of the cursor in a line edit or text edit+ −
\value PM_TabBar_ScrollButtonOverlap The distance between the left and right buttons in a tab bar.+ −
+ −
\value PM_TabCloseIndicatorWidth The default width of a close button on a tab in a tab bar.+ −
\value PM_TabCloseIndicatorHeight The default height of a close button on a tab in a tab bar.+ −
+ −
\value PM_CustomBase Base value for custom pixel metrics. Custom+ −
values must be greater than this value.+ −
+ −
The following values are obsolete:+ −
+ −
\value PM_DefaultTopLevelMargin Use PM_LayoutLeftMargin,+ −
PM_LayoutTopMargin,+ −
PM_LayoutRightMargin, and+ −
PM_LayoutBottomMargin instead.+ −
\value PM_DefaultChildMargin Use PM_LayoutLeftMargin,+ −
PM_LayoutTopMargin,+ −
PM_LayoutRightMargin, and+ −
PM_LayoutBottomMargin instead.+ −
\value PM_DefaultLayoutSpacing Use PM_LayoutHorizontalSpacing+ −
and PM_LayoutVerticalSpacing+ −
instead.+ −
+ −
\value PM_ScrollView_ScrollBarSpacing Distance between frame and scrollbar+ −
with SH_ScrollView_FrameOnlyAroundContents set.+ −
\value PM_SubMenuOverlap The horizontal overlap between a submenu and its parent.+ −
+ −
+ −
\sa pixelMetric()+ −
*/+ −
+ −
/*!+ −
\fn int QStyle::pixelMetric(PixelMetric metric, const QStyleOption *option, const QWidget *widget) const;+ −
+ −
Returns the value of the given pixel \a metric.+ −
+ −
The specified \a option and \a widget can be used for calculating+ −
the metric. In general, the \a widget argument is not used. The \a+ −
option can be cast to the appropriate type using the+ −
qstyleoption_cast() function. Note that the \a option may be zero+ −
even for PixelMetrics that can make use of it. See the table below+ −
for the appropriate \a option casts:+ −
+ −
\table+ −
\header \o Pixel Metric \o QStyleOption Subclass+ −
\row \o \l PM_SliderControlThickness \o \l QStyleOptionSlider+ −
\row \o \l PM_SliderLength \o \l QStyleOptionSlider+ −
\row \o \l PM_SliderTickmarkOffset \o \l QStyleOptionSlider+ −
\row \o \l PM_SliderSpaceAvailable \o \l QStyleOptionSlider+ −
\row \o \l PM_ScrollBarExtent \o \l QStyleOptionSlider+ −
\row \o \l PM_TabBarTabOverlap \o \l QStyleOptionTab+ −
\row \o \l PM_TabBarTabHSpace \o \l QStyleOptionTab+ −
\row \o \l PM_TabBarTabVSpace \o \l QStyleOptionTab+ −
\row \o \l PM_TabBarBaseHeight \o \l QStyleOptionTab+ −
\row \o \l PM_TabBarBaseOverlap \o \l QStyleOptionTab+ −
\endtable+ −
+ −
Some pixel metrics are called from widgets and some are only called+ −
internally by the style. If the metric is not called by a widget, it is the+ −
discretion of the style author to make use of it. For some styles, this+ −
may not be appropriate.+ −
*/+ −
+ −
/*!+ −
\enum QStyle::ContentsType+ −
+ −
This enum describes the available contents types. These are used to+ −
calculate sizes for the contents of various widgets.+ −
+ −
\value CT_CheckBox A check box, like QCheckBox.+ −
\value CT_ComboBox A combo box, like QComboBox.+ −
\omitvalue CT_DialogButtons+ −
\value CT_Q3DockWindow A Q3DockWindow.+ −
\value CT_HeaderSection A header section, like QHeader.+ −
\value CT_LineEdit A line edit, like QLineEdit.+ −
\value CT_Menu A menu, like QMenu.+ −
\value CT_Q3Header A Qt 3 header section, like Q3Header.+ −
\value CT_MenuBar A menu bar, like QMenuBar.+ −
\value CT_MenuBarItem A menu bar item, like the buttons in a QMenuBar.+ −
\value CT_MenuItem A menu item, like QMenuItem.+ −
\value CT_ProgressBar A progress bar, like QProgressBar.+ −
\value CT_PushButton A push button, like QPushButton.+ −
\value CT_RadioButton A radio button, like QRadioButton.+ −
\value CT_SizeGrip A size grip, like QSizeGrip.+ −
\value CT_Slider A slider, like QSlider.+ −
\value CT_ScrollBar A scroll bar, like QScrollBar.+ −
\value CT_SpinBox A spin box, like QSpinBox.+ −
\value CT_Splitter A splitter, like QSplitter.+ −
\value CT_TabBarTab A tab on a tab bar, like QTabBar.+ −
\value CT_TabWidget A tab widget, like QTabWidget.+ −
\value CT_ToolButton A tool button, like QToolButton.+ −
\value CT_GroupBox A group box, like QGroupBox.+ −
\value CT_ItemViewItem An item inside an item view.+ −
+ −
\value CT_CustomBase Base value for custom contents types.+ −
Custom values must be greater than this value.+ −
+ −
\value CT_MdiControls The minimize, normal, and close button+ −
in the menu bar for a maximized MDI+ −
subwindow.+ −
+ −
\sa sizeFromContents()+ −
*/+ −
+ −
/*!+ −
\fn QSize QStyle::sizeFromContents(ContentsType type, const QStyleOption *option, \+ −
const QSize &contentsSize, const QWidget *widget) const+ −
+ −
Returns the size of the element described by the specified+ −
\a option and \a type, based on the provided \a contentsSize.+ −
+ −
The \a option argument is a pointer to a QStyleOption or one of+ −
its subclasses. The \a option can be cast to the appropriate type+ −
using the qstyleoption_cast() function. The \a widget is an+ −
optional argument and can contain extra information used for+ −
calculating the size.+ −
+ −
See the table below for the appropriate \a option casts:+ −
+ −
\table+ −
\header \o Contents Type \o QStyleOption Subclass+ −
\row \o \l CT_PushButton \o \l QStyleOptionButton+ −
\row \o \l CT_CheckBox \o \l QStyleOptionButton+ −
\row \o \l CT_RadioButton \o \l QStyleOptionButton+ −
\row \o \l CT_ToolButton \o \l QStyleOptionToolButton+ −
\row \o \l CT_ComboBox \o \l QStyleOptionComboBox+ −
\row \o \l CT_Splitter \o \l QStyleOption+ −
\row \o \l CT_Q3DockWindow \o \l QStyleOptionQ3DockWindow+ −
\row \o \l CT_ProgressBar \o \l QStyleOptionProgressBar+ −
\row \o \l CT_MenuItem \o \l QStyleOptionMenuItem+ −
\endtable+ −
+ −
\sa ContentsType QStyleOption+ −
*/+ −
+ −
/*!+ −
\enum QStyle::RequestSoftwareInputPanel+ −
+ −
This enum describes under what circumstances a software input panel will be+ −
requested by input capable widgets.+ −
+ −
\value RSIP_OnMouseClickAndAlreadyFocused Requests an input panel if the user+ −
clicks on the widget, but only if it is already focused.+ −
\value RSIP_OnMouseClick Requests an input panel if the user clicks on the+ −
widget.+ −
+ −
\sa QEvent::RequestSoftwareInputPanel, QInputContext+ −
*/+ −
+ −
/*!+ −
\enum QStyle::StyleHint+ −
+ −
This enum describes the available style hints. A style hint is a general look+ −
and/or feel hint.+ −
+ −
\value SH_EtchDisabledText Disabled text is "etched" as it is on Windows.+ −
+ −
\value SH_DitherDisabledText Disabled text is dithered as it is on Motif.+ −
+ −
\value SH_GUIStyle The GUI style to use.+ −
+ −
\value SH_ScrollBar_ContextMenu Whether or not a scroll bar has a context menu.+ −
+ −
\value SH_ScrollBar_MiddleClickAbsolutePosition A boolean value.+ −
If true, middle clicking on a scroll bar causes the slider to+ −
jump to that position. If false, middle clicking is+ −
ignored.+ −
+ −
\value SH_ScrollBar_LeftClickAbsolutePosition A boolean value.+ −
If true, left clicking on a scroll bar causes the slider to+ −
jump to that position. If false, left clicking will+ −
behave as appropriate for each control.+ −
+ −
\value SH_ScrollBar_ScrollWhenPointerLeavesControl A boolean+ −
value. If true, when clicking a scroll bar SubControl, holding+ −
the mouse button down and moving the pointer outside the+ −
SubControl, the scroll bar continues to scroll. If false, the+ −
scollbar stops scrolling when the pointer leaves the+ −
SubControl.+ −
+ −
\value SH_ScrollBar_RollBetweenButtons A boolean value.+ −
If true, when clicking a scroll bar button (SC_ScrollBarAddLine or+ −
SC_ScrollBarSubLine) and dragging over to the opposite button (rolling)+ −
will press the new button and release the old one. When it is false, the+ −
original button is released and nothing happens (like a push button).+ −
+ −
\value SH_TabBar_Alignment The alignment for tabs in a+ −
QTabWidget. Possible values are Qt::AlignLeft,+ −
Qt::AlignCenter and Qt::AlignRight.+ −
+ −
\value SH_Header_ArrowAlignment The placement of the sorting+ −
indicator may appear in list or table headers. Possible values+ −
are Qt::Left or Qt::Right.+ −
+ −
\value SH_Slider_SnapToValue Sliders snap to values while moving,+ −
as they do on Windows.+ −
+ −
\value SH_Slider_SloppyKeyEvents Key presses handled in a sloppy+ −
manner, i.e., left on a vertical slider subtracts a line.+ −
+ −
\value SH_ProgressDialog_CenterCancelButton Center button on+ −
progress dialogs, like Motif, otherwise right aligned.+ −
+ −
\value SH_ProgressDialog_TextLabelAlignment The alignment for text+ −
labels in progress dialogs; Qt::AlignCenter on Windows,+ −
Qt::AlignVCenter otherwise.+ −
+ −
\value SH_PrintDialog_RightAlignButtons Right align buttons in+ −
the print dialog, as done on Windows.+ −
+ −
\value SH_MainWindow_SpaceBelowMenuBar One or two pixel space between+ −
the menu bar and the dockarea, as done on Windows.+ −
+ −
\value SH_FontDialog_SelectAssociatedText Select the text in the+ −
line edit, or when selecting an item from the listbox, or when+ −
the line edit receives focus, as done on Windows.+ −
+ −
\value SH_Menu_KeyboardSearch Typing causes a menu to be search+ −
for relevant items, otherwise only mnemnonic is considered.+ −
+ −
\value SH_Menu_AllowActiveAndDisabled Allows disabled menu+ −
items to be active.+ −
+ −
\value SH_Menu_SpaceActivatesItem Pressing the space bar activates+ −
the item, as done on Motif.+ −
+ −
\value SH_Menu_SubMenuPopupDelay The number of milliseconds+ −
to wait before opening a submenu (256 on Windows, 96 on Motif).+ −
+ −
\value SH_Menu_Scrollable Whether popup menus must support scrolling.+ −
+ −
\value SH_Menu_SloppySubMenus Whether popupmenu's must support+ −
sloppy submenu; as implemented on Mac OS.+ −
+ −
\value SH_ScrollView_FrameOnlyAroundContents Whether scrollviews+ −
draw their frame only around contents (like Motif), or around+ −
contents, scroll bars and corner widgets (like Windows).+ −
+ −
\value SH_MenuBar_AltKeyNavigation Menu bars items are navigable+ −
by pressing Alt, followed by using the arrow keys to select+ −
the desired item.+ −
+ −
\value SH_ComboBox_ListMouseTracking Mouse tracking in combobox+ −
drop-down lists.+ −
+ −
\value SH_Menu_MouseTracking Mouse tracking in popup menus.+ −
+ −
\value SH_MenuBar_MouseTracking Mouse tracking in menu bars.+ −
+ −
\value SH_Menu_FillScreenWithScroll Whether scrolling popups+ −
should fill the screen as they are scrolled.+ −
+ −
\value SH_Menu_SelectionWrap Whether popups should allow the selections+ −
to wrap, that is when selection should the next item be the first item.+ −
+ −
\value SH_ItemView_ChangeHighlightOnFocus Gray out selected items+ −
when losing focus.+ −
+ −
\value SH_Widget_ShareActivation Turn on sharing activation with+ −
floating modeless dialogs.+ −
+ −
\value SH_TabBar_SelectMouseType Which type of mouse event should+ −
cause a tab to be selected.+ −
+ −
\value SH_Q3ListViewExpand_SelectMouseType Which type of mouse event should+ −
cause a list view expansion to be selected.+ −
+ −
\value SH_TabBar_PreferNoArrows Whether a tab bar should suggest a size+ −
to prevent scoll arrows.+ −
+ −
\value SH_ComboBox_Popup Allows popups as a combobox drop-down+ −
menu.+ −
+ −
\value SH_Workspace_FillSpaceOnMaximize The workspace should+ −
maximize the client area.+ −
+ −
\value SH_TitleBar_NoBorder The title bar has no border.+ −
+ −
\value SH_ScrollBar_StopMouseOverSlider Obsolete. Use+ −
SH_Slider_StopMouseOverSlider instead.+ −
+ −
\value SH_Slider_StopMouseOverSlider Stops auto-repeat when+ −
the slider reaches the mouse position.+ −
+ −
\value SH_BlinkCursorWhenTextSelected Whether cursor should blink+ −
when text is selected.+ −
+ −
\value SH_RichText_FullWidthSelection Whether richtext selections+ −
should extend to the full width of the document.+ −
+ −
\value SH_GroupBox_TextLabelVerticalAlignment How to vertically align a+ −
group box's text label.+ −
+ −
\value SH_GroupBox_TextLabelColor How to paint a group box's text label.+ −
+ −
\value SH_DialogButtons_DefaultButton Which button gets the+ −
default status in a dialog's button widget.+ −
+ −
\value SH_ToolBox_SelectedPageTitleBold Boldness of the selected+ −
page title in a QToolBox.+ −
+ −
\value SH_LineEdit_PasswordCharacter The Unicode character to be+ −
used for passwords.+ −
+ −
\value SH_Table_GridLineColor The RGB value of the grid for a table.+ −
+ −
\value SH_UnderlineShortcut Whether shortcuts are underlined.+ −
+ −
\value SH_SpellCheckUnderlineStyle A+ −
QTextCharFormat::UnderlineStyle value that specifies the way+ −
misspelled words should be underlined.+ −
+ −
\value SH_SpinBox_AnimateButton Animate a click when up or down is+ −
pressed in a spin box.+ −
\value SH_SpinBox_KeyPressAutoRepeatRate Auto-repeat interval for+ −
spinbox key presses.+ −
\value SH_SpinBox_ClickAutoRepeatRate Auto-repeat interval for+ −
spinbox mouse clicks.+ −
\value SH_SpinBox_ClickAutoRepeatThreshold Auto-repeat threshold for+ −
spinbox mouse clicks.+ −
\value SH_ToolTipLabel_Opacity An integer indicating the opacity for+ −
the tip label, 0 is completely transparent, 255 is completely+ −
opaque.+ −
\value SH_DrawMenuBarSeparator Indicates whether or not the menu bar draws separators.+ −
\value SH_TitleBar_ModifyNotification Indicates if the title bar should show+ −
a '*' for windows that are modified.+ −
+ −
\value SH_Button_FocusPolicy The default focus policy for buttons.+ −
+ −
\value SH_CustomBase Base value for custom style hints.+ −
Custom values must be greater than this value.+ −
+ −
\value SH_MenuBar_DismissOnSecondClick A boolean indicating if a menu in+ −
the menu bar should be dismissed when it is clicked on a second time. (Example:+ −
Clicking and releasing on the File Menu in a menu bar and then+ −
immediately clicking on the File Menu again.)+ −
+ −
\value SH_MessageBox_UseBorderForButtonSpacing A boolean indicating what the to+ −
use the border of the buttons (computed as half the button height) for the spacing+ −
of the button in a message box.+ −
+ −
\value SH_MessageBox_CenterButtons A boolean indicating whether the buttons in the+ −
message box should be centered or not (see QDialogButtonBox::setCentered()).+ −
+ −
\value SH_MessageBox_TextInteractionFlags A boolean indicating if+ −
the text in a message box should allow user interfactions (e.g.+ −
selection) or not.+ −
+ −
\value SH_TitleBar_AutoRaise A boolean indicating whether+ −
controls on a title bar ought to update when the mouse is over them.+ −
+ −
\value SH_ToolButton_PopupDelay An int indicating the popup delay in milliseconds+ −
for menus attached to tool buttons.+ −
+ −
\value SH_FocusFrame_Mask The mask of the focus frame.+ −
+ −
\value SH_RubberBand_Mask The mask of the rubber band.+ −
+ −
\value SH_WindowFrame_Mask The mask of the window frame.+ −
+ −
\value SH_SpinControls_DisableOnBounds Determines if the spin controls will shown+ −
as disabled when reaching the spin range boundary.+ −
+ −
\value SH_Dial_BackgroundRole Defines the style's preferred+ −
background role (as QPalette::ColorRole) for a dial widget.+ −
+ −
\value SH_ScrollBar_BackgroundMode The background mode for a scroll bar.+ −
+ −
\value SH_ComboBox_LayoutDirection The layout direction for the+ −
combo box. By default it should be the same as indicated by the+ −
QStyleOption::direction variable.+ −
+ −
\value SH_ItemView_EllipsisLocation The location where ellipses should be+ −
added for item text that is too long to fit in an view item.+ −
+ −
\value SH_ItemView_ShowDecorationSelected When an item in an item+ −
view is selected, also highlight the branch or other decoration.+ −
+ −
\value SH_ItemView_ActivateItemOnSingleClick Emit the activated signal+ −
when the user single clicks on an item in an item in an item view.+ −
Otherwise the signal is emitted when the user double clicks on an item.+ −
+ −
\value SH_Slider_AbsoluteSetButtons Which mouse buttons cause a slider+ −
to set the value to the position clicked on.+ −
+ −
\value SH_Slider_PageSetButtons Which mouse buttons cause a slider+ −
to page step the value.+ −
+ −
\value SH_TabBar_ElideMode The default eliding style for a tab bar.+ −
+ −
\value SH_DialogButtonLayout Controls how buttons are laid out in a QDialogButtonBox, returns a QDialogButtonBox::ButtonLayout enum.+ −
+ −
\value SH_WizardStyle Controls the look and feel of a QWizard. Returns a QWizard::WizardStyle enum.+ −
+ −
\value SH_FormLayoutWrapPolicy Provides a default for how rows are wrapped in a QFormLayout. Returns a QFormLayout::RowWrapPolicy enum.+ −
\value SH_FormLayoutFieldGrowthPolicy Provides a default for how fields can grow in a QFormLayout. Returns a QFormLayout::FieldGrowthPolicy enum.+ −
\value SH_FormLayoutFormAlignment Provides a default for how a QFormLayout aligns its contents within the available space. Returns a Qt::Alignment enum.+ −
\value SH_FormLayoutLabelAlignment Provides a default for how a QFormLayout aligns labels within the available space. Returns a Qt::Alignment enum.+ −
+ −
\value SH_ItemView_ArrowKeysNavigateIntoChildren Controls whether the tree view will select the first child when it is exapanded and the right arrow key is pressed.+ −
\value SH_ComboBox_PopupFrameStyle The frame style used when drawing a combobox popup menu.+ −
+ −
\value SH_DialogButtonBox_ButtonsHaveIcons Indicates whether or not StandardButtons in QDialogButtonBox should have icons or not.+ −
\value SH_ItemView_MovementWithoutUpdatingSelection The item view is able to indicate a current item without changing the selection.+ −
\value SH_ToolTip_Mask The mask of a tool tip.+ −
+ −
\value SH_FocusFrame_AboveWidget The FocusFrame is stacked above the widget that it is "focusing on".+ −
+ −
\value SH_TextControl_FocusIndicatorTextCharFormat Specifies the text format used to highlight focused anchors in rich text+ −
documents displayed for example in QTextBrowser. The format has to be a QTextCharFormat returned in the variant of the+ −
QStyleHintReturnVariant return value. The QTextFormat::OutlinePen property is used for the outline and QTextFormat::BackgroundBrush+ −
for the background of the highlighted area.+ −
+ −
\value SH_Menu_FlashTriggeredItem Flash triggered item.+ −
\value SH_Menu_FadeOutOnHide Fade out the menu instead of hiding it immediately.+ −
+ −
\value SH_TabWidget_DefaultTabPosition Default position of the tab bar in a tab widget.+ −
+ −
\value SH_ToolBar_Movable Determines if the tool bar is movable by default.+ −
+ −
\value SH_ItemView_PaintAlternatingRowColorsForEmptyArea Whether QTreeView paints alternating row colors for the area that does not have any items.+ −
+ −
\value SH_Menu_Mask The mask for a popup menu.+ −
+ −
\value SH_ItemView_DrawDelegateFrame Determines if there should be a frame for a delegate widget.+ −
+ −
\value SH_TabBar_CloseButtonPosition Determines the position of the close button on a tab in a tab bar.+ −
+ −
\value SH_DockWidget_ButtonsHaveFrame Determines if dockwidget buttons should have frames. Default is true.+ −
+ −
\value SH_ToolButtonStyle Determines the default system style for tool buttons that uses Qt::ToolButtonFollowStyle.+ −
+ −
\value SH_RequestSoftwareInputPanel Determines when a software input panel should+ −
be requested by input widgets. Returns an enum of type QStyle::RequestSoftwareInputPanel.+ −
+ −
\omitvalue SH_UnderlineAccelerator+ −
+ −
\sa styleHint()+ −
*/+ −
+ −
/*!+ −
\fn int QStyle::styleHint(StyleHint hint, const QStyleOption *option, \+ −
const QWidget *widget, QStyleHintReturn *returnData) const+ −
+ −
Returns an integer representing the specified style \a hint for+ −
the given \a widget described by the provided style \a option.+ −
+ −
\a returnData is used when the querying widget needs more detailed data than+ −
the integer that styleHint() returns. See the QStyleHintReturn class+ −
description for details.+ −
*/+ −
+ −
/*!+ −
\enum QStyle::StandardPixmap+ −
+ −
This enum describes the available standard pixmaps. A standard pixmap is a pixmap that+ −
can follow some existing GUI style or guideline.+ −
+ −
\value SP_TitleBarMinButton Minimize button on title bars (e.g.,+ −
in QMdiSubWindow).+ −
\value SP_TitleBarMenuButton Menu button on a title bar.+ −
\value SP_TitleBarMaxButton Maximize button on title bars.+ −
\value SP_TitleBarCloseButton Close button on title bars.+ −
\value SP_TitleBarNormalButton Normal (restore) button on title bars.+ −
\value SP_TitleBarShadeButton Shade button on title bars.+ −
\value SP_TitleBarUnshadeButton Unshade button on title bars.+ −
\value SP_TitleBarContextHelpButton The Context help button on title bars.+ −
\value SP_MessageBoxInformation The "information" icon.+ −
\value SP_MessageBoxWarning The "warning" icon.+ −
\value SP_MessageBoxCritical The "critical" icon.+ −
\value SP_MessageBoxQuestion The "question" icon.+ −
\value SP_DesktopIcon The "desktop" icon.+ −
\value SP_TrashIcon The "trash" icon.+ −
\value SP_ComputerIcon The "My computer" icon.+ −
\value SP_DriveFDIcon The floppy icon.+ −
\value SP_DriveHDIcon The harddrive icon.+ −
\value SP_DriveCDIcon The CD icon.+ −
\value SP_DriveDVDIcon The DVD icon.+ −
\value SP_DriveNetIcon The network icon.+ −
\value SP_DirHomeIcon The home directory icon.+ −
\value SP_DirOpenIcon The open directory icon.+ −
\value SP_DirClosedIcon The closed directory icon.+ −
\value SP_DirIcon The directory icon.+ −
\value SP_DirLinkIcon The link to directory icon.+ −
\value SP_FileIcon The file icon.+ −
\value SP_FileLinkIcon The link to file icon.+ −
\value SP_FileDialogStart The "start" icon in a file dialog.+ −
\value SP_FileDialogEnd The "end" icon in a file dialog.+ −
\value SP_FileDialogToParent The "parent directory" icon in a file dialog.+ −
\value SP_FileDialogNewFolder The "create new folder" icon in a file dialog.+ −
\value SP_FileDialogDetailedView The detailed view icon in a file dialog.+ −
\value SP_FileDialogInfoView The file info icon in a file dialog.+ −
\value SP_FileDialogContentsView The contents view icon in a file dialog.+ −
\value SP_FileDialogListView The list view icon in a file dialog.+ −
\value SP_FileDialogBack The back arrow in a file dialog.+ −
\value SP_DockWidgetCloseButton Close button on dock windows (see also QDockWidget).+ −
\value SP_ToolBarHorizontalExtensionButton Extension button for horizontal toolbars.+ −
\value SP_ToolBarVerticalExtensionButton Extension button for vertical toolbars.+ −
\value SP_DialogOkButton Icon for a standard OK button in a QDialogButtonBox.+ −
\value SP_DialogCancelButton Icon for a standard Cancel button in a QDialogButtonBox.+ −
\value SP_DialogHelpButton Icon for a standard Help button in a QDialogButtonBox.+ −
\value SP_DialogOpenButton Icon for a standard Open button in a QDialogButtonBox.+ −
\value SP_DialogSaveButton Icon for a standard Save button in a QDialogButtonBox.+ −
\value SP_DialogCloseButton Icon for a standard Close button in a QDialogButtonBox.+ −
\value SP_DialogApplyButton Icon for a standard Apply button in a QDialogButtonBox.+ −
\value SP_DialogResetButton Icon for a standard Reset button in a QDialogButtonBox.+ −
\value SP_DialogDiscardButton Icon for a standard Discard button in a QDialogButtonBox.+ −
\value SP_DialogYesButton Icon for a standard Yes button in a QDialogButtonBox.+ −
\value SP_DialogNoButton Icon for a standard No button in a QDialogButtonBox.+ −
\value SP_ArrowUp Icon arrow pointing up.+ −
\value SP_ArrowDown Icon arrow pointing down.+ −
\value SP_ArrowLeft Icon arrow pointing left.+ −
\value SP_ArrowRight Icon arrow pointing right.+ −
\value SP_ArrowBack Equivalent to SP_ArrowLeft when the current layout direction is Qt::LeftToRight, otherwise SP_ArrowRight.+ −
\value SP_ArrowForward Equivalent to SP_ArrowRight when the current layout direction is Qt::LeftToRight, otherwise SP_ArrowLeft.+ −
\value SP_CommandLink Icon used to indicate a Vista style command link glyph.+ −
\value SP_VistaShield Icon used to indicate UAC prompts on Windows Vista. This will return a null pixmap or icon on all other platforms.+ −
\value SP_BrowserReload Icon indicating that the current page should be reloaded.+ −
\value SP_BrowserStop Icon indicating that the page loading should stop.+ −
\value SP_MediaPlay Icon indicating that media should begin playback.+ −
\value SP_MediaStop Icon indicating that media should stop playback.+ −
\value SP_MediaPause Icon indicating that media should pause playback.+ −
\value SP_MediaSkipForward Icon indicating that media should skip forward.+ −
\value SP_MediaSkipBackward Icon indicating that media should skip backward.+ −
\value SP_MediaSeekForward Icon indicating that media should seek forward.+ −
\value SP_MediaSeekBackward Icon indicating that media should seek backward.+ −
\value SP_MediaVolume Icon indicating a volume control.+ −
\value SP_MediaVolumeMuted Icon indicating a muted volume control.+ −
\value SP_CustomBase Base value for custom standard pixmaps;+ −
custom values must be greater than this value.+ −
+ −
\sa standardIcon()+ −
*/+ −
+ −
/*!+ −
\fn QPixmap QStyle::generatedIconPixmap(QIcon::Mode iconMode,+ −
const QPixmap &pixmap, const QStyleOption *option) const+ −
+ −
Returns a copy of the given \a pixmap, styled to conform to the+ −
specified \a iconMode and taking into account the palette+ −
specified by \a option.+ −
+ −
The \a option parameter can pass extra information, but+ −
it must contain a palette.+ −
+ −
Note that not all pixmaps will conform, in which case the returned+ −
pixmap is a plain copy.+ −
+ −
\sa QIcon+ −
*/+ −
+ −
/*!+ −
\fn QPixmap QStyle::standardPixmap(StandardPixmap standardPixmap, const QStyleOption *option, \+ −
const QWidget *widget) const+ −
+ −
\obsolete+ −
Returns a pixmap for the given \a standardPixmap.+ −
+ −
A standard pixmap is a pixmap that can follow some existing GUI+ −
style or guideline. The \a option argument can be used to pass+ −
extra information required when defining the appropriate+ −
pixmap. The \a widget argument is optional and can also be used to+ −
aid the determination of the pixmap.+ −
+ −
Developers calling standardPixmap() should instead call standardIcon()+ −
Developers who re-implemented standardPixmap() should instead re-implement+ −
the slot standardIconImplementation().+ −
+ −
\sa standardIcon()+ −
*/+ −
+ −
+ −
/*!+ −
\fn QRect QStyle::visualRect(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QRect &logicalRectangle)+ −
+ −
Returns the given \a logicalRectangle converted to screen+ −
coordinates based on the specified \a direction. The \a+ −
boundingRectangle is used when performing the translation.+ −
+ −
This function is provided to support right-to-left desktops, and+ −
is typically used in implementations of the subControlRect()+ −
function.+ −
+ −
\sa QWidget::layoutDirection+ −
*/+ −
QRect QStyle::visualRect(Qt::LayoutDirection direction, const QRect &boundingRect, const QRect &logicalRect)+ −
{+ −
if (direction == Qt::LeftToRight)+ −
return logicalRect;+ −
QRect rect = logicalRect;+ −
rect.translate(2 * (boundingRect.right() - logicalRect.right()) ++ −
logicalRect.width() - boundingRect.width(), 0);+ −
return rect;+ −
}+ −
+ −
/*!+ −
\fn QPoint QStyle::visualPos(Qt::LayoutDirection direction, const QRect &boundingRectangle, const QPoint &logicalPosition)+ −
+ −
Returns the given \a logicalPosition converted to screen+ −
coordinates based on the specified \a direction. The \a+ −
boundingRectangle is used when performing the translation.+ −
+ −
\sa QWidget::layoutDirection+ −
*/+ −
QPoint QStyle::visualPos(Qt::LayoutDirection direction, const QRect &boundingRect, const QPoint &logicalPos)+ −
{+ −
if (direction == Qt::LeftToRight)+ −
return logicalPos;+ −
return QPoint(boundingRect.right() - logicalPos.x(), logicalPos.y());+ −
}+ −
+ −
/*!+ −
Returns a new rectangle of the specified \a size that is aligned to the given \a+ −
rectangle according to the specified \a alignment and \a direction.+ −
*/+ −
QRect QStyle::alignedRect(Qt::LayoutDirection direction, Qt::Alignment alignment, const QSize &size, const QRect &rectangle)+ −
{+ −
alignment = visualAlignment(direction, alignment);+ −
int x = rectangle.x();+ −
int y = rectangle.y();+ −
int w = size.width();+ −
int h = size.height();+ −
if ((alignment & Qt::AlignVCenter) == Qt::AlignVCenter)+ −
y += rectangle.size().height()/2 - h/2;+ −
else if ((alignment & Qt::AlignBottom) == Qt::AlignBottom)+ −
y += rectangle.size().height() - h;+ −
if ((alignment & Qt::AlignRight) == Qt::AlignRight)+ −
x += rectangle.size().width() - w;+ −
else if ((alignment & Qt::AlignHCenter) == Qt::AlignHCenter)+ −
x += rectangle.size().width()/2 - w/2;+ −
return QRect(x, y, w, h);+ −
}+ −
+ −
/*!+ −
Transforms an \a alignment of Qt::AlignLeft or Qt::AlignRight+ −
without Qt::AlignAbsolute into Qt::AlignLeft or Qt::AlignRight with+ −
Qt::AlignAbsolute according to the layout \a direction. The other+ −
alignment flags are left untouched.+ −
+ −
If no horizontal alignment was specified, the function returns the+ −
default alignment for the given layout \a direction.+ −
+ −
QWidget::layoutDirection+ −
*/+ −
Qt::Alignment QStyle::visualAlignment(Qt::LayoutDirection direction, Qt::Alignment alignment)+ −
{+ −
if (!(alignment & Qt::AlignHorizontal_Mask))+ −
alignment |= Qt::AlignLeft;+ −
if ((alignment & Qt::AlignAbsolute) == 0 && (alignment & (Qt::AlignLeft | Qt::AlignRight))) {+ −
if (direction == Qt::RightToLeft)+ −
alignment ^= (Qt::AlignLeft | Qt::AlignRight);+ −
alignment |= Qt::AlignAbsolute;+ −
}+ −
return alignment;+ −
}+ −
+ −
/*!+ −
Converts the given \a logicalValue to a pixel position. The \a min+ −
parameter maps to 0, \a max maps to \a span and other values are+ −
distributed evenly in-between.+ −
+ −
This function can handle the entire integer range without+ −
overflow, providing that \a span is less than 4096.+ −
+ −
By default, this function assumes that the maximum value is on the+ −
right for horizontal items and on the bottom for vertical items.+ −
Set the \a upsideDown parameter to true to reverse this behavior.+ −
+ −
\sa sliderValueFromPosition()+ −
*/+ −
+ −
int QStyle::sliderPositionFromValue(int min, int max, int logicalValue, int span, bool upsideDown)+ −
{+ −
if (span <= 0 || logicalValue < min || max <= min)+ −
return 0;+ −
if (logicalValue > max)+ −
return upsideDown ? span : min;+ −
+ −
uint range = max - min;+ −
uint p = upsideDown ? max - logicalValue : logicalValue - min;+ −
+ −
if (range > (uint)INT_MAX/4096) {+ −
double dpos = (double(p))/(double(range)/span);+ −
return int(dpos);+ −
} else if (range > (uint)span) {+ −
return (2 * p * span + range) / (2*range);+ −
} else {+ −
uint div = span / range;+ −
uint mod = span % range;+ −
return p * div + (2 * p * mod + range) / (2 * range);+ −
}+ −
// equiv. to (p * span) / range + 0.5+ −
// no overflow because of this implicit assumption:+ −
// span <= 4096+ −
}+ −
+ −
/*!+ −
\fn int QStyle::sliderValueFromPosition(int min, int max, int position, int span, bool upsideDown)+ −
+ −
Converts the given pixel \a position to a logical value. 0 maps to+ −
the \a min parameter, \a span maps to \a max and other values are+ −
distributed evenly in-between.+ −
+ −
This function can handle the entire integer range without+ −
overflow.+ −
+ −
By default, this function assumes that the maximum value is on the+ −
right for horizontal items and on the bottom for vertical+ −
items. Set the \a upsideDown parameter to true to reverse this+ −
behavior.+ −
+ −
\sa sliderPositionFromValue()+ −
*/+ −
+ −
int QStyle::sliderValueFromPosition(int min, int max, int pos, int span, bool upsideDown)+ −
{+ −
if (span <= 0 || pos <= 0)+ −
return upsideDown ? max : min;+ −
if (pos >= span)+ −
return upsideDown ? min : max;+ −
+ −
uint range = max - min;+ −
+ −
if ((uint)span > range) {+ −
int tmp = (2 * pos * range + span) / (2 * span);+ −
return upsideDown ? max - tmp : tmp + min;+ −
} else {+ −
uint div = range / span;+ −
uint mod = range % span;+ −
int tmp = pos * div + (2 * pos * mod + span) / (2 * span);+ −
return upsideDown ? max - tmp : tmp + min;+ −
}+ −
// equiv. to min + (pos*range)/span + 0.5+ −
// no overflow because of this implicit assumption:+ −
// pos <= span < sqrt(INT_MAX+0.0625)+0.25 ~ sqrt(INT_MAX)+ −
}+ −
+ −
/*### \fn void QStyle::drawItem(QPainter *p, const QRect &r,+ −
int flags, const QColorGroup &colorgroup, bool enabled,+ −
const QString &text, int len = -1,+ −
const QColor *penColor = 0) const+ −
+ −
Use one of the drawItem() overloads that takes a QPalette instead+ −
of a QColorGroup.+ −
*/+ −
+ −
/*### \fn void QStyle::drawItem(QPainter *p, const QRect &r,+ −
int flags, const QColorGroup colorgroup, bool enabled,+ −
const QPixmap &pixmap,+ −
const QColor *penColor = 0) const+ −
+ −
Use one of the drawItem() overloads that takes a QPalette instead+ −
of a QColorGroup.+ −
*/+ −
+ −
/*### \fn void QStyle::drawItem(QPainter *p, const QRect &r,+ −
int flags, const QColorGroup colorgroup, bool enabled,+ −
const QPixmap *pixmap,+ −
const QString &text, int len = -1,+ −
const QColor *penColor = 0) const+ −
+ −
Use one of the drawItem() overloads that takes a QPalette instead+ −
of a QColorGroup.+ −
*/+ −
+ −
/*!+ −
Returns the style's standard palette.+ −
+ −
Note that on systems that support system colors, the style's+ −
standard palette is not used. In particular, the Windows XP,+ −
Vista, and Mac styles do not use the standard palette, but make+ −
use of native theme engines. With these styles, you should not set+ −
the palette with QApplication::setStandardPalette().+ −
+ −
*/+ −
QPalette QStyle::standardPalette() const+ −
{+ −
#ifdef Q_WS_X11+ −
QColor background;+ −
if (QX11Info::appDepth() > 8)+ −
background = QColor(0xd4, 0xd0, 0xc8); // win 2000 grey+ −
else+ −
background = QColor(192, 192, 192);+ −
#else+ −
QColor background(0xd4, 0xd0, 0xc8); // win 2000 grey+ −
#endif+ −
QColor light(background.lighter());+ −
QColor dark(background.darker());+ −
QColor mid(Qt::gray);+ −
QPalette palette(Qt::black, background, light, dark, mid, Qt::black, Qt::white);+ −
palette.setBrush(QPalette::Disabled, QPalette::WindowText, dark);+ −
palette.setBrush(QPalette::Disabled, QPalette::Text, dark);+ −
palette.setBrush(QPalette::Disabled, QPalette::ButtonText, dark);+ −
palette.setBrush(QPalette::Disabled, QPalette::Base, background);+ −
return palette;+ −
}+ −
+ −
/*!+ −
\since 4.1+ −
+ −
Returns an icon for the given \a standardIcon.+ −
+ −
The \a standardIcon is a standard pixmap which can follow some+ −
existing GUI style or guideline. The \a option argument can be+ −
used to pass extra information required when defining the+ −
appropriate icon. The \a widget argument is optional and can also+ −
be used to aid the determination of the icon.+ −
+ −
\warning Because of binary compatibility constraints, this+ −
function is not virtual. If you want to provide your own icons in+ −
a QStyle subclass, reimplement the standardIconImplementation()+ −
slot in your subclass instead. The standardIcon() function will+ −
dynamically detect the slot and call it.+ −
+ −
\sa standardIconImplementation()+ −
*/+ −
QIcon QStyle::standardIcon(StandardPixmap standardIcon, const QStyleOption *option,+ −
const QWidget *widget) const+ −
{+ −
QIcon result;+ −
// ### Qt 4.1: invokeMethod should accept const functions, to avoid this dirty cast+ −
QMetaObject::invokeMethod(const_cast<QStyle*>(this),+ −
"standardIconImplementation", Qt::DirectConnection,+ −
Q_RETURN_ARG(QIcon, result),+ −
Q_ARG(StandardPixmap, standardIcon),+ −
Q_ARG(const QStyleOption*, option),+ −
Q_ARG(const QWidget*, widget));+ −
return result;+ −
}+ −
+ −
/*!+ −
\since 4.1+ −
+ −
Returns an icon for the given \a standardIcon.+ −
+ −
Reimplement this slot to provide your own icons in a QStyle+ −
subclass; because of binary compatibility constraints, the+ −
standardIcon() function (introduced in Qt 4.1) is not+ −
virtual. Instead, standardIcon() will dynamically detect and call+ −
\e this slot.+ −
+ −
The \a standardIcon is a standard pixmap which can follow some+ −
existing GUI style or guideline. The \a option argument can be+ −
used to pass extra information required when defining the+ −
appropriate icon. The \a widget argument is optional and can also+ −
be used to aid the determination of the icon.+ −
+ −
\sa standardIcon()+ −
*/+ −
QIcon QStyle::standardIconImplementation(StandardPixmap standardIcon, const QStyleOption *option,+ −
const QWidget *widget) const+ −
{+ −
return QIcon(standardPixmap(standardIcon, option, widget));+ −
}+ −
+ −
/*!+ −
\since 4.3+ −
+ −
Returns the spacing that should be used between \a control1 and+ −
\a control2 in a layout. \a orientation specifies whether the+ −
controls are laid out side by side or stacked vertically. The \a+ −
option parameter can be used to pass extra information about the+ −
parent widget. The \a widget parameter is optional and can also+ −
be used if \a option is 0.+ −
+ −
This function is called by the layout system. It is used only if+ −
PM_LayoutHorizontalSpacing or PM_LayoutVerticalSpacing returns a+ −
negative value.+ −
+ −
For binary compatibility reasons, this function is not virtual.+ −
If you want to specify custom layout spacings in a QStyle+ −
subclass, implement a slot called layoutSpacingImplementation().+ −
QStyle will discover the slot at run-time (using Qt's+ −
\l{meta-object system}) and direct all calls to layoutSpacing()+ −
to layoutSpacingImplementation().+ −
+ −
\sa combinedLayoutSpacing(), layoutSpacingImplementation()+ −
*/+ −
int QStyle::layoutSpacing(QSizePolicy::ControlType control1, QSizePolicy::ControlType control2,+ −
Qt::Orientation orientation, const QStyleOption *option,+ −
const QWidget *widget) const+ −
{+ −
Q_D(const QStyle);+ −
if (d->layoutSpacingIndex == -1) {+ −
d->layoutSpacingIndex = metaObject()->indexOfMethod(+ −
"layoutSpacingImplementation(QSizePolicy::ControlType,QSizePolicy::ControlType,"+ −
"Qt::Orientation,const QStyleOption*,const QWidget*)"+ −
);+ −
}+ −
if (d->layoutSpacingIndex < 0)+ −
return -1;+ −
int result = -1;+ −
void *param[] = {&result, &control1, &control2, &orientation, &option, &widget};+ −
+ −
const_cast<QStyle *>(this)->qt_metacall(QMetaObject::InvokeMetaMethod,+ −
d->layoutSpacingIndex, param);+ −
return result;+ −
}+ −
+ −
/*!+ −
\since 4.3+ −
+ −
Returns the spacing that should be used between \a controls1 and+ −
\a controls2 in a layout. \a orientation specifies whether the+ −
controls are laid out side by side or stacked vertically. The \a+ −
option parameter can be used to pass extra information about the+ −
parent widget. The \a widget parameter is optional and can also+ −
be used if \a option is 0.+ −
+ −
\a controls1 and \a controls2 are OR-combination of zero or more+ −
\l{QSizePolicy::ControlTypes}{control types}.+ −
+ −
This function is called by the layout system. It is used only if+ −
PM_LayoutHorizontalSpacing or PM_LayoutVerticalSpacing returns a+ −
negative value.+ −
+ −
\sa layoutSpacing(), layoutSpacingImplementation()+ −
*/+ −
int QStyle::combinedLayoutSpacing(QSizePolicy::ControlTypes controls1,+ −
QSizePolicy::ControlTypes controls2, Qt::Orientation orientation,+ −
QStyleOption *option, QWidget *widget) const+ −
{+ −
QSizePolicy::ControlType array1[MaxBits];+ −
QSizePolicy::ControlType array2[MaxBits];+ −
int count1 = unpackControlTypes(controls1, array1);+ −
int count2 = unpackControlTypes(controls2, array2);+ −
int result = -1;+ −
+ −
for (int i = 0; i < count1; ++i) {+ −
for (int j = 0; j < count2; ++j) {+ −
int spacing = layoutSpacing(array1[i], array2[j], orientation, option, widget);+ −
result = qMax(spacing, result);+ −
}+ −
}+ −
return result;+ −
}+ −
+ −
/*!+ −
\since 4.3+ −
+ −
This slot is called by layoutSpacing() to determine the spacing+ −
that should be used between \a control1 and \a control2 in a+ −
layout. \a orientation specifies whether the controls are laid+ −
out side by side or stacked vertically. The \a option parameter+ −
can be used to pass extra information about the parent widget.+ −
The \a widget parameter is optional and can also be used if \a+ −
option is 0.+ −
+ −
If you want to provide custom layout spacings in a QStyle+ −
subclass, implement a slot called layoutSpacingImplementation()+ −
in your subclass. Be aware that this slot will only be called if+ −
PM_LayoutHorizontalSpacing or PM_LayoutVerticalSpacing returns a+ −
negative value.+ −
+ −
The default implementation returns -1.+ −
+ −
\sa layoutSpacing(), combinedLayoutSpacing()+ −
*/+ −
int QStyle::layoutSpacingImplementation(QSizePolicy::ControlType /* control1 */,+ −
QSizePolicy::ControlType /* control2 */,+ −
Qt::Orientation /*orientation*/,+ −
const QStyleOption * /* option */,+ −
const QWidget * /* widget */) const+ −
{+ −
return -1;+ −
}+ −
+ −
QT_BEGIN_INCLUDE_NAMESPACE+ −
#include <QDebug>+ −
QT_END_INCLUDE_NAMESPACE+ −
+ −
QDebug operator<<(QDebug debug, QStyle::State state)+ −
{+ −
#if !defined(QT_NO_DEBUG) && !defined(QT_NO_DEBUG_STREAM)+ −
debug << "QStyle::State(";+ −
+ −
QStringList states;+ −
if (state & QStyle::State_Active) states << QLatin1String("Active");+ −
if (state & QStyle::State_AutoRaise) states << QLatin1String("AutoRaise");+ −
if (state & QStyle::State_Bottom) states << QLatin1String("Bottom");+ −
if (state & QStyle::State_Children) states << QLatin1String("Children");+ −
if (state & QStyle::State_DownArrow) states << QLatin1String("DownArrow");+ −
if (state & QStyle::State_Editing) states << QLatin1String("Editing");+ −
if (state & QStyle::State_Enabled) states << QLatin1String("Enabled");+ −
if (state & QStyle::State_FocusAtBorder) states << QLatin1String("FocusAtBorder");+ −
if (state & QStyle::State_HasFocus) states << QLatin1String("HasFocus");+ −
if (state & QStyle::State_Horizontal) states << QLatin1String("Horizontal");+ −
if (state & QStyle::State_Item) states << QLatin1String("Item");+ −
if (state & QStyle::State_KeyboardFocusChange) states << QLatin1String("KeyboardFocusChange");+ −
if (state & QStyle::State_MouseOver) states << QLatin1String("MouseOver");+ −
if (state & QStyle::State_NoChange) states << QLatin1String("NoChange");+ −
if (state & QStyle::State_Off) states << QLatin1String("Off");+ −
if (state & QStyle::State_On) states << QLatin1String("On");+ −
if (state & QStyle::State_Open) states << QLatin1String("Open");+ −
if (state & QStyle::State_Raised) states << QLatin1String("Raised");+ −
if (state & QStyle::State_ReadOnly) states << QLatin1String("ReadOnly");+ −
if (state & QStyle::State_Selected) states << QLatin1String("Selected");+ −
if (state & QStyle::State_Sibling) states << QLatin1String("Sibling");+ −
if (state & QStyle::State_Sunken) states << QLatin1String("Sunken");+ −
if (state & QStyle::State_Top) states << QLatin1String("Top");+ −
if (state & QStyle::State_UpArrow) states << QLatin1String("UpArrow");+ −
+ −
qSort(states);+ −
debug << states.join(QLatin1String(" | "));+ −
debug << ')';+ −
#endif+ −
return debug;+ −
}+ −
+ −
/*!+ −
\since 4.6+ −
+ −
\fn const QStyle *QStyle::proxy() const+ −
+ −
This function returns the current proxy for this style.+ −
By default most styles will return themselves. However+ −
when a proxy style is in use, it will allow the style to+ −
call back into its proxy.+ −
*/+ −
const QStyle * QStyle::proxy() const+ −
{+ −
Q_D(const QStyle);+ −
return d->proxyStyle;+ −
}+ −
+ −
/* \internal+ −
+ −
This function sets the base style that style calls will be+ −
redirected to. Note that ownership is not transferred.+ −
*/+ −
void QStyle::setProxy(QStyle *style)+ −
{+ −
Q_D(QStyle);+ −
d->proxyStyle = style;+ −
}+ −
+ −
QT_END_NAMESPACE+ −