Pen Klasa

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Definiuje obiekt używany do rysowania linii i krzywych. Klasa ta nie może być dziedziczona.

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 elementu Pen z elementem i Brush efekty ustawiania LineJoin właściwości na obiekcie Pen.

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

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

Uwaga

W programie .NET 6 i nowszych wersjach pakiet System.Drawing.Common, który obejmuje 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 only supported on Windows (Obsługiwane tylko w systemie Windows).

Konstruktory

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

Właściwości

Alignment	Pobiera lub ustawia wyrównanie dla tego Pen.
Brush	Pobiera lub ustawia Brush atrybuty tego Penelementu .
Color	Pobiera lub ustawia kolor tego Penelementu .
CompoundArray	Pobiera lub ustawia tablicę wartości, która określa pióro złożone. Pióro złożone rysuje złożoną linię składa się z równoległych linii i spacji.
CustomEndCap	Pobiera lub ustawia niestandardową czapkę, która ma być używana na końcu linii narysowanych za pomocą elementu Pen.
CustomStartCap	Pobiera lub ustawia niestandardową czapkę, która ma być używana na początku linii narysowanych za pomocą elementu Pen.
DashCap	Pobiera lub ustawia styl czapki używany na końcu kreski, które składają się na linie kreskowane rysowane z tym Pen.
DashOffset	Pobiera lub ustawia odległość od początku linii do początku wzorca kreski.
DashPattern	Pobiera lub ustawia tablicę niestandardowych kresek i spacji.
DashStyle	Pobiera lub ustawia styl używany dla linii przerywanych rysowanych za pomocą tego Penelementu .
EndCap	Pobiera lub ustawia styl czapki używany na końcu linii rysowanych za pomocą tego Penelementu .
LineJoin	Pobiera lub ustawia styl sprzężenia dla końców dwóch kolejnych linii narysowanych za pomocą tego Penelementu .
MiterLimit	Pobiera lub ustawia granicę grubości sprzężenia w zmiętnym rogu.
PenType	Pobiera styl linii narysowanych za pomocą tego Penelementu .
StartCap	Pobiera lub ustawia styl czapki używany na początku linii rysowanych za pomocą tej Penwartości .
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

Clone()	Tworzy dokładną kopię tego elementu Pen.
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszystkie zasoby używane przez ten Penprogram .
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Finalize()	Umożliwia obiektowi próbę zwolnienia zasobów i wykonania innych operacji oczyszczania przed odzyskaniem przez odzyskiwanie pamięci.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
MultiplyTransform(Matrix)	Mnoży macierz przekształcania dla tej Pen wartości przez określony Matrixelement .
MultiplyTransform(Matrix, MatrixOrder)	Mnoży macierz przekształcania dla tej Pen wartości przez określony Matrix w określonej kolejności.
ResetTransform()	Resetuje macierz przekształcania geometrycznego dla tej Pen wartości do tożsamości.
RotateTransform(Single)	Obraca lokalną transformację geometryczną według określonego kąta. Ta metoda poprzedza rotację przekształcenia.
RotateTransform(Single, MatrixOrder)	Obraca lokalne przekształcenie geometryczne według określonego kąta 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.
ScaleTransform(Single, Single, MatrixOrder)	Skaluje lokalną transformację geometryczną według określonych czynników w określonej kolejności.
SetLineCap(LineCap, LineCap, DashCap)	Ustawia wartości, które określają styl limitu używanego do kończenia linii rysowanych przez ten Penelement .
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TranslateTransform(Single, Single)	Tłumaczy lokalną transformację geometryczną według określonych wymiarów. Ta metoda poprzedza tłumaczenie przekształcenia.
TranslateTransform(Single, Single, MatrixOrder)	Tłumaczy lokalną transformację geometryczną według określonych wymiarów w określonej kolejności.