# QPen Class Reference ## [[QtGui](index.htm) module] 該QPen類定義了一個[QPainter](qpainter.html)要繪制形狀的線條和輪廓。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, Qt.PenStyle)` * `__init__ (self, QColor?color)` * `__init__ (self, QBrush?brush, float?width, Qt.PenStyle?style?=?Qt.SolidLine, Qt.PenCapStyle?cap?=?Qt.SquareCap, Qt.PenJoinStyle?join?=?Qt.BevelJoin)` * `__init__ (self, QPen?pen)` * `__init__ (self, QVariant?variant)` * `QBrush brush (self)` * `Qt.PenCapStyle capStyle (self)` * `QColor color (self)` * `float dashOffset (self)` * `list-of-float dashPattern (self)` * `bool isCosmetic (self)` * `bool isSolid (self)` * `Qt.PenJoinStyle joinStyle (self)` * `float miterLimit (self)` * `setBrush (self, QBrush?brush)` * `setCapStyle (self, Qt.PenCapStyle?pcs)` * `setColor (self, QColor?color)` * `setCosmetic (self, bool?cosmetic)` * `setDashOffset (self, float?doffset)` * `setDashPattern (self, list-of-float?pattern)` * `setJoinStyle (self, Qt.PenJoinStyle?pcs)` * `setMiterLimit (self, float?limit)` * `setStyle (self, Qt.PenStyle)` * `setWidth (self, int?width)` * `setWidthF (self, float?width)` * `Qt.PenStyle style (self)` * `swap (self, QPen?other)` * `int width (self)` * `float widthF (self)` ### Special Methods * `bool __eq__ (self, QPen?p)` * `bool __ne__ (self, QPen?p)` * * * ## Detailed Description A [QColor](qcolor.html)可用于每當一個[QPen](qpen.html)預計。 該QPen類定義了一個[QPainter](qpainter.html)要繪制形狀的線條和輪廓。 一支筆有[style](qpen.html#style)（ ）[width](qpen.html#width)（ ）[brush](qpen.html#brush)（ ）[capStyle](qpen.html#capStyle)（）和[joinStyle](qpen.html#joinStyle)（ ） 。 筆式定義線型。畫筆用于填充用鋼筆生成的筆觸。使用[QBrush](qbrush.html)類指定填充樣式。帽風格決定了可使用畫線端蓋[QPainter](qpainter.html)，而加入的風格介紹了如何兩條線之間的連接被吸引。鋼筆的寬度可以在兩個整數來指定（[width](qpen.html#width)（ ） ）和浮點（[widthF](qpen.html#widthF)（ ） ）的精度。零線寬表示化妝品的筆。這意味著畫筆寬度總是繪制一個像素的寬度，獨立的[transformation](qpainter.html#coordinate-transformations)設置的畫家。 的各種設置可容易地使用相應的改性[setStyle](qpen.html#setStyle)（ ）[setWidth](qpen.html#setWidth)（ ）[setBrush](qpen.html#setBrush)（ ）[setCapStyle](qpen.html#setCapStyle)（）和[setJoinStyle](qpen.html#setJoinStyle)（ ）函數（注意，畫家的筆下必須改變畫筆的屬性時被重置） 。 例如： ``` [QPainter](qpainter.html) painter(this); QPen pen([Qt](qt.html).green, 3, [Qt](qt.html).DashDotLine, [Qt](qt.html).RoundCap, [Qt](qt.html).RoundJoin); painter.setPen(pen); ``` 這相當于 ``` [QPainter](qpainter.html) painter(this); QPen pen; // creates a default pen pen.setStyle([Qt](qt.html).DashDotLine); pen.setWidth(3); pen.setBrush([Qt](qt.html).green); pen.setCapStyle([Qt](qt.html).RoundCap); pen.setJoinStyle([Qt](qt.html).RoundJoin); painter.setPen(pen); ``` 默認的筆是一個純黑色畫筆0寬，方帽風格（[Qt.SquareCap](qt.html#PenCapStyle-enum)）和斜角連接樣式（[Qt.BevelJoin](qt.html#PenJoinStyle-enum)） 。 此外QPen提供[color](qpen.html#color)（）和[setColor](qpen.html#setColor)（ ）方便的功能來提取和設置畫筆的畫筆的顏色，分別為。筆也可以比較和流。 有關油畫一般的詳細信息，請參閱[Paint System](index.htm)文檔。 ### Pen Style Qt提供了幾個代表的內置樣式[Qt.PenStyle](qt.html#PenStyle-enum)枚舉： |  |  |  | | [Qt.SolidLine](qt.html#PenStyle-enum) | [Qt.DashLine](qt.html#PenStyle-enum) | [Qt.DotLine](qt.html#PenStyle-enum) | |  |  |  | | [Qt.DashDotLine](qt.html#PenStyle-enum) | [Qt.DashDotDotLine](qt.html#PenStyle-enum) | [Qt.CustomDashLine](qt.html#PenStyle-enum) | 簡單地使用[setStyle](qpen.html#setStyle)（）函數的筆式轉換為下列任一內置樣式，除了[Qt.CustomDashLine](qt.html#PenStyle-enum)風格，我們會回來不久。將樣式設置為[Qt.NoPen](qt.html#PenStyle-enum)告訴畫家不畫線或輪廓。默認的畫筆風格[Qt.SolidLine](qt.html#PenStyle-enum)。 由于Qt的4.1 ，也可以使用指定自定義虛線圖案的[setDashPattern](qpen.html#setDashPattern)（ ）函數，它的筆的款式隱式轉換為[Qt.CustomDashLine](qt.html#PenStyle-enum)。該模式的說法，一[QVector](index.htm)，必須指定為偶數的[qreal](index.htm#qreal-typedef)條目，其中這些條目1，3， 5 ...是虛線和2，4， 6 ...是空格。例如，上面顯示的自定義模式是使用下面的代碼創建： ``` QPen pen; [QVector](index.htm)<[qreal](index.htm#qreal-typedef)> dashes; [qreal](index.htm#qreal-typedef) space = 4; dashes << 1 << space << 3 << space << 9 << space << 27 << space << 9 << space; pen.setDashPattern(dashes); ``` 請注意，虛線圖案的鋼筆的寬度，如為單位指定長度為5的寬度為10的破折號是50像素長。 當前設定的虛線樣式可以使用檢索的[dashPattern](qpen.html#dashPattern)（）函數。使用[isSolid](qpen.html#isSolid)（ ）函數來確定筆是否為實心填充，還是不行。 ### Cap Style 帽樣式定義如何線路的終點使用繪制[QPainter](qpainter.html)。帽風格只適用于寬線，即當寬度大于或等于1 。該[Qt.PenCapStyle](qt.html#PenCapStyle-enum)枚舉提供了以下方式： |  |  |  | | [Qt.SquareCap](qt.html#PenCapStyle-enum) | [Qt.FlatCap](qt.html#PenCapStyle-enum) | [Qt.RoundCap](qt.html#PenCapStyle-enum) | 該[Qt.SquareCap](qt.html#PenCapStyle-enum)風格是一個正方形行結束，涵蓋了終點，一半線條寬度超出了它。該[Qt.FlatCap](qt.html#PenCapStyle-enum)樣式是方形線端未復蓋的線的終點。和[Qt.RoundCap](qt.html#PenCapStyle-enum)樣式是圓形的線端復蓋的終點。 默認值是[Qt.SquareCap](qt.html#PenCapStyle-enum)。 不論是否端點被繪制時，鋼筆的寬度為0或1取決于帽樣式。運用[Qt.SquareCap](qt.html#PenCapStyle-enum) or [Qt.RoundCap](qt.html#PenCapStyle-enum)它們被繪制，用[Qt.FlatCap](qt.html#PenCapStyle-enum)它們不繪制。 ### Join Style 在加入樣式定義如何將兩個連接線之間的連接可以使用繪制[QPainter](qpainter.html)。接合風格只適用于寬線，即當寬度大于或等于1 。該[Qt.PenJoinStyle](qt.html#PenJoinStyle-enum)枚舉提供了以下方式： |  |  |  | | [Qt.BevelJoin](qt.html#PenJoinStyle-enum) | [Qt.MiterJoin](qt.html#PenJoinStyle-enum) | [Qt.RoundJoin](qt.html#PenJoinStyle-enum) | 該[Qt.BevelJoin](qt.html#PenJoinStyle-enum)式填充兩條線之間的三角形缺口。該[Qt.MiterJoin](qt.html#PenJoinStyle-enum)風格延伸線，以滿足在一個角度。和[Qt.RoundJoin](qt.html#PenJoinStyle-enum)式填充兩條線之間的圓弧。 默認值是[Qt.BevelJoin](qt.html#PenJoinStyle-enum)。  當[Qt.MiterJoin](qt.html#PenJoinStyle-enum)樣式被應用，就可以使用[setMiterLimit](qpen.html#setMiterLimit)（ ）函數來指定多遠斜角連接可以擴展的連接點。該[miterLimit](qpen.html#miterLimit)（）是用于減少線路之間的工件接合處的線是接近平行。 該[miterLimit](qpen.html#miterLimit)（）必須在筆為單位指定寬度，例如： 5在寬度為10的斜接限制為50像素長。默認的斜接限制為2 ，即兩次以像素為單位的筆寬。 |  | **[The Path Stroking Demo](index.htm)**路徑描邊演示顯示了Qt內建的虛線樣式，并顯示自定義模式可以如何用來擴展現有模式的范圍。 | * * * ## Method Documentation ``` QPen.__init__ (self) ``` 構造一個默認的黑色實線與筆寬0 。 ``` QPen.__init__ (self, Qt.PenStyle) ``` 構造一個黑色的鋼筆0寬度和給定_style_。 **See also** [setStyle](qpen.html#setStyle)（ ） 。 ``` QPen.__init__ (self, QColor?color) ``` 構造一個實線畫筆0寬度和給定_color_。 **See also** [setBrush](qpen.html#setBrush)（）和[setColor](qpen.html#setColor)（ ） 。 ``` QPen.__init__ (self, QBrush?brush, float?width, Qt.PenStyle?style?=?Qt.SolidLine, Qt.PenCapStyle?cap?=?Qt.SquareCap, Qt.PenJoinStyle?join?=?Qt.BevelJoin) ``` 構造一個筆用指定的_brush_，_width_，筆_style_，_cap_風格和_join_風格。 **See also** [setBrush](qpen.html#setBrush)（ ）[setWidth](qpen.html#setWidth)（ ）[setStyle](qpen.html#setStyle)（ ）[setCapStyle](qpen.html#setCapStyle)（）和[setJoinStyle](qpen.html#setJoinStyle)（ ） 。 ``` QPen.__init__ (self, QPen?pen) ``` 構造一個Pen，它是給定一個副本_pen_。 ``` QPen.__init__ (self, QVariant?variant) ``` ``` QBrush QPen.brush (self) ``` [ 返回用于填充此筆筆劃產生的刷子。 ](qbrush.html) [**See also**](qbrush.html) [setBrush](qpen.html#setBrush)（ ） 。 ``` Qt.PenCapStyle QPen.capStyle (self) ``` [ 返回畫筆的端點風格。 ](qt.html#PenCapStyle-enum) [**See also**](qt.html#PenCapStyle-enum) [setCapStyle](qpen.html#setCapStyle)（）和[Cap Style](qpen.html#cap-style)。 ``` QColor QPen.color (self) ``` [ 返回此筆的畫筆的顏色。 ](qcolor.html) [**See also**](qcolor.html) [brush](qpen.html#brush)（）和[setColor](qpen.html#setColor)（ ） 。 ``` float QPen.dashOffset (self) ``` 返回破折號畫筆偏移。 **See also** [setDashOffset](qpen.html#setDashOffset)（ ） 。 ``` list-of-float QPen.dashPattern (self) ``` 返回此筆的虛線樣式。 **See also** [setDashPattern](qpen.html#setDashPattern)（ ）[style](qpen.html#style)（）和[isSolid](qpen.html#isSolid)（ ） 。 ``` bool QPen.isCosmetic (self) ``` 返回True如果筆是化妝品，否則返回False 。 化妝品的筆用于繪制具有一定寬度筆劃不管施加到任何轉換[QPainter](qpainter.html)它們被用于與。繪制形狀與化妝品筆確保其輪廓將具有相同的厚度在不同的比例系數。 零寬度的筆是化妝品默認情況下，用鋼筆一個非零寬度非化妝品。 **See also** [setCosmetic](qpen.html#setCosmetic)（）和[widthF](qpen.html#widthF)（ ） 。 ``` bool QPen.isSolid (self) ``` 如果筆有一個實心填充，否則為False ，則返回True 。 **See also** [style](qpen.html#style)（）和[dashPattern](qpen.html#dashPattern)（ ） 。 ``` Qt.PenJoinStyle QPen.joinStyle (self) ``` [ 返回畫筆的接合風格。 ](qt.html#PenJoinStyle-enum) [**See also**](qt.html#PenJoinStyle-enum) [setJoinStyle](qpen.html#setJoinStyle)（）和[Join Style](qpen.html#join-style)。 ``` float QPen.miterLimit (self) ``` 返回鋼筆斜接限制。斜接限制僅適用時加入樣式設置為[Qt.MiterJoin](qt.html#PenJoinStyle-enum)。 **See also** [setMiterLimit](qpen.html#setMiterLimit)（）和[Join Style](qpen.html#join-style)。 ``` QPen.setBrush (self, QBrush?brush) ``` 設置用于填充用這支筆生成的給定筆劃刷_brush_。 **See also** [brush](qpen.html#brush)（）和[setColor](qpen.html#setColor)（ ） 。 ``` QPen.setCapStyle (self, Qt.PenCapStyle?pcs) ``` 設置畫筆的端點風格為給定的_style_。缺省值是[Qt.SquareCap](qt.html#PenCapStyle-enum)。 **See also** [capStyle](qpen.html#capStyle)（）和[Cap Style](qpen.html#cap-style)。 ``` QPen.setColor (self, QColor?color) ``` 設置此筆的畫筆的顏色來定_color_。 **See also** [setBrush](qpen.html#setBrush)（）和[color](qpen.html#color)（ ） 。 ``` QPen.setCosmetic (self, bool?cosmetic) ``` 設置此筆化妝或不化妝，這取決于價值_cosmetic_。 **See also** [isCosmetic](qpen.html#isCosmetic)（ ） 。 ``` QPen.setDashOffset (self, float?doffset) ``` 設置在儀表偏移（在虛線模式的出發點）就本筆到_offset_規定。的偏移量的測量是在用于指定虛線圖案的單元計。 |  | For example, a pattern where each stroke is four units long, followed by a gap of two units, will begin with the stroke when drawn as a line.然而，如果破折號偏移量設置為4.0時，得出的任何線將開始與間隙。的偏移量高達4.0的值將導致中風的一部分首先被繪制，而值4.0和6.0之間的偏移將導致與開始的間隙部分就行了。 | **Note:**這種隱式轉換用筆的風格[Qt.CustomDashLine](qt.html#PenStyle-enum)。 **See also** [dashOffset](qpen.html#dashOffset)（ ） 。 ``` QPen.setDashPattern (self, list-of-float?pattern) ``` 設置此筆的虛線樣式給定的_pattern_。這種隱式轉換用筆的風格[Qt.CustomDashLine](qt.html#PenStyle-enum)。 圖案必須被指定為偶數陽性條目，其中這些條目1，3， 5 ...是虛線和2，4， 6 ...是空格。例如： |  | ``` [QPen](qpen.html) pen; [QVector](index.htm)&lt;[qreal](index.htm#qreal-typedef)&gt; dashes; [qreal](index.htm#qreal-typedef) space = 4; dashes &lt;&lt; 1 &lt;&lt; space &lt;&lt; 3 &lt;&lt; space &lt;&lt; 9 &lt;&lt; space &lt;&lt; 27 &lt;&lt; space &lt;&lt; 9 &lt;&lt; space; pen.setDashPattern(dashes); ``` | 虛線樣式被指定在鋼筆的寬度為單位;例如：長度為5的寬度為10的破折號是50像素長。需要注意的是零寬度的筆相當于一個化妝品筆與1個像素的寬度。 每個破折號也受到帽樣式，因此1方形帽套破折號將擴大0.5個像素在每個方向上產生2的總寬度。 請注意，默認帽風格[Qt.SquareCap](qt.html#PenCapStyle-enum)的，這意味著一個正方形線端復蓋了終點，并通過半線寬度延伸超過它。 **See also** [setStyle](qpen.html#setStyle)（ ）[dashPattern](qpen.html#dashPattern)（ ）[setCapStyle](qpen.html#setCapStyle)（）和[setCosmetic](qpen.html#setCosmetic)（ ） 。 ``` QPen.setJoinStyle (self, Qt.PenJoinStyle?pcs) ``` 設置畫筆的接合風格為給定的_style_。缺省值是[Qt.BevelJoin](qt.html#PenJoinStyle-enum)。 **See also** [joinStyle](qpen.html#joinStyle)（）和[Join Style](qpen.html#join-style)。 ``` QPen.setMiterLimit (self, float?limit) ``` 設置此筆的斜接限制為給定的_limit_。  斜接限制描述多遠斜角連接可以從連接點延伸。這是用來減少線路之間的工件接合處的線是接近平行。 該值不會只影響當筆樣式設置為[Qt.MiterJoin](qt.html#PenJoinStyle-enum)。該值在筆的寬度，如為單位指定5在寬度為10的斜接限制為50像素長。默認的斜接限制為2 ，即兩次以像素為單位的筆寬。 **See also** [miterLimit](qpen.html#miterLimit)（ ）[setJoinStyle](qpen.html#setJoinStyle)（）和[Join Style](qpen.html#join-style)。 ``` QPen.setStyle (self, Qt.PenStyle) ``` 設置畫筆樣式給定的_style_。 請參閱[Qt.PenStyle](qt.html#PenStyle-enum)文檔的可用樣式列表。由于Qt的4.1 ，也可以使用指定自定義虛線圖案的[setDashPattern](qpen.html#setDashPattern)（ ）函數，它的筆的款式隱式轉換為[Qt.CustomDashLine](qt.html#PenStyle-enum)。 **Note:**該函數復位破折號偏移為零。 **See also** [style](qpen.html#style)（）和[Pen Style](qpen.html#pen-style)。 ``` QPen.setWidth (self, int?width) ``` 設置鋼筆的寬度為給定的_width_與精確到整數像素。 零線寬表示化妝品的筆。這意味著畫筆寬度總是繪制一個像素的寬度，獨立的[transformation](qpainter.html#coordinate-transformations)設置的畫家。 設置畫筆寬度為負值，不支持。 **See also** [setWidthF](qpen.html#setWidthF)（）和[width](qpen.html#width)（ ） 。 ``` QPen.setWidthF (self, float?width) ``` 設置鋼筆的寬度為給定的_width_與浮點精度像素。 零線寬表示化妝品的筆。這意味著畫筆寬度總是繪制一個像素的寬度，獨立的[transformation](qpainter.html#coordinate-transformations)在畫家。 設置畫筆寬度為負值，不支持。 **See also** [setWidth](qpen.html#setWidth)（）和[widthF](qpen.html#widthF)（ ） 。 ``` Qt.PenStyle QPen.style (self) ``` [ 返回畫筆樣式。 ](qt.html#PenStyle-enum) [**See also**](qt.html#PenStyle-enum) [setStyle](qpen.html#setStyle)（）和[Pen Style](qpen.html#pen-style)。 ``` QPen.swap (self, QPen?other) ``` 筆掉期_other_用這種筆。這個操作是非常快的，而且永遠不會。 此功能被引入Qt的4.8 。 ``` int QPen.width (self) ``` 返回畫筆的寬度以整數精度。 **See also** [setWidth](qpen.html#setWidth)（）和[widthF](qpen.html#widthF)（ ） 。 ``` float QPen.widthF (self) ``` 返回與浮點精度的筆寬。 **See also** [setWidthF](qpen.html#setWidthF)（）和[width](qpen.html#width)（ ） 。 ``` bool QPen.__eq__ (self, QPen?p) ``` ``` bool QPen.__ne__ (self, QPen?p) ```