Pen Classe

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Source:

Pen.cs

Définit un objet utilisé pour dessiner des lignes et des courbes. Cette classe ne peut pas être héritée.

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

Héritage

Object

MarshalByRefObject

Pen

Implémente

ICloneable IDisposable

Exemples

L’exemple de code suivant illustre la construction d’un Pen avec un Brush et les effets de la définition de la LineJoin propriété sur un Pen.

Cet exemple est conçu pour être utilisé avec Windows Forms. Collez le code dans un formulaire et appelez la méthode lors de la ShowLineJoin gestion de l’événement du Paint formulaire, en passant e en tant que 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

Remarques

Un Pen dessine une ligne de largeur et de style spécifiés. Utilisez la DashStyle propriété pour dessiner plusieurs variétés de lignes en pointillés. La ligne dessinée par un Pen peut être remplie dans une variété de styles de remplissage, y compris des couleurs et des textures unie. Le style de remplissage dépend du pinceau ou de la texture utilisé comme objet de remplissage.

Note

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, n’est pris en charge que sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes provoque des avertissements au moment de la compilation et des exceptions d’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Constructeurs

Nom	Description
Pen(Brush, Single)	Initialise une nouvelle instance de la Pen classe avec les données spécifiées Brush et Width.
Pen(Brush)	Initialise une nouvelle instance de la Pen classe avec le fichier spécifié Brush.
Pen(Color, Single)	Initialise une nouvelle instance de la Pen classe avec les propriétés et Width les propriétés spécifiéesColor.
Pen(Color)	Initialise une nouvelle instance de la Pen classe avec la couleur spécifiée.

Propriétés

Nom	Description
Alignment	Obtient ou définit l’alignement pour ce Pen.
Brush	Obtient ou définit l’attribut Brush qui détermine les attributs de ce Pen.
Color	Obtient ou définit la couleur de ce Pen.
CompoundArray	Obtient ou définit un tableau de valeurs qui spécifie un stylet composé. Un stylet composé dessine une ligne composée composée de lignes et d’espaces parallèles.
CustomEndCap	Obtient ou définit une limite personnalisée à utiliser à la fin des lignes dessinées avec ce Pen.
CustomStartCap	Obtient ou définit une limite personnalisée à utiliser au début des lignes dessinées avec ce Pen.
DashCap	Obtient ou définit le style de limite utilisé à la fin des tirets qui composent des traits pointillés dessinés avec ce Pen.
DashOffset	Obtient ou définit la distance entre le début d’une ligne et le début d’un motif de tiret.
DashPattern	Obtient ou définit un tableau de tirets et d’espaces personnalisés.
DashStyle	Obtient ou définit le style utilisé pour les lignes en pointillés dessinées avec ce Pen.
EndCap	Obtient ou définit le style de limite utilisé à la fin des lignes dessinées avec ce Pen.
LineJoin	Obtient ou définit le style de jointure pour les extrémités de deux lignes consécutives dessinées avec ce Pen.
MiterLimit	Obtient ou définit la limite de l’épaisseur de la jointure sur un coin mitré.
PenType	Obtient le style des lignes dessinées avec ce Pen.
StartCap	Obtient ou définit le style de limite utilisé au début des lignes dessinées avec ce Pen.
Transform	Obtient ou définit une copie de la transformation géométrique pour ce Pen.
Width	Obtient ou définit la largeur de cet Penobjet, en unités de l’objet Graphics utilisé pour le dessin.

Méthodes

Nom	Description
Clone()	Crée une copie exacte de ce Pen.
Dispose()	Libère toutes les ressources utilisées par ce Penfichier .
Finalize()	Permet à un objet d’essayer de libérer des ressources et d’effectuer d’autres opérations de nettoyage avant qu’il ne soit récupéré par garbage collection.
MultiplyTransform(Matrix, MatrixOrder)	Multiplie la matrice de transformation pour cela Pen par l’ordre spécifié Matrix .
MultiplyTransform(Matrix)	Multiplie la matrice de transformation pour cela Pen par le paramètre spécifié Matrix.
ResetTransform()	Réinitialise la matrice de transformation géométrique pour cette Pen identité.
RotateTransform(Single, MatrixOrder)	Fait pivoter la transformation géométrique locale par l’angle spécifié dans l’ordre spécifié.
RotateTransform(Single)	Fait pivoter la transformation géométrique locale par l’angle spécifié. Cette méthode précède la rotation vers la transformation.
ScaleTransform(Single, Single, MatrixOrder)	Met à l’échelle la transformation géométrique locale par les facteurs spécifiés dans l’ordre spécifié.
ScaleTransform(Single, Single)	Met à l’échelle la transformation géométrique locale par les facteurs spécifiés. Cette méthode précède la matrice de mise à l’échelle de la transformation.
SetLineCap(LineCap, LineCap, DashCap)	Définit les valeurs qui déterminent le style de limite utilisé pour mettre fin aux lignes dessinées par ce Pen.
TranslateTransform(Single, Single, MatrixOrder)	Traduit la transformation géométrique locale par les dimensions spécifiées dans l’ordre spécifié.
TranslateTransform(Single, Single)	Traduit la transformation géométrique locale par les dimensions spécifiées. Cette méthode précède la traduction vers la transformation.