Sdílet prostřednictvím


Pen Třída

Definice

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
Implementuje

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()
Zastaralé.

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()
Zastaralé.

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í.

Platí pro