Encapsulates common Look and Feel of a GUI. More...
#include <qstyle.h>
Inherits QObject.
Inherited by QCommonStyle.
While it is not possible to fully enumerate the look of graphic elements and the feel of widgets in a GUI, a large number of elements are common to many widgets. The QStyle class allows the look of these elements to be modified across all widgets that use the QStyle methods. It also provides two feel options - Motif and Windows.
In previous versions of Qt, the look and feel option for widgets was specified by a single value - the GUIStyle. Starting with Qt 2.0, this notion has been expanded to allow the look to be specified by virtual drawing functions.
Derived classes may reimplement some or all of the drawing functions to modify the look of all widgets which utilize those functions.
Examples: themes/main.cpp
AddLine
- control to scroll one line down, usually an arrow button
SubLine
- control to scroll one line up, usually an arrow button
AddPage
- control to scroll one page down
SubPage
- control to scroll one page up
Slider
- the slider control
NoScroll
- null value, indiciates none of the visible controls
[virtual]
Destructs the style.
Returns the rectangle available for contents in a bevel button. Usually this is the entire rectangle minus the border, but it may also be smaller when you think about rounded buttons.
See also: drawBevelButton().
Returns the width of the default-button indicator frame.
In this version of the Qt library, subclasses must call setButtonDefaultIndicatorWidth() to change the frame width. In a future version of Qt, this function will become virtual.
[virtual]
Returns the rectangle available for contents in a push button. Usually this is the entire rectangle minus the border, but it may also be smaller when you think about rounded buttons.
See also: drawButton().
Reimplemented in QPlatinumStyle.
[virtual]
Returns the rectangle used to draw the the focus rectangle in a combo box.
Reimplemented in QPlatinumStyle, QCommonStyle, QMotifStyle and QWindowsStyle.
[virtual]
Returns the rectangle available for contents in a combo box button. Usually this is the entire rectangle without the nifty menu indicator, but it may also be smaller when you think about rounded buttons.
Reimplemented in QWindowsStyle, QCommonStyle, QMotifStyle and QPlatinumStyle.
[virtual]
The default frame width, usually 2.
Reimplemented in QCommonStyle and QCDEStyle.
[virtual]
Draws an arrow to indicate direction. Used for example in scrollbars and spin-boxes.
[virtual]
Draws a press-sensitive shape in the style of a bevel button.
See also: bevelButtonRect().
Reimplemented in QMotifStyle, QWindowsStyle and QPlatinumStyle.
[virtual]
Draws a press-sensitive shape in the style of a full featured push button
See also: buttonRect().
Reimplemented in QPlatinumStyle, QMotifStyle and QWindowsStyle.
[virtual]
Draw the mask of a pushbutton. Useful if a rounded pushbuttons needs to be transparent because the style uses a fancy background pixmap.
See also: drawButtonMask().
[virtual]
Draws a press-sensitive shape in the style of a combo box or menu button.
Reimplemented in QPlatinumStyle, QWindowsStyle, QMotifStyle and QCommonStyle.
[virtual]
Draw the mask of a combo box button. Useful if a rounded buttons needs to be transparent because the style uses a fancy background pixmap.
Reimplemented in QCommonStyle.
[virtual]
Draws a mark indicating the state of an exclusive choice.
Reimplemented in QWindowsStyle, QMotifStyle, QPlatinumStyle and QCDEStyle.
[virtual]
Draws the mask of a mark indicating the state of an exclusive choice.
Reimplemented in QMotifStyle and QWindowsStyle.
[virtual]
Draws a mark indicating keyboard focus is on r. atBorder indicates whether the focus rectangle is at the border of an item (for example an item in a listbox). Certain styles (Motif style as the most prominent example) might have to shrink the rectangle a bit in that case to ensure that the focus rectangle is visible at all.
Reimplemented in QWindowsStyle and QMotifStyle.
[virtual]
Draws a mark indicating the state of a choice.
Reimplemented in QCDEStyle, QMotifStyle, QPlatinumStyle and QWindowsStyle.
[virtual]
Draws the mask of a mark indicating the state of a choice.
Reimplemented in QPlatinumStyle.
[virtual]
Draw text or a pixmap in an area.
[virtual]
Draws a panel to separate parts of the visual interface.
Reimplemented in QWindowsStyle.
[virtual]
Draws a panel suitable as frame for popup windows.
Reimplemented in QWindowsStyle and QPlatinumStyle.
[virtual]
Draws a pushbutton. This function will normally call drawButton() with arguments according to the current state of the pushbutton.
See also: drawPushButtonLabel() and QPushButton::drawButton().
Reimplemented in QPlatinumStyle, QMotifStyle and QWindowsStyle.
[virtual]
Draws the label of a pushbutton. This function will normally call drawItem() with arguments according to the current state of the pushbutton.
In reimplementions of this function, you will find pushButtonContentsRect() useful.
See also: drawPushButton() and QPushButton::drawButtonLabel().
Reimplemented in QCommonStyle and QPlatinumStyle.
[virtual]
Draws a simple rectangle to separate parts of the visual interface.
[virtual]
Draws an emphasized rectangle to strongly separate parts of the visual interface.
[virtual]
Draws the given scrollbar. Used internally by QScrollbar.
The controls are either ADD_LINE, SUB_LINE, ADD_PAGE, SUB_PAGE, FIRST, LAST, SLIDER or NONE
Controls is a combination of these, activeControl is the control currently pressed down.
Reimplemented in QPlatinumStyle, QMotifStyle and QWindowsStyle.
[virtual]
Draws a line to separate parts of the visual interface.
[virtual]
Draws a slider.
Reimplemented in QPlatinumStyle, QMotifStyle and QWindowsStyle.
[virtual]
Draws a slider groove.
Reimplemented in QWindowsStyle, QPlatinumStyle and QMotifStyle.
[virtual]
Draws the mask of a slider groove.
Reimplemented in QCommonStyle.
[virtual]
Draws the mask of a slider.
Reimplemented in QWindowsStyle and QCommonStyle.
[virtual]
Draws a splitter handle in the rectangle described by x, y, w, h using painter p and color group g. The orientation is orient.
See also: splitterWidth().
Reimplemented in QMotifStyle and QWindowsStyle.
[virtual]
TODO.
Reimplemented in QMotifStyle, QWindowsStyle and QCommonStyle.
[virtual]
TODO.
Reimplemented in QWindowsStyle, QMotifStyle and QCommonStyle.
Draws the handle for the toolbar using the painter p with the toolbar coordinates r. orientation gives the orientation of the toolbar, and the handle is drawn highlighted if highlight is TRUE, else not. cg is the QColorGroup of the toolbar and if drawBorder is TRUE a border around the handle may be drawn.
WARNING: Because of binary compatibility this method is NOT virtual, so reimplementing it in Qt 2.x doesn't make sense. In the next major release this method will become virtual!.
[virtual]
Draws a press-sensitive shape in the style of a toolbar button
The default implementation calls drawBevelButton()
See also: drawBevelButton().
[virtual]
Returns the size of the mark used to indicate exclusive choice.
Reimplemented in QPlatinumStyle, QMotifStyle and QWindowsStyle.
[virtual]
Returns the extra width of a menu item mi, that means all extra pixels besides the space the menu item text requires. checkable defines, whether the menu has a check column. maxpmw is the maximium width of all iconsets within a check column and fm defines the font metrics used to draw the label. This is particulary useful to calculate a suitable size for a submenu indicator or the column separation, including the tab column used to indicate item accelerators.
Reimplemented in QPlatinumStyle and QWindowsStyle.
[virtual]
Some GUI styles shift the contents of a button when the button is down. The default implementation returns 0 for both x and y.
Reimplemented in QWindowsStyle and QCommonStyle.
Returns an indicator to the additional "feel" component of a style. Current supported values are Windows and Motif.
[virtual]
Returns the size of the mark used to indicate choice.
Reimplemented in QPlatinumStyle, QWindowsStyle and QMotifStyle.
[virtual]
Returns the appropriate area within a rectangle in which to draw text or a pixmap.
[virtual]
Some feels require the scrollbar or other sliders to jump back to the original position when the mouse pointer is too far away while dragging.
This behavior can be customized with this function. The default is -1 (no jump back) while Windows requires 20 (weird jump back).
Reimplemented in QPlatinumStyle, QCommonStyle and QWindowsStyle.
Returns the width of the menu button indicator for a given button height h.
[virtual]
Late initialization of the QApplication object.
See also: unPolish.
Reimplemented in QMotifStyle.
[virtual]
The style may have certain requirements for color palettes. In this function it has the chance to change the palette according to these requirements.
See also: unPolish, QPalette and QApplication::setPalette().
[virtual]
Initializes the appearance of a widget.
This function is called for every widget, after it has been fully created just before it is shown the very first time.
Reasonable actions in this function might be to set the of the widget and the background pixmap, for example. Unreasonable use would be setting the geometry!
The QWidget::inherits() function may provide enough information to allow class-specific customizations. But be careful not to hard-code things too much, as new QStyle sub-classes will be expected to work reasonably with all current and future widgets.
Returns a QSize containing the width of a vertical scrollbar and the height of a horizontal scrollbar in this style.
In this version of the Qt library, subclasses must call setScrollBarExtent() to change the extent of scrollbars. In a future version of Qt, this function will become virtual.
[virtual]
Returns the metrics of the passed scrollbar: sliderMin, sliderMax, sliderLength and buttonDim.
Reimplemented in QPlatinumStyle, QWindowsStyle and QMotifStyle.
Returns the scrollbar control under the passed point.
[protected]
Sets the width of the default-button indicator frame.
In a future version of the Qt library, this function will be removed and subclasses will be able to reimplement buttonDefaultIndicatorWidth().
[protected]
Sets the width of a vertical scrollbar in this style to width and the height of a horizontal scrollbar to height. If height is negative, width will be used for both extents. By default both extents are 16 pixels.
In a future version of the Qt library, this function will be removed and subclasses will be able to reimplement scrollBarExtent().
[virtual]
The length of a slider.
Reimplemented in QPlatinumStyle, QMotifStyle and QWindowsStyle.
[virtual]
Returns the width of a splitter handle.
See also: drawSplitter().
Reimplemented in QMotifStyle and QWindowsStyle.
[virtual]
TODO.
Reimplemented in QMotifStyle, QWindowsStyle and QCommonStyle.
Returns the extend (height or width depending on the orientation) which a toolbar handle has.
WARNING: Because of binary compatibility this method is NOT virtual, so reimplementing it in Qt 2.x doesn't make sense. In the next major release this method will become virtual!.
Returns the rectangle available for contents in a tool button. Usually this is the entire rectangle minus the border, but it may also be smaller when you think about rounded buttons.
The default implementation returns bevelButtonRect()
See also: drawToolButton().
[virtual]
Redo the application polish
See also: polish.
[virtual]
Undos the initializataion of a widget's appearance
This function is the counterpart to polish. Is is called for every polished widget when the style is dynamically changed. The former style has to un-polish its settings before the new style can polish them again.
Search the documentation, FAQ, qt-interest archive and more (uses
www.troll.no):
This file is part of the Qt toolkit, copyright © 1995-2000 Troll Tech, all rights reserved.
Copyright İ 2000 Troll Tech | Trademarks | Qt version 2.1.0 (pre-release)
|