Pen Konstruktory

Definicja

Przestrzeń nazw:

System.Drawing

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Inicjuje Pen nowe wystąpienie klasy o określonym kolorze.

Przeciążenia

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

Pen(Brush)

Źródło:

Pen.cs

Inicjuje Pen nowe wystąpienie klasy o określonej wartości Brush.

C#

public Pen (System.Drawing.Brush brush);

Parametry

brush

Brush

Element Brush określający właściwości wypełnienia tego Penelementu .

Wyjątki

ArgumentNullException

brush to null.

Przykłady

Poniższy przykład kodu przedstawia konstruowanie Pen elementu z elementem Brush i 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 jako PaintEventArgs.

C#

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();
}

Uwagi

Właściwość Brush określa sposób Pen rysowania linii. Linie są rysowane tak, jakby były wypełnione prostokątami, z cechami określonej wartości Brush.

Właściwość Width nowego Pen jest ustawiona na 1 (wartość domyślna).

Pen(Color)

Źródło:

Pen.cs

Inicjuje Pen nowe wystąpienie klasy o określonym kolorze.

C#

public Pen (System.Drawing.Color color);

Parametry

color

Color

Struktura Color wskazująca kolor tego Penelementu .

Uwagi

Właściwość Color jest ustawiona na kolor określony przez color parametr . Właściwość jest ustawiona Width na 1 (wartość domyślna).

Pen(Brush, Single)

Źródło:

Pen.cs

Inicjuje Pen nowe wystąpienie klasy o określonej wartości Brush i Width.

C#

public Pen (System.Drawing.Brush brush, float width);

Parametry

brush

Brush

Element Brush określający charakterystykę tego Penobiektu .

width

Single

Szerokość nowego Penelementu .

Wyjątki

ArgumentNullException

brush to null.

Przykłady

Poniższy przykład kodu tworzy element Pen i demonstruje efekty ustawiania StartCap właściwości i EndCap na obiekcie Pen.

Ten przykład jest przeznaczony do użycia z Windows Forms. Wklej kod do formularza i wywołaj ShowStartAndEndCaps metodę podczas obsługi zdarzenia formularza Paint , przekazując e jako PaintEventArgs.

C#

private void Button3_Click(System.Object sender, System.EventArgs e)
{

    Graphics buttonGraphics = Button3.CreateGraphics();
    Pen myPen = new Pen(Color.ForestGreen, 4.0F);
    myPen.DashStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot;

    Rectangle theRectangle = Button3.ClientRectangle;
    theRectangle.Inflate(-2, -2);
    buttonGraphics.DrawRectangle(myPen, theRectangle);
    buttonGraphics.Dispose();
    myPen.Dispose();
}

Uwagi

Parametr Brush jest ustawiony na kolor określony w parametrze brush , Width właściwość jest ustawiona na wartość określoną w parametrze width , a jednostki są ustawione na Worldwartość .

Należy pamiętać, że brush parametr określa Color również właściwość tego Penelementu .

Jeśli ta wartość wynosi 0, szerokość jednostek urządzenia jest zawsze 1 piksel — nie ma to wpływu na operacje przekształcania skali, które są stosowane dla obiektu Grafiki używanego Pen przez obiekt.

Pen(Color, Single)

Źródło:

Pen.cs

Inicjuje Pen nowe wystąpienie klasy z określonymi Color właściwościami i Width .

C#

public Pen (System.Drawing.Color color, float width);

Parametry

color

Color

Struktura Color wskazująca kolor tego Penelementu .

width

Single

Wartość wskazująca szerokość tego Penelementu .

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć Pen element i efekty ustawiania DashCapwłaściwości , DashPatterni SmoothingMode .

Ten przykład jest przeznaczony do użycia z Windows Forms. Wklej kod do formularza i wywołaj ShowPensAndSmoothingMode metodę podczas obsługi zdarzenia formularza Paint , przekazując wartość e jako PaintEventArgs.

C#

private void ShowPensAndSmoothingMode(PaintEventArgs e)
{

    // Set the SmoothingMode property to smooth the line.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.AntiAlias;

    // Create a new Pen object.
    Pen greenPen = new Pen(Color.Green);

    // Set the width to 6.
    greenPen.Width = 6.0F;

    // Set the DashCap to round.
    greenPen.DashCap = System.Drawing.Drawing2D.DashCap.Round;

    // Create a custom dash pattern.
    greenPen.DashPattern = new float[]{4.0F, 2.0F, 1.0F, 3.0F};

    // Draw a line.
    e.Graphics.DrawLine(greenPen, 20.0F, 20.0F, 100.0F, 240.0F);

    // Change the SmoothingMode to none.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.None;

    // Draw another line.
    e.Graphics.DrawLine(greenPen, 100.0F, 240.0F, 160.0F, 20.0F);

    // Dispose of the custom pen.
    greenPen.Dispose();
}

Uwagi

Właściwość Color jest ustawiona na kolor określony przez color parametr . Właściwość Width jest ustawiona na wartość określoną w parametrze width . Jeśli ta wartość wynosi 0, szerokość jednostek urządzenia jest zawsze 1 piksel — nie ma to wpływu na operacje przekształcania skali, które są stosowane dla obiektu Grafiki używanego Pen przez obiekt.