![]() |
| ||
Classes - Annotated - Tree - Functions - Home - Structure |
The QPen class defines how a QPainter should draw lines and outlines of shapes. More...
#include <qpen.h>
Inherits Qt.
A pen has a style, a width, a color, a cap style and a join style.
The pen style defines the line type. The default pen style is Qt::SolidLine. Setting the style to NoPen tells the painter to not draw lines or outlines.
The pen width defines the line width. The default line width is 0, which draws a 1-pixel line very fast, but with lower precision than with a line width of 1. Setting the line width to 1 or more draws lines that are precise, but drawing is slower.
The pen color defines the color of lines and text. The default line color is black. The QColor documentation lists predefined colors.
The cap style defines how the end points of lines are drawn. The join style defines how the joins between two lines are drawn when multiple connected lines are drawn (QPainter::drawPolyLine() etc.). The cap and join styles apply only to wide lines, i.e., when the width is 1 or greater.
Use the QBrush class to specify fill styles.
Example:
QPainter painter; QPen pen( red, 2 ); // red solid line, 2 pixel width painter.begin( &anyPaintDevice ); // paint something painter.setPen( pen ); // set the red, fat pen painter.drawRect( 40,30, 200,100 ); // draw rectangle painter.setPen( blue ); // set blue pen, 0 pixel width painter.drawLine( 40,30, 240,130 ); // draw diagonal in rectangle painter.end(); // painting done
See the setStyle() function for a complete list of pen styles.
With reference to end point of lines, for wide (non-0-width) pens it depends on the cap style whether the end point is drawn or not. QPainter will try to make sure that the end point is drawn for 0-width pens, but this cannot be absolutely guaranteed because the underlying drawing engine is free to use any (typically accelerated) algorithm for drawing 0-width lines. On all tested systems, however, the end point of at least all non-diagonal lines are drawn.
See also QPainter and QPainter::setPen().
See also setStyle().
See also setWidth(), setStyle() and setColor().
See also setWidth(), setStyle() and setColor().
See also setCapStyle().
See also setColor().
Example: scribble/scribble.h.
See also setJoinStyle().
Returns TRUE if the pen is different from p, or FALSE if the pens are equal.
Two pens are different if they have different styles, widths or colors.
See also operator==().
Two pens are equal if they have equal styles, widths and colors.
See also operator!=().
The default value is FlatCap. The cap style has no effect on 0-width pens.
Warning: On Windows 95/98, the cap style setting has no effect. Wide lines are rendered as if the cap style was SquareCap.
See also capStyle().
Example: themes/wood.cpp.
See also color().
Examples: progress/progress.cpp and scribble/scribble.h.
The default value is MiterJoin. The join style has no effect on 0-width pens.
Warning: On Windows 95/98, the join style setting has no effect. Wide lines are rendered as if the join style was BevelJoin.
See also joinStyle().
Example: themes/wood.cpp.
Warning: On Windows 95/98, the style setting (other than NoPen and SolidLine) has no effect for lines with width greater than 1.
See also style().
See also width().
Examples: progress/progress.cpp and scribble/scribble.h.
See also setStyle().
See also setWidth().
Example: scribble/scribble.h.
See also Format of the QDataStream operators.
See also Format of the QDataStream operators.
Search the documentation, FAQ, qt-interest archive and more (uses
www.trolltech.com):
This file is part of the Qt toolkit, copyright © 1995-2001 Trolltech, all rights reserved.
Copyright © 2001 Trolltech | Trademarks | Qt version 3.0.0-beta2
|