Pen Classe

Définition

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
Implémente

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 comme 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 traits 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 unie et des textures. Le style de remplissage dépend du pinceau ou de la texture utilisé comme objet de remplissage.

Notes

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

Constructeurs

Pen(Brush)

Initialise une nouvelle instance de la classe Pen avec le Brush spécifié.

Pen(Brush, Single)

Initialise une nouvelle instance de la classe Pen avec les Brush et Width spécifiés.

Pen(Color)

Initialise une nouvelle instance de la classe Pen avec la couleur spécifiée.

Pen(Color, Single)

Initialise une nouvelle instance de la classe Pen avec les propriétés Color et Width spécifiées.

Propriétés

Alignment

Obtient ou définit l'alignement pour ce Pen.

Brush

Obtient ou définit le 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 constituée de lignes parallèles et d'espaces.

CustomEndCap

Obtient ou définit une extrémité personnalisée à utiliser à la fin des lignes dessinées avec ce Pen.

CustomStartCap

Obtient ou définit une extrémité personnalisée à utiliser au début des lignes dessinées à l'aide de ce Pen.

DashCap

Obtient ou définit le style d'extrémité utilisé à la fin des tirets qui constituent les lignes en pointillés dessinées à l'aide de ce Pen.

DashOffset

Obtient ou définit la distance entre le début d’une ligne et le début d’un modèle de tiret.

DashPattern

Obtient ou définit un tableau d'espaces et de tirets 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 d'extrémité utilisé à la fin des lignes dessinées avec ce Pen.

LineJoin

Obtient ou définit le style de jointure utilisé à la fin de deux lignes consécutives dessinées avec ce Pen.

MiterLimit

Obtient ou définit la limite d'épaisseur de la jointure sur un coin à onglet.

PenType

Obtient le style des lignes dessinées avec ce Pen.

StartCap

Obtient ou définit le style d'extrémité 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 ce Pen, en unités de l'objet Graphics utilisé pour dessiner.

Méthodes

Clone()

Crée une copie exacte de Pen.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par ce Pen.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Finalize()

Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
MultiplyTransform(Matrix)

Multiplie la matrice de transformation de ce Pen par le Matrix spécifié.

MultiplyTransform(Matrix, MatrixOrder)

Multiplie la matrice de transformation de ce Pen par le Matrix spécifié dans l'ordre spécifié.

ResetTransform()

Rétablit l'identité de la matrice de transformation géométrique de ce Pen.

RotateTransform(Single)

Fait pivoter la transformation géométrique locale selon l'angle spécifié. Cette méthode ajoute la rotation avant la transformation.

RotateTransform(Single, MatrixOrder)

Fait pivoter la transformation géométrique locale selon l'angle et dans l'ordre spécifiés.

ScaleTransform(Single, Single)

Ajuste la transformation géométrique locale selon les facteurs spécifiés. Cette méthode ajoute la matrice de mise à l'échelle avant la transformation.

ScaleTransform(Single, Single, MatrixOrder)

Ajuste la transformation géométrique locale selon les facteurs et dans l'ordre spécifiés.

SetLineCap(LineCap, LineCap, DashCap)

Définit les valeurs qui déterminent le style d'extrémité utilisé à la fin des lignes dessinées par ce Pen.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TranslateTransform(Single, Single)

Effectue une translation de la transformation géométrique locale selon les dimensions spécifiées. Cette méthode ajoute la translation avant la transformation.

TranslateTransform(Single, Single, MatrixOrder)

Effectue une translation de la transformation géométrique locale selon les dimensions spécifiées dans l'ordre indiqué.

S’applique à