path: root/doc/man/man3/tqpen.3qt

'\" t
.TH TQPen 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*-
.\" Copyright 1992-2007 Trolltech ASA.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
TQPen \- Defines how a TQPainter should draw lines and outlines of shapes
.SH SYNOPSIS
\fC#include <tqpen.h>\fR
.PP
Inherits Qt.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBTQPen\fR ()"
.br
.ti -1c
.BI "\fBTQPen\fR ( PenStyle style )"
.br
.ti -1c
.BI "\fBTQPen\fR ( const TQColor & color, uint width = 0, PenStyle style = SolidLine )"
.br
.ti -1c
.BI "\fBTQPen\fR ( const TQColor & cl, uint w, PenStyle s, PenCapStyle c, PenJoinStyle j )"
.br
.ti -1c
.BI "\fBTQPen\fR ( const TQPen & p )"
.br
.ti -1c
.BI "\fB~TQPen\fR ()"
.br
.ti -1c
.BI "TQPen & \fBoperator=\fR ( const TQPen & p )"
.br
.ti -1c
.BI "PenStyle \fBstyle\fR () const"
.br
.ti -1c
.BI "void \fBsetStyle\fR ( PenStyle s )"
.br
.ti -1c
.BI "uint \fBwidth\fR () const"
.br
.ti -1c
.BI "void \fBsetWidth\fR ( uint w )"
.br
.ti -1c
.BI "const TQColor & \fBcolor\fR () const"
.br
.ti -1c
.BI "void \fBsetColor\fR ( const TQColor & c )"
.br
.ti -1c
.BI "PenCapStyle \fBcapStyle\fR () const"
.br
.ti -1c
.BI "void \fBsetCapStyle\fR ( PenCapStyle c )"
.br
.ti -1c
.BI "PenJoinStyle \fBjoinStyle\fR () const"
.br
.ti -1c
.BI "void \fBsetJoinStyle\fR ( PenJoinStyle j )"
.br
.ti -1c
.BI "bool \fBoperator==\fR ( const TQPen & p ) const"
.br
.ti -1c
.BI "bool \fBoperator!=\fR ( const TQPen & p ) const"
.br
.in -1c
.SH RELATED FUNCTION DOCUMENTATION
.in +1c
.ti -1c
.BI "TQDataStream & \fBoperator<<\fR ( TQDataStream & s, const TQPen & p )"
.br
.ti -1c
.BI "TQDataStream & \fBoperator>>\fR ( TQDataStream & s, TQPen & p )"
.br
.in -1c
.SH DESCRIPTION
The TQPen class defines how a TQPainter should draw lines and outlines of shapes.
.PP
A pen has a style, width, color, cap style and join style.
.PP
The pen style defines the line type. The default pen style is TQt::SolidLine. Setting the style to NoPen tells the painter to not draw lines or outlines.
.PP
When drawing 1 pixel wide diagonal lines you can either use a very fast algorithm (specified by a line width of 0, which is the default), or a slower but more accurate algorithm (specified by a line width of 1). For horizontal and vertical lines a line width of 0 is the same as a line width of 1. The cap and join style have no effect on 0-width lines.
.PP
The pen color defines the color of lines and text. The default line color is black. The TQColor documentation lists predefined colors.
.PP
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 (TQPainter::drawPolyline() etc.). The cap and join styles only apply to wide lines, i.e. when the width is 1 or greater.
.PP
Use the TQBrush class to specify fill styles.
.PP
Example:
.PP
.nf
.br
    TQPainter painter;
.br
    TQPen     pen( red, 2 );             // red solid line, 2 pixels wide
.br
    painter.begin( &anyPaintDevice );   // paint something
.br
    painter.setPen( pen );              // set the red, wide pen
.br
    painter.drawRect( 40,30, 200,100 ); // draw a rectangle
.br
    painter.setPen( blue );             // set blue pen, 0 pixel width
.br
    painter.drawLine( 40,30, 240,130 ); // draw a diagonal in rectangle
.br
    painter.end();                      // painting done
