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ý ke 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 úč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 metodu ShowLineJoin , 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 operátorem Pen lze vyplnit v různých stylech výplně, včetně plných barev a textur. Styl výplně závisí na štětci nebo texturě, která se používá jako výplňový objekt.

Poznámka

V rozhraní .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í na 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 Brushparametrem .
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 Penobjekt .
Brush	Získá nebo nastaví , Brush který určuje atributy tohoto Penobjektu .
Color	Získá nebo nastaví barvu tohoto Penobjektu .
CompoundArray	Získá nebo nastaví pole hodnot, které určuje složené pero. Složené pero nakreslí složenou čáru složenou z paralelních čar a mezer.
CustomEndCap	Získá nebo nastaví vlastní limit pro použití na konci čar nakreslených tímto Pen.
CustomStartCap	Získá nebo nastaví vlastní cap pro použití na začátku čar nakreslených tímto Pen.
DashCap	Získá nebo nastaví styl zakončení použitý na konci pomlček, které tvoří přerušované čáry nakreslené tímto 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é tímto Pen.
EndCap	Získá nebo nastaví styl zakončení použitý na konci čar nakreslených tímto Pen.
LineJoin	Získá nebo nastaví styl spojení pro konce dvou po sobě jdoucích čar nakreslených tímto Pen.
MiterLimit	Získá nebo nastaví limit tloušťky spojení na pomitovaný roh.
PenType	Získá styl čar nakreslených tímto Pen.
StartCap	Získá nebo nastaví styl zakončení použitý na začátku čar nakreslených tímto Penobjektem .
Transform	Získá nebo nastaví kopii geometrické transformace pro tento Penobjekt .
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 sloužící 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ředtím, než je uvolněna uvolňováním paměti.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Získá životnost objektu služby, 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 určenou PenMatrixhodnotou .
MultiplyTransform(Matrix, MatrixOrder)	Vynásobí transformační matici zadanou PenMatrix v zadaném pořadí.
ResetTransform()	Obnoví identitu matice geometrické transformace.Pen
RotateTransform(Single)	Otočí místní geometrické transformace o zadaný úhel. Tato metoda předpendí obměně transformace.
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ředpřidá matici škálování k 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 zakončení čáry nakreslené 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ředpenduje překlad transformace.
TranslateTransform(Single, Single, MatrixOrder)	Přeloží místní geometrické transformace podle zadaných rozměrů v zadaném pořadí.