Pen Klasa

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Źródło:

Pen.cs

Definiuje obiekt używany do rysowania linii i krzywych. Tej klasy nie można dziedziczyć.

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

Dziedziczenie

Object

MarshalByRefObject

Pen

Implementuje

ICloneable IDisposable

Przykłady

W poniższym przykładzie kodu pokazano konstruowanie Pen elementu z elementem Brush i efekty ustawiania LineJoin właściwości na Penobiekcie .

Ten przykład został zaprojektowany do użycia z formularzami systemu Windows. Wklej kod do formularza i wywołaj ShowLineJoin metodę podczas obsługi zdarzenia formularza Paint , przekazując 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

Uwagi

Rysuje Pen linię o określonej szerokości i stylu. Użyj właściwości , DashStyle aby narysować kilka odmian linii przerywanych. Linia rysowana przez element Pen może być wypełniona różnymi stylami wypełnienia, w tym kolorami stałymi i teksturami. Styl wypełnienia zależy od pędzla lub tekstury używanej jako obiekt wypełnienia.

Uwaga / Notatka

W wersjach .NET 6 i nowszych pakiet System.Drawing.Common, który zawiera ten typ, jest obsługiwany tylko w systemach operacyjnych Windows. Użycie tego typu w aplikacjach międzyplatformowych powoduje ostrzeżenia w czasie kompilacji i wyjątki czasu wykonywania. Aby uzyskać więcej informacji, zobacz System.Drawing.Common supported only on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

Nazwa	Opis
Pen(Brush, Single)	Inicjuje nowe wystąpienie Pen klasy z określonymi Brush parametrami i Width.
Pen(Brush)	Inicjuje nowe wystąpienie Pen klasy z określonym Brushelementem .
Pen(Color, Single)	Inicjuje Pen nowe wystąpienie klasy z określonymi Color właściwościami i Width .
Pen(Color)	Inicjuje nowe wystąpienie Pen klasy o określonym kolorze.

Właściwości

Nazwa	Opis
Alignment	Pobiera lub ustawia wyrównanie dla tego Penelementu .
Brush	Pobiera lub ustawia Brush atrybuty tego Penelementu .
Color	Pobiera lub ustawia kolor tego Penelementu .
CompoundArray	Pobiera lub ustawia tablicę wartości, które określają pióro złożone. Pióro złożone rysuje złożoną linię składa się z linii równoległych i spacji.
CustomEndCap	Pobiera lub ustawia niestandardową czapkę do użycia na końcu linii narysowanych za pomocą tego elementu Pen.
CustomStartCap	Pobiera lub ustawia niestandardową czapkę do użycia na początku linii narysowanych za pomocą tego elementu Pen.
DashCap	Pobiera lub ustawia styl czapki używany na końcu kreski, które składają się na linie kreskowane rysowane za pomocą tego elementu Pen.
DashOffset	Pobiera lub ustawia odległość od początku linii do początku wzorca kreski.
DashPattern	Pobiera lub ustawia tablicę niestandardowych kreski i spacji.
DashStyle	Pobiera lub ustawia styl używany dla linii przerywanych rysowanych za pomocą tego elementu Pen.
EndCap	Pobiera lub ustawia styl czapki używany na końcu linii rysowanych za pomocą tego elementu Pen.
LineJoin	Pobiera lub ustawia styl sprzężenia dla końca dwóch kolejnych linii narysowanych za pomocą tego elementu Pen.
MiterLimit	Pobiera lub ustawia granicę grubości sprzężenia na zmiętym rogu.
PenType	Pobiera styl linii narysowanych za pomocą tego elementu Pen.
StartCap	Pobiera lub ustawia styl czapki używany na początku linii narysowanych za pomocą tego elementu Pen.
Transform	Pobiera lub ustawia kopię przekształcenia geometrycznego dla tego elementu Pen.
Width	Pobiera lub ustawia szerokość tego Penobiektu w jednostkach obiektu używanego Graphics do rysowania.

Metody

Nazwa	Opis
Clone()	Tworzy dokładną kopię tego elementu Pen.
Dispose()	Zwalnia wszystkie zasoby używane przez ten Penprogram .
Finalize()	Umożliwia obiektowi próbę zwolnienia zasobów i wykonania innych operacji oczyszczania przed odzyskaniem przez odzyskiwanie pamięci.
MultiplyTransform(Matrix, MatrixOrder)	Mnoży macierz transformacji dla tej Pen wartości przez określony Matrix w określonej kolejności.
MultiplyTransform(Matrix)	Mnoży macierz przekształceń dla tej Pen wartości przez określony Matrixelement .
ResetTransform()	Resetuje macierz transformacji geometrycznej dla tej Pen wartości do tożsamości.
RotateTransform(Single, MatrixOrder)	Obraca lokalną transformację geometryczną według określonego kąta w określonej kolejności.
RotateTransform(Single)	Obraca lokalną transformację geometryczną według określonego kąta. Ta metoda poprzedza rotację do przekształcenia.
ScaleTransform(Single, Single, MatrixOrder)	Skaluje lokalną transformację geometryczną według określonych czynników w określonej kolejności.
ScaleTransform(Single, Single)	Skaluje lokalną transformację geometryczną według określonych czynników. Ta metoda poprzedza macierz skalowania do przekształcenia.
SetLineCap(LineCap, LineCap, DashCap)	Ustawia wartości, które określają styl limitu używanego do kończenia wierszy rysowanych przez ten Penelement .
TranslateTransform(Single, Single, MatrixOrder)	Tłumaczy lokalną transformację geometryczną według określonych wymiarów w określonej kolejności.
TranslateTransform(Single, Single)	Tłumaczy lokalną transformację geometryczną według określonych wymiarów. Ta metoda poprzedza tłumaczenie przekształcenia.