.br
.fi
.PP
See the TQt::PenStyle enum type for a complete list of pen styles.
.PP
With reference to the end points of lines, for wide (non-0-width) pens it depends on the cap style whether the end point is drawn or not. TQPainter 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.
.PP
A pen's color(), width(), style(), capStyle() and joinStyle() can be set in the constructor or later with setColor(), setWidth(), setStyle(), setCapStyle() and setJoinStyle(). Pens may also be compared and streamed.
.PP
<center>
.ce 1
.B "[Image Omitted]"
.PP
</center>
.PP
See also TQPainter, TQPainter::setPen(), Graphics Classes, Image Processing Classes, and Implicitly and Explicitly Shared Classes.
.SH MEMBER FUNCTION DOCUMENTATION
.SH "TQPen::TQPen ()"
Constructs a default black solid line pen with 0 width, which renders lines 1 pixel wide (fast diagonals).
.SH "TQPen::TQPen ( PenStyle style )"
Constructs a black pen with 0 width (fast diagonals) and style \fIstyle\fR.
.PP
See also setStyle().
.SH "TQPen::TQPen ( const TQColor & color, uint width = 0, PenStyle style = SolidLine )"
Constructs a pen with the specified \fIcolor\fR, \fIwidth\fR and \fIstyle\fR.
.PP
See also setWidth(), setStyle(), and setColor().
.SH "TQPen::TQPen ( const TQColor & cl, uint w, PenStyle s, PenCapStyle c, PenJoinStyle j )"
Constructs a pen with the specified color \fIcl\fR and width \fIw\fR. The pen style is set to \fIs\fR, the pen cap style to \fIc\fR and the pen join style to \fIj\fR.
.PP
A line width of 0 will produce a 1 pixel wide line using a fast algorithm for diagonals. A line width of 1 will also produce a 1 pixel wide line, but uses a slower more accurate algorithm for diagonals. For horizontal and vertical lines a line width of 0 is the same as a line width of 1. The cap and join style have no effect on 0-width lines.
.PP
See also setWidth(), setStyle(), and setColor().
.SH "TQPen::TQPen ( const TQPen & p )"
Constructs a pen that is a copy of \fIp\fR.
.SH "TQPen::~TQPen ()"
Destroys the pen.
.SH "PenCapStyle TQPen::capStyle () const"
Returns the pen's cap style.
.PP
See also setCapStyle().
.SH "const TQColor & TQPen::color () const"
Returns the pen color.
.PP
See also setColor().
.PP
Example: scribble/scribble.h.
.SH "PenJoinStyle TQPen::joinStyle () const"
Returns the pen's join style.
.PP
See also setJoinStyle().
.SH "bool TQPen::operator!= ( const TQPen & p ) const"
Returns TRUE if the pen is different from \fIp\fR; otherwise returns FALSE.
.PP
Two pens are different if they have different styles, widths or colors.
.PP
See also operator==().
.SH "TQPen & TQPen::operator= ( const TQPen & p )"
Assigns \fIp\fR to this pen and returns a reference to this pen.
.SH "bool TQPen::operator== ( const TQPen & p ) const"
Returns TRUE if the pen is equal to \fIp\fR; otherwise returns FALSE.
.PP
Two pens are equal if they have equal styles, widths and colors.
.PP
See also operator!=().
.SH "void TQPen::setCapStyle ( PenCapStyle c )"
Sets the pen's cap style to \fIc\fR.
.PP
The default value is FlatCap. The cap style has no effect on 0-width pens.
.PP
<center>
.ce 1
.B "[Image Omitted]"
.PP
</center>
.PP
\fBWarning:\fR On Windows 95/98 and Macintosh, the cap style setting has no effect. Wide lines are rendered as if the cap style was SquareCap.
.PP
See also capStyle().
.PP
Example: themes/wood.cpp.
.SH "void TQPen::setColor ( const TQColor & c )"
Sets the pen color to \fIc\fR.
.PP
See also color().
.PP
Examples:
.)l progress/progress.cpp and scribble/scribble.h.
.SH "void TQPen::setJoinStyle ( PenJoinStyle j )"
Sets the pen's join style to \fIj\fR.
.PP
The default value is MiterJoin. The join style has no effect on 0-width pens.
.PP
<center>
.ce 1
.B "[Image Omitted]"
.PP
</center>
.PP
\fBWarning:\fR On Windows 95/98 and Macintosh, the join style setting has no effect. Wide lines are rendered as if the join style was BevelJoin.
.PP
See also joinStyle().
.PP
Example: themes/wood.cpp.
.SH "void TQPen::setStyle ( PenStyle s )"
Sets the pen style to \fIs\fR.
.PP
See the TQt::PenStyle documentation for a list of all the styles.
.PP
\fBWarning:\fR On Mac OS X the style setting (other than NoPen and SolidLine) have no effect as they are not implemented by the underlying system.
.PP
\fBWarning:\fR On Windows 95/98, the style setting (other than NoPen and SolidLine) has no effect for lines with width greater than 1.
.PP
See also style().
.PP
Example: chart/chartform_canvas.cpp.
.SH "void TQPen::setWidth ( uint w )"
Sets the pen width to \fIw\fR.
.PP
A line width of 0 will produce a 1 pixel wide line using a fast algorithm for diagonals. A line width of 1 will also produce a 1 pixel wide line, but uses a slower more accurate algorithm for diagonals. For horizontal and vertical lines a line width of 0 is the same as a line width of 1. The cap and join style have no effect on 0-width lines.
.PP
See also width().
.PP
Examples:
.)l multiple/ax2.h, progress/progress.cpp, and scribble/scribble.h.
.SH "PenStyle TQPen::style () const"
Returns the pen style.
.PP
See also setStyle().
.SH "uint TQPen::width () const"
Returns the pen width.
.PP
See also setWidth().
.PP
Example: scribble/scribble.h.
.SH RELATED FUNCTION DOCUMENTATION
.SH "TQDataStream & operator<< ( TQDataStream & s, const TQPen & p )"
Writes the pen \fIp\fR to the stream \fIs\fR and returns a reference to the stream.
.PP
See also Format of the TQDataStream operators.
.SH "TQDataStream & operator>> ( TQDataStream & s, TQPen & p )"
Reads a pen from the stream \fIs\fR into \fIp\fR and returns a reference to the stream.
.PP
See also Format of the TQDataStream operators.

.SH "SEE ALSO"
.BR http://doc.trolltech.com/tqpen.html
.BR http://www.trolltech.com/faq/tech.html
.SH COPYRIGHT
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the
license file included in the distribution for a complete license
statement.
.SH AUTHOR
Generated automatically from the source code.
.SH BUGS
If you find a bug in Qt, please report it as described in
.BR http://doc.trolltech.com/bughowto.html .
Good bug reports help us to help you. Thank you.
.P
The definitive TQt documentation is provided in HTML format; it is
located at $TQTDIR/doc/html and can be read using TQt Assistant or with
a web browser. This man page is provided as a convenience for those
users who prefer man pages, although this format is not officially
supported by Trolltech. 
.P
If you find errors in this manual page, please report them to
.BR qt-bugs@trolltech.com .
Please include the name of the manual page (tqpen.3qt) and the Qt
version (3.3.8).