class KThemeStyle

This is a class for KDE themed styles. More...

Definition#include <kthemestyle.h>
InheritsKThemeBase
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Methods

Protected Members


Detailed Description

This is a class for KDE themed styles. It provides methods for drawing most widgets with user-specified borders, highlights, pixmaps, etc.. It also handles various other settings such as scrollbar types, rounded buttons, and shading types. For a full list of parameters this class handles refer to the KDE theme configuration documentation.

KThemeStyle (const QString &configFile = QString::null) : KThemeBase(configFile)

Constructs a new KThemeStyle object.

Parameters:
configFileA KConfig file to use as the theme configuration. Defaults to ~/.kderc.

void polish (QApplication *app)
[virtual]

By default this just sets the background brushes to the pixmapped background.

void drawBaseButton (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool sunken = FALSE, bool rounded = FALSE, WidgetType type=Bevel, const QBrush *fill = 0)
[virtual]

This is a convenience method for drawing widgets with borders, highlights, pixmaps, colors, etc... You specify the widget type and it will draw it according to the config file settings.

Parameters:
pThe QPainter to draw on.
gThe color group to use.
roundedTrue if the widget is rounded, false if rectangular.
typeThe widget type to paint.
fillAn optional fill brush. Currently ignored (the config file is used instead).

void drawBaseMask (QPainter *p, int x, int y, int w, int h, bool rounded)
[virtual]

Draws a mask with for widgets that may be rounded. Currently used by pushbuttons and comboboxes.

Parameters:
pThe QPainter to draw on.
roundedTrue if the widget is rounded, false if rectangular.

void drawButton (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool sunken = FALSE, const QBrush *fill = 0)
[virtual]

Draws a pushbutton. This calls drawBaseButton with PushButton as the widget type.

void drawBevelButton (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool sunken = FALSE, const QBrush *fill = 0)
[virtual]

Draws a bevel button. This calls drawBaseButton with Bevel as the widget type.

void drawKToolBarButton (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool sunken=false, bool raised = true, bool enabled = true, bool popup = false, KToolButtonType type = Icon, const QString &btext=QString::null, const QPixmap *icon=NULL, QFont *font=NULL)
[virtual]

Draws a toolbar button.

void drawKBarHandle (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool horizontal = false, QBrush *fill = NULL)
[virtual]

Draws the handle used in menu and toolbars.

void drawKToolBar (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool floating = false)
[virtual]

Draws a toolbar.

QRect buttonRect (int x, int y, int w, int h)
[virtual]

Returns the space available in a pushbutton, taking configurable borders and highlights into account.

void drawArrow (QPainter *p, Qt::ArrowType type, bool down, int x, int y, int w, int h, const QColorGroup &g, bool enabled=true, const QBrush *fill = 0)
[virtual]

Draws an arrow in the style specified by the config file.

QSize exclusiveIndicatorSize ()
[const virtual]

Returns the size of the exclusive indicator pixmap if one is specified in the config file, otherwise it uses the base style's size.

void drawExclusiveIndicator (QPainter* p, int x, int y, int w, int h, const QColorGroup &g, bool on, bool down = FALSE, bool enabled = TRUE)
[virtual]

Draws an exclusive indicator widget. If a pixmap is specified in the config file that is used, otherwise the base style's widget is drawn.

void drawExclusiveIndicatorMask (QPainter *p, int x, int y, int w, int h, bool on)
[virtual]

Sets the mask of an exclusive indicator widget. If a pixmap is specified it is masked according to it's transparent pixels, otherwise the base style's mask is used.

void drawIndicatorMask (QPainter *p, int x, int y, int w, int h, int state)
[virtual]

Sets the mask of an indicator widget. If a pixmap is specified it is masked according to it's transparent pixels, otherwise the base style's mask is used.

void drawButtonMask (QPainter *p, int x, int y, int w, int h)
[virtual]

Sets the mask for pushbuttons.

void drawComboButtonMask (QPainter *p, int x, int y, int w, int h)
[virtual]

Sets the mask for combo boxes.

QSize indicatorSize ()
[const virtual]

Returns the size of the indicator pixmap if one is specified in the config file, otherwise it uses the base style's size.

void drawIndicator (QPainter* p, int x, int y, int w, int h, const QColorGroup &g, int state, bool down = FALSE, bool enabled = TRUE)
[virtual]

Draws an indicator widget. If a pixmap is specified in the config file that is used, otherwise the base style's widget is drawn.

