Udostępnij za pośrednictwem


Pen Klasa

Definicja

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
Implementuje

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()
Przestarzałe.

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()
Przestarzałe.

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.

Dotyczy