qpen man page on aLinux

Man page or keyword search:  
man Server   7435 pages
apropos Keyword Search (all sections)
Output format
aLinux logo
[printable version]

QPen(3qt)							     QPen(3qt)

NAME
       QPen - Defines how a QPainter should draw lines and outlines of shapes

SYNOPSIS
       #include <qpen.h>

       Inherits Qt.

   Public Members
       QPen ()
       QPen ( PenStyle style )
       QPen ( const QColor & color, uint width = 0, PenStyle style = SolidLine
	   )
       QPen ( const QColor & cl, uint w, PenStyle s, PenCapStyle c,
	   PenJoinStyle j )
       QPen ( const QPen & p )
       ~QPen ()
       QPen & operator= ( const QPen & p )
       PenStyle style () const
       void setStyle ( PenStyle s )
       uint width () const
       void setWidth ( uint w )
       const QColor & color () const
       void setColor ( const QColor & c )
       PenCapStyle capStyle () const
       void setCapStyle ( PenCapStyle c )
       PenJoinStyle joinStyle () const
       void setJoinStyle ( PenJoinStyle j )
       bool operator== ( const QPen & p ) const
       bool operator!= ( const QPen & p ) const

RELATED FUNCTION DOCUMENTATION
       QDataStream & operator<< ( QDataStream & s, const QPen & p )
       QDataStream & operator>> ( QDataStream & s, QPen & p )

DESCRIPTION
       The QPen class defines how a QPainter should draw lines and outlines of
       shapes.

       A pen has a style, width, color, cap style and 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.

       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.

       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 only apply 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 pixels wide
	   painter.begin( &anyPaintDevice );   // paint something
	   painter.setPen( pen );	       // set the red, wide pen
	   painter.drawRect( 40,30, 200,100 ); // draw a rectangle
	   painter.setPen( blue );	       // set blue pen, 0 pixel width
	   painter.drawLine( 40,30, 240,130 ); // draw a diagonal in rectangle
	   painter.end();		       // painting done

       See the Qt::PenStyle enum type for a complete list of pen styles.

       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.
       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.

       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.

       <center>
				   [Image Omitted]

       </center>

       See also QPainter, QPainter::setPen(), Graphics Classes, Image
       Processing Classes, and Implicitly and Explicitly Shared Classes.

MEMBER FUNCTION DOCUMENTATION
QPen::QPen ()
       Constructs a default black solid line pen with 0 width, which renders
       lines 1 pixel wide (fast diagonals).

QPen::QPen ( PenStyle style )
       Constructs a black pen with 0 width (fast diagonals) and style style.

       See also setStyle().

QPen::QPen ( const QColor & color, uint width = 0, PenStyle style = SolidLine
       )
       Constructs a pen with the specified color, width and style.

       See also setWidth(), setStyle(), and setColor().

QPen::QPen ( const QColor & cl, uint w, PenStyle s, PenCapStyle c,
       PenJoinStyle j )
       Constructs a pen with the specified color cl and width w. The pen style
       is set to s, the pen cap style to c and the pen join style to j.

       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.

       See also setWidth(), setStyle(), and setColor().

QPen::QPen ( const QPen & p )
       Constructs a pen that is a copy of p.

QPen::~QPen ()
       Destroys the pen.

PenCapStyle QPen::capStyle () const
       Returns the pen's cap style.

       See also setCapStyle().

const QColor & QPen::color () const
       Returns the pen color.

       See also setColor().

       Example: scribble/scribble.h.

PenJoinStyle QPen::joinStyle () const
       Returns the pen's join style.

       See also setJoinStyle().

bool QPen::operator!= ( const QPen & p ) const
       Returns TRUE if the pen is different from p; otherwise returns FALSE.

       Two pens are different if they have different styles, widths or colors.

       See also operator==().

QPen & QPen::operator= ( const QPen & p )
       Assigns p to this pen and returns a reference to this pen.

bool QPen::operator== ( const QPen & p ) const
       Returns TRUE if the pen is equal to p; otherwise returns FALSE.

       Two pens are equal if they have equal styles, widths and colors.

       See also operator!=().

void QPen::setCapStyle ( PenCapStyle c )
       Sets the pen's cap style to c.

       The default value is FlatCap. The cap style has no effect on 0-width
       pens.

       <center>
				   [Image Omitted]

       </center>

       Warning: On Windows 95/98 and Macintosh, 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.

void QPen::setColor ( const QColor & c )
       Sets the pen color to c.

       See also color().

       Examples:

void QPen::setJoinStyle ( PenJoinStyle j )
       Sets the pen's join style to j.

       The default value is MiterJoin. The join style has no effect on 0-width
       pens.

       <center>
				   [Image Omitted]

       </center>

       Warning: On Windows 95/98 and Macintosh, 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.

void QPen::setStyle ( PenStyle s )
       Sets the pen style to s.

       See the Qt::PenStyle documentation for a list of all the styles.

       Warning: On Mac OS X the style setting (other than NoPen and SolidLine)
       have no effect as they are not implemented by the underlying system.

       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().

       Example: chart/chartform_canvas.cpp.

void QPen::setWidth ( uint w )
       Sets the pen width to w.

       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.

       See also width().

       Examples:

PenStyle QPen::style () const
       Returns the pen style.

       See also setStyle().

uint QPen::width () const
       Returns the pen width.

       See also setWidth().

       Example: scribble/scribble.h.

RELATED FUNCTION DOCUMENTATION
QDataStream & operator<;< ( QDataStream & s, const QPen & p )
       Writes the pen p to the stream s and returns a reference to the stream.

       See also Format of the QDataStream operators.

QDataStream & operator>> ( QDataStream & s, QPen & p )
       Reads a pen from the stream s into p and returns a reference to the
       stream.

       See also Format of the QDataStream operators.

SEE ALSO
       http://doc.trolltech.com/qpen.html
       http://www.trolltech.com/faq/tech.html

COPYRIGHT
       Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the
       license file included in the distribution for a complete license
       statement.

AUTHOR
       Generated automatically from the source code.

BUGS
       If you find a bug in Qt, please report it as described in
       http://doc.trolltech.com/bughowto.html.	Good bug reports help us to
       help you. Thank you.

       The definitive Qt documentation is provided in HTML format; it is
       located at $QTDIR/doc/html and can be read using Qt 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.

       If you find errors in this manual page, please report them to qt-
       bugs@trolltech.com.  Please include the name of the manual page
       (qpen.3qt) and the Qt version (3.3.8).

Trolltech AS			2 February 2007			     QPen(3qt)
[top]

List of man pages available for aLinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net