Pen Classe

Définition

Définit un objet utilisé pour dessiner des lignes et des courbes.Defines an object used to draw lines and curves. Cette classe ne peut pas être héritée.This class cannot be inherited.

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 propriété LineJoin sur un Pen.The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

Cet exemple est conçu pour être utilisé avec Windows Forms.This example is designed to be used with Windows Forms. Collez le code dans un formulaire et appelez la méthode ShowLineJoin lors du traitement de l’événement Paint du formulaire, en passant e en tant que PaintEventArgs.Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as 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

Une Pen dessine une ligne de la largeur et du style spécifiés.A Pen draws a line of specified width and style. Utilisez la propriété DashStyle pour dessiner plusieurs variétés de lignes en pointillés.Use the DashStyle property to draw several varieties of dashed lines. La ligne dessinée par un Pen peut être remplie dans divers styles de remplissage, y compris les couleurs unies et les textures.The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. Le style de remplissage dépend du pinceau ou de la texture qui est utilisé comme objet de remplissage.The fill style depends on brush or texture that is used as the fill object.

Constructeurs

Pen(Brush)

Initialise une nouvelle instance de la classe Pen avec le Brush spécifié.Initializes a new instance of the Pen class with the specified Brush.

Pen(Brush, Single)

Initialise une nouvelle instance de la classe Pen avec les Brush et Width spécifiés.Initializes a new instance of the Pen class with the specified Brush and Width.

Pen(Color)

Initialise une nouvelle instance de la classe Pen avec la couleur spécifiée.Initializes a new instance of the Pen class with the specified color.

Pen(Color, Single)

Initialise une nouvelle instance de la classe Pen avec les propriétés Color et Width spécifiées.Initializes a new instance of the Pen class with the specified Color and Width properties.

Propriétés

Alignment

Obtient ou définit l'alignement pour ce Pen.Gets or sets the alignment for this Pen.

Brush

Obtient ou définit l'objet Brush qui détermine les attributs de ce Pen.Gets or sets the Brush that determines attributes of this Pen.

Color

Obtient ou définit la couleur de ce Pen.Gets or sets the color of this Pen.

CompoundArray

Obtient ou définit un tableau de valeurs qui spécifie un stylet composé.Gets or sets an array of values that specifies a compound pen. Un stylet composé dessine une ligne composée constituée de lignes parallèles et d'espaces.A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap

Obtient ou définit une extrémité personnalisée à utiliser à la fin des lignes dessinées avec ce Pen.Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap

Obtient ou définit une extrémité personnalisée à utiliser au début des lignes dessinées avec ce Pen.Gets or sets a custom cap to use at the beginning of lines drawn with this 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 avec ce Pen.Gets or sets the cap style used at the end of the dashes that make up dashed lines drawn with this Pen.

DashOffset

Obtient ou définit la distance entre le début d'une ligne et le début d'un tiret.Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern

Obtient ou définit un tableau d'espaces et de tirets personnalisés.Gets or sets an array of custom dashes and spaces.

DashStyle

Obtient ou définit le style utilisé pour les lignes en pointillés dessinées à l'aide de ce Pen.Gets or sets the style used for dashed lines drawn with this Pen.

EndCap

Obtient ou définit le style d'extrémité utilisé à la fin des lignes dessinées avec ce Pen.Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin

Obtient ou définit le style de jointure pour la fin de deux lignes consécutives dessinées avec ce Pen.Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit

Obtient ou définit la limite d'épaisseur de la jointure sur un coin à onglet.Gets or sets the limit of the thickness of the join on a mitered corner.

PenType

Obtient le style des lignes dessinées à l'aide de ce Pen.Gets the style of lines drawn with this Pen.

StartCap

Obtient ou définit le style d'extrémité utilisé au début des lignes dessinées avec ce Pen.Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform

Obtient ou définit une copie de la transformation géométrique pour ce Pen.Gets or sets a copy of the geometric transformation for this Pen.

Width

Obtient ou définit la largeur de ce Pen, en unités de l'objet Graphics utilisé pour dessiner.Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

Méthodes

Clone()

Crée une copie exacte de Pen.Creates an exact copy of this 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par ce Pen.Releases all resources used by this Pen.

Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(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.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetLifetimeService()

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.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
InitializeLifetimeService()

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.Obtains a lifetime service object to control the lifetime policy for this instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

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

Crée une copie superficielle de l'objet MarshalByRefObject actuel.Creates a shallow copy of the current MarshalByRefObject object.

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

Multiplie la matrice de transformation pour ce Pen par le Matrix spécifié.Multiplies the transformation matrix for this Pen by the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder)

Multiplie la matrice de transformation pour ce Pen par le Matrix spécifié dans l'ordre spécifié.Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

ResetTransform()

Rétablit l'identité de la matrice de transformation géométrique de ce Pen .Resets the geometric transformation matrix for this Pen to identity.

RotateTransform(Single)

Fait pivoter la transformation géométrique locale selon l'angle spécifié.Rotates the local geometric transformation by the specified angle. Cette méthode ajoute la rotation avant la transformation.This method prepends the rotation to the transformation.

RotateTransform(Single, MatrixOrder)

Fait pivoter la transformation géométrique locale selon l'angle et l'ordre spécifiés.Rotates the local geometric transformation by the specified angle in the specified order.

ScaleTransform(Single, Single)

Ajuste la transformation géométrique locale selon les facteurs spécifiés.Scales the local geometric transformation by the specified factors. Cette méthode ajoute la matrice de mise à l'échelle avant la transformation.This method prepends the scaling matrix to the transformation.

ScaleTransform(Single, Single, MatrixOrder)

Ajuste la transformation géométrique locale selon les facteurs et l'ordre spécifiés.Scales the local geometric transformation by the specified factors in the specified order.

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.Sets the values that determine the style of cap used to end lines drawn by this Pen.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

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

Effectue la conversion de la transformation géométrique locale selon les dimensions spécifiées.Translates the local geometric transformation by the specified dimensions. Cette méthode ajoute la translation avant la transformation.This method prepends the translation to the transformation.

TranslateTransform(Single, Single, MatrixOrder)

Effectue la conversion de la transformation géométrique locale selon les dimensions spécifiées dans l'ordre donné.Translates the local geometric transformation by the specified dimensions in the specified order.

S’applique à