Pen Třída

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

Zdroj:

Pen.cs

Definuje objekt používaný k kreslení čar a křivek. Tato třída se nemůže dědit.

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

Dědičnost

Object

MarshalByRefObject

Pen

Implementuje

ICloneable IDisposable

Příklady

Následující příklad kódu ukazuje vytvoření objektu Pen s Brush a a účinky nastavení LineJoin vlastnosti na Pen.

Tento příklad je navržený pro použití s model Windows Forms. Vložte kód do formuláře a při zpracování události formuláře Paint volejte ShowLineJoin metodu, která se předává 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

Poznámky

Nakreslí Pen čáru se zadanou šířkou a stylem. DashStyle Pomocí vlastnosti nakreslete několik druhů přerušovaných čar. Čáru nakreslenou Pen čarou lze vyplnit různými styly výplně, včetně plných barev a textur. Styl výplně závisí na štětci nebo texturě, která se používá jako objekt výplně.

Poznámka

V .NET 6 a novějších verzích je balíček System.Drawing.Common, který obsahuje tento typ, podporován pouze v operačních systémech Windows. Použití tohoto typu v multiplatformních aplikacích způsobuje upozornění při kompilaci a výjimky za běhu. Další informace najdete v tématu System.Drawing.Common podporované pouze ve Windows.

Konstruktory

Pen(Brush)	Inicializuje novou instanci Pen třídy se zadaným Brushobjektem .
Pen(Brush, Single)	Inicializuje novou instanci Pen třídy se zadanými Brush a Width.
Pen(Color)	Inicializuje novou instanci Pen třídy se zadanou barvou.
Pen(Color, Single)	Inicializuje novou instanci Pen třídy se zadanými Color vlastnostmi a Width .

Vlastnosti

Alignment	Získá nebo nastaví zarovnání pro tento Pen.
Brush	Získá nebo nastaví, Brush který určuje atributy tohoto Pen.
Color	Získá nebo nastaví barvu tohoto Pensouboru .
CompoundArray	Získá nebo nastaví pole hodnot, které určuje složené pero. Složené pero nakreslí složenou čáru složenou z rovnoběžných čar a mezer.
CustomEndCap	Získá nebo nastaví vlastní limit pro použití na konci čar nakreslených pomocí tohoto Pen.
CustomStartCap	Získá nebo nastaví vlastní limit pro použití na začátku čar nakreslených pomocí tohoto Pen.
DashCap	Získá nebo nastaví styl cap použité na konci pomlček, které tvoří přerušované čáry nakreslené pomocí tohoto Pen.
DashOffset	Získá nebo nastaví vzdálenost od začátku čáry k začátku pomlčky vzoru.
DashPattern	Získá nebo nastaví pole vlastních pomlček a mezer.
DashStyle	Získá nebo nastaví styl použitý pro přerušované čáry nakreslené pomocí tohoto Pen.
EndCap	Získá nebo nastaví styl cap použité na konci čar nakreslených pomocí tohoto Pen.
LineJoin	Získá nebo nastaví styl spojení pro konce dvou po sobě jdoucích čar nakreslených pomocí tohoto Pen.
MiterLimit	Získá nebo nastaví limit tloušťky spojení na pokoseném rohu.
PenType	Získá styl čar nakreslených pomocí tohoto Pen.
StartCap	Získá nebo nastaví styl cap použité na začátku čar nakreslených pomocí tohoto Pen.
Transform	Získá nebo nastaví kopii geometrické transformace pro tento Pen.
Width	Získá nebo nastaví šířku tohoto Penobjektu v jednotkách objektu použitého Graphics pro kreslení.

Metody

Clone()	Vytvoří přesnou kopii tohoto Penobjektu .
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané tímto Pennástrojem .
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Finalize()	Umožňuje objektu pokusit se uvolnit prostředky a provést další operace čištění před jeho uvolněním uvolňováním.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
MultiplyTransform(Matrix)	Vynásobí transformační matici zadanou PenMatrixhodnotou .
MultiplyTransform(Matrix, MatrixOrder)	Vynásobí transformační matici Pen zadanou Matrix v zadaném pořadí.
ResetTransform()	Obnoví matici geometrické transformace na Pen identitu.
RotateTransform(Single)	Otočí místní geometrické transformace o zadaný úhel. Tato metoda předečí otočení na transformaci.
RotateTransform(Single, MatrixOrder)	Otočí místní geometrické transformace o zadaný úhel v zadaném pořadí.
ScaleTransform(Single, Single)	Škáluje místní geometrické transformace podle zadaných faktorů. Tato metoda předpenuje matici škálování na transformaci.
ScaleTransform(Single, Single, MatrixOrder)	Škáluje místní geometrické transformace podle zadaných faktorů v zadaném pořadí.
SetLineCap(LineCap, LineCap, DashCap)	Nastaví hodnoty, které určují styl capu použitého k ukončení čar nakreslených tímto Penznakem .
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TranslateTransform(Single, Single)	Přeloží místní geometrické transformace podle zadaných dimenzí. Tato metoda předehodí překlad do transformace.
TranslateTransform(Single, Single, MatrixOrder)	Přeloží místní geometrické transformace podle zadaných dimenzí v zadaném pořadí.