Pen Třída

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Zdroj:

Pen.cs

Definuje objekt použitý k kreslení čar a křivek. Tuto třídu nelze zdědit.

public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposable

public sealed class Pen : MarshalByRefObject, ICloneable, IDisposable

type Pen = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable

Public NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable

Dědičnost

Object

MarshalByRefObject

Pen

Implementuje

ICloneable IDisposable

Příklady

Následující příklad kódu ukazuje vytvoření Pen s a Brush účinky nastavení LineJoin vlastnosti na .Pen

Tento příklad je navržený tak, aby se používal s Windows Forms. Vložte kód do formuláře a zavolejte metodu ShowLineJoin při zpracování události formuláře Paint a předejte e jako PaintEventArgs.

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }

private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();
}

Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

Poznámky

Nakreslí Pen čáru zadané šířky a stylu. DashStyle Pomocí vlastnosti lze nakreslit několik odrůd přerušovaných čar. Čára nakreslená pomocí čáry Pen může být vyplněna různými styly výplně, včetně plných barev a textur. Styl výplně závisí na štětci nebo texturě, která se používá jako objekt výplně.

Poznámka:

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění v době kompilace a výjimky za běhu. Další informace naleznete v tématu System.Drawing.Common podporován pouze ve Windows.

Konstruktory

Name	Description
Pen(Brush, Single)	Inicializuje novou instanci Pen třídy se zadaným Brush a Width.
Pen(Brush)	Inicializuje novou instanci Pen třídy se zadaným Brush.
Pen(Color, Single)	Inicializuje novou instanci Pen třídy se zadanými Color a Width vlastnostmi.
Pen(Color)	Inicializuje novou instanci Pen třídy se zadanou barvou.

Vlastnosti

Name	Description
Alignment	Získá nebo nastaví zarovnání pro toto Pen.
Brush	Získá nebo nastaví Brush , který určuje atributy tohoto Pen.
Color	Získá nebo nastaví barvu tohoto Pen.
CompoundArray	Získá nebo nastaví pole hodnot, které určuje složené pero. Složené pero nakreslí složenou čáru složenou z paralelních čar a mezer.
CustomEndCap	Získá nebo nastaví vlastní cap použít na konci čar nakreslených tímto Pen.
CustomStartCap	Získá nebo nastaví vlastní cap pro použití na začátku čar nakreslených tímto Pen.
DashCap	Získá nebo nastaví styl zakončení použitý na konci pomlček, které tvoří přerušované čáry nakreslené tímto Pen.
DashOffset	Získá nebo nastaví vzdálenost od začátku čáry na začátek přerušované čáry.
DashPattern	Získá nebo nastaví pole vlastních pomlček a mezer.
DashStyle	Získá nebo nastaví styl použitý pro přerušované čáry nakreslené tímto Pen.
EndCap	Získá nebo nastaví styl zakončení použitý na konci čar nakreslených tímto Pen.
LineJoin	Získá nebo nastaví styl spojení pro konce dvou po sobě jdoucích čar nakreslených tímto Pen.
MiterLimit	Získá nebo nastaví limit tloušťky spojení v mitered rohu.
PenType	Získá styl čar nakreslených tímto Pen.
StartCap	Získá nebo nastaví styl cap použitý na začátku čar nakreslených tímto Pen.
Transform	Získá nebo nastaví kopii geometrické transformace pro toto Pen.
Width	Získá nebo nastaví šířku tohoto Penobjektu v jednotkách objektu použitého Graphics pro kreslení.

Metody

Name	Description
Clone()	Vytvoří přesnou kopii tohoto Pensouboru .
Dispose()	Uvolní všechny prostředky používané tímto Pennástrojem .
Finalize()	Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění před uvolněním paměti.
MultiplyTransform(Matrix, MatrixOrder)	Vynásobí transformační matici podle Pen zadaného Matrix pořadí.
MultiplyTransform(Matrix)	Vynásobí transformační matici podle Pen zadaného Matrix.
ResetTransform()	Obnoví geometrický transformační matici pro tuto Pen identitu.
RotateTransform(Single, MatrixOrder)	Otočí místní geometrické transformace podle zadaného úhlu v zadaném pořadí.
RotateTransform(Single)	Otočí místní geometrické transformace podle zadaného úhlu. Tato metoda předependuje otočení na transformaci.
ScaleTransform(Single, Single, MatrixOrder)	Škáluje místní geometrické transformace zadanými faktory v zadaném pořadí.
ScaleTransform(Single, Single)	Škáluje místní geometrické transformace zadanými faktory. Tato metoda předpíná matici škálování na transformaci.
SetLineCap(LineCap, LineCap, DashCap)	Nastaví hodnoty, které určují styl zakončení použitého pro koncové čáry nakreslené tímto Penzpůsobem .
TranslateTransform(Single, Single, MatrixOrder)	Přeloží místní geometrické transformace podle zadaných dimenzí v zadaném pořadí.
TranslateTransform(Single, Single)	Přeloží místní geometrické transformace podle zadaných dimenzí. Tato metoda předloží překlad na transformaci.