Pen Klasa

Definicja

Definiuje obiekt używany do rysowania linii i krzywych.Defines an object used to draw lines and curves. Klasa ta nie może być dziedziczona.This class cannot be inherited.

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

Poniższy przykład kodu demonstruje konstrukcja a Pen Brush i efekty ustawienia LineJoin właściwości w Pen .The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

Ten przykład jest przeznaczony do użycia z Windows Forms.This example is designed to be used with Windows Forms. Wklej kod do formularza i Wywołaj ShowLineJoin metodę podczas obsługi Paint zdarzenia formularza, przekazując e jako PaintEventArgs .Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as 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

PenRysuje wiersz o określonej szerokości i stylu.A Pen draws a line of specified width and style. Użyj DashStyle właściwości, aby narysować kilka odmian linii kreskowanych.Use the DashStyle property to draw several varieties of dashed lines. Linia rysowane przez a Pen może być wypełniane różnymi stylami wypełnienia, w tym pełnymi kolorami i teksturami.The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. Styl wypełnienia zależy od pędzla lub tekstury, która jest używana jako obiekt wypełnienia.The fill style depends on brush or texture that is used as the fill object.

Konstruktory

Pen(Brush)

Inicjuje nowe wystąpienie Pen klasy z określonym Brush .Initializes a new instance of the Pen class with the specified Brush.

Pen(Brush, Single)

Inicjuje nowe wystąpienie Pen klasy z określonym Brush i Width .Initializes a new instance of the Pen class with the specified Brush and Width.

Pen(Color)

Inicjuje nowe wystąpienie Pen klasy z określonym kolorem.Initializes a new instance of the Pen class with the specified color.

Pen(Color, Single)

Inicjuje nowe wystąpienie Pen klasy z określoną Color Width właściwością i.Initializes a new instance of the Pen class with the specified Color and Width properties.

Właściwości

Alignment

Pobiera lub Ustawia wyrównanie dla tego elementu Pen .Gets or sets the alignment for this Pen.

Brush

Pobiera lub ustawia wartość określającą Brush atrybuty tego elementu Pen .Gets or sets the Brush that determines attributes of this Pen.

Color

Pobiera lub ustawia kolor tego elementu Pen .Gets or sets the color of this Pen.

CompoundArray

Pobiera lub ustawia tablicę wartości określającą pióro złożone.Gets or sets an array of values that specifies a compound pen. Pióro złożone rysuje złożony wiersz składający się z równoległych wierszy i miejsc.A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap

Pobiera lub ustawia niestandardowy limit do użycia na końcu wierszy rysowanych za pomocą tego elementu Pen .Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap

Pobiera lub ustawia niestandardowy limit, który ma być używany na początku wierszy rysowanych za pomocą tego elementu Pen .Gets or sets a custom cap to use at the beginning of lines drawn with this Pen.

DashCap

Pobiera lub ustawia styl zakończenia używany na końcu kresek, które tworzą kreskowane linie Pen .Gets or sets the cap style used at the end of the dashes that make up dashed lines drawn with this Pen.

DashOffset

Pobiera lub ustawia odległość od początku linii do początku wzorca kreskowego.Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern

Pobiera lub ustawia tablicę niestandardowych kresek i spacji.Gets or sets an array of custom dashes and spaces.

DashStyle

Pobiera lub ustawia styl używany dla linii kreskowanych rysowanych za pomocą tego elementu Pen .Gets or sets the style used for dashed lines drawn with this Pen.

EndCap

Pobiera lub ustawia styl zakończenia używany na końcu linii rysowanych za pomocą tego elementu Pen .Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin

Pobiera lub ustawia styl sprzężenia dla zakończenia dwóch kolejnych linii rysowanych za pomocą tego elementu Pen .Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit

Pobiera lub ustawia limit grubości przyłączenia w rogu mitered.Gets or sets the limit of the thickness of the join on a mitered corner.

PenType

Pobiera styl linii rysowanych za pomocą tego elementu Pen .Gets the style of lines drawn with this Pen.

StartCap

Pobiera lub ustawia styl zakończenia używany na początku linii rysowanych za pomocą tego elementu Pen .Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform

Pobiera lub ustawia kopię transformacji geometrycznej dla tego elementu Pen .Gets or sets a copy of the geometric transformation for this Pen.

Width

Pobiera lub ustawia szerokość tego elementu Pen w jednostkach Graphics obiektu używanego do rysowania.Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

Metody

Clone()

Tworzy dokładną kopię tego elementu Pen .Creates an exact copy of this Pen.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszystkie zasoby używane przez ten program Pen .Releases all resources used by this Pen.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Finalize()

Umożliwia obiektowi podjęcie próby zwolnienia zasobów i wykonywanie innych operacji czyszczenia przed odinstalowaniem ich przez wyrzucanie elementów bezużytecznych.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
MultiplyTransform(Matrix)

Mnoży macierz transformacji przez Pen określony Matrix .Multiplies the transformation matrix for this Pen by the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder)

Mnoży tablicę transformacji dla tego Pen przez określony Matrix w określonej kolejności.Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

ResetTransform()

Resetuje macierz transformacji geometrycznej dla tej Pen tożsamości.Resets the geometric transformation matrix for this Pen to identity.

RotateTransform(Single)

Obraca lokalną transformację geometryczną o określony kąt.Rotates the local geometric transformation by the specified angle. Ta metoda dołącza obrót do transformacji.This method prepends the rotation to the transformation.

RotateTransform(Single, MatrixOrder)

Obraca lokalną transformację geometryczną o określony kąt w określonej kolejności.Rotates the local geometric transformation by the specified angle in the specified order.

ScaleTransform(Single, Single)

Skaluje lokalną transformację geometryczną o określonych czynnikach.Scales the local geometric transformation by the specified factors. Ta metoda dołącza macierz skalowania do transformacji.This method prepends the scaling matrix to the transformation.

ScaleTransform(Single, Single, MatrixOrder)

Skaluje lokalną transformację geometryczną o określonych czynnikach w określonej kolejności.Scales the local geometric transformation by the specified factors in the specified order.

SetLineCap(LineCap, LineCap, DashCap)

Ustawia wartości określające styl zakończenia, który ma zostać użyty do zakończenia linii rysowanych przez ten ciąg Pen .Sets the values that determine the style of cap used to end lines drawn by this Pen.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TranslateTransform(Single, Single)

Tłumaczy lokalną transformację geometryczną o określone wymiary.Translates the local geometric transformation by the specified dimensions. Ta metoda dołącza tłumaczenie do transformacji.This method prepends the translation to the transformation.

TranslateTransform(Single, Single, MatrixOrder)

Tłumaczy lokalną transformację geometryczną o określone wymiary w określonej kolejności.Translates the local geometric transformation by the specified dimensions in the specified order.

Dotyczy