void drawComboButton (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool sunken = FALSE, bool editable = FALSE, bool enabled = TRUE, const QBrush *fill = 0)
[virtual]

Draws a combobox.

void drawPushButton (QPushButton* btn, QPainter *p)
[virtual]

Draws a pushbutton.

void getButtonShift (int &x, int &y)
[virtual]

Returns the amount of button content displacement specified by the config file.

int defaultFrameWidth ()
[const virtual]

Returns the frame width.

void scrollBarMetrics (const QScrollBar*, int&, int&, int&, int&)
[virtual]

Calculates the metrics of the scrollbar controls according to the layout specified by the config file.

void drawScrollBarControls (QPainter*, const QScrollBar*, int sliderStart, uint controls, uint activeControl)
[virtual]

Draws a themed scrollbar.

ScrollControl scrollBarPointOver (const QScrollBar*, int sliderStart, const QPoint& )
[virtual]

Returns the control that the given point is over according to the layout in the config file.

int sliderLength ()
[const virtual]

Returns the configurable default slider length.

void drawSlider (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, Orientation, bool tickAbove, bool tickBelow)
[virtual]

Draws a slider control.

void drawSliderGroove (QPainter *p, int x, int y, int w, int h, const QColorGroup& g, QCOORD c, Orientation )

Draws a slider groove.

void drawSliderMask (QPainter *p, int x, int y, int w, int h, Orientation, bool tickAbove, bool tickBelow)
[virtual]

Draws the mask for a slider (both the control and groove.

void drawScrollBarGroove (QPainter *p, const QScrollBar *sb, bool horizontal, QRect r, QColorGroup g)
[virtual]

Convience method for drawing themed scrollbar grooves. Since the grooves may be a scaled pixmap you cannot just bitblt the pixmap at any offset. This generates a cached pixmap at full size if needed and then copies the requested area.

Parameters:
pThe painter to draw on.
sbThe scrollbar (usually given by drawScrollBarControls).
horizontalIs the scrollBar horizontal?
rThe rectangle to fill.
gThe color group to use.

void drawShade (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool sunken, bool rounded, int hWidth, int bWidth, ShadeStyle style)
[virtual]

Draws a shaded rectangle using the given style.

Parameters:
pThe painter to draw on.
gThe color group to use.
roundedDraws a rounded shape if true. Requires bWidth to be at least 1.
hWidthThe highlight width.
bWidthThe border width.
styleThe shading style to use.

void drawPushButtonLabel (QPushButton *btn, QPainter *p)
[virtual]

Draws the text for a pushbutton.

void drawKMenuBar (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, QBrush *fill=NULL)
[virtual]

Draws a menubar.

void drawKMenuItem (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool active, QMenuItem *item, QBrush *fill=NULL)
[virtual]

Draws a menubar item.

int splitterWidth ()
[const virtual]

Returns the width of the splitter as specified in the config file.

void drawSplitter (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, Orientation)
[virtual]

Draws a splitter widget.

void drawCheckMark (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool act, bool dis)
[virtual]

Draws a checkmark.

void drawPopupMenuItem (QPainter *p, bool checkable, int maxpmw, int tab, QMenuItem *mi, const QPalette &pal, bool act, bool enabled, int x, int y, int w, int h)
[virtual]

Draws a menu item. Note: This method manually handles applying inactive menu backgrounds to the entire widget.

void drawFocusRect (QPainter *p, const QRect &r, const QColorGroup &g, const QColor *c=0, bool atBorder=false)

Draws the focus rectangle.

void drawKProgressBlock (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, QBrush *fill)
[virtual]

Draws a KProgess Bar.

void getKProgressBackground (const QColorGroup &g, QBrush &bg)
[virtual]

Returns the background for KProgress.

void drawToolButton (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, bool sunken=false, const QBrush *fill=0)
[virtual]

Provided for compatibility with with QToolBar for use with the new KDE Parts mechanism. This should not be reimplemented, drawKToolBarButton should be used instead.

void drawOPToolBar (QPainter *p, int x, int y, int w, int h, const QColorGroup &g, QBrush *fill=NULL)
[virtual]

Provided for compatibility with with QToolBar for use with the new KDE Parts mechanism. This should not be reimplemented, drawKToolBar should be used instead.


Generated by: root@tantive.terraplex.com on Sun Feb 27 17:39:25 2000, using kdoc 2.0a33.