Control.Region Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Control.cs

Obtient ou définit la zone de la fenêtre associée au contrôle.

C#

[System.ComponentModel.Browsable(false)]
public System.Drawing.Region? Region { get; set; }

Valeur de propriété

Region

Region de la fenêtre associé au contrôle.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant montre comment utiliser la Region propriété en créant un bouton rond. Pour exécuter l’exemple, collez le code suivant dans un formulaire contenant un bouton appelé roundButton. Cet exemple nécessite que l’événement Paint soit connecté au gestionnaire d’événements défini dans l’exemple.

C#

// This method will change the square button to a circular button by 
// creating a new circle-shaped GraphicsPath object and setting it 
// to the RoundButton objects region.
private void roundButton_Paint(object sender, 
    System.Windows.Forms.PaintEventArgs e)
{

    System.Drawing.Drawing2D.GraphicsPath buttonPath = 
        new System.Drawing.Drawing2D.GraphicsPath();

    // Set a new rectangle to the same size as the button's 
    // ClientRectangle property.
    System.Drawing.Rectangle newRectangle = roundButton.ClientRectangle;

    // Decrease the size of the rectangle.
    newRectangle.Inflate(-10, -10);
    
    // Draw the button's border.
    e.Graphics.DrawEllipse(System.Drawing.Pens.Black, newRectangle);

    // Increase the size of the rectangle to include the border.
    newRectangle.Inflate( 1,  1);

    // Create a circle within the new rectangle.
    buttonPath.AddEllipse(newRectangle);
            
    // Set the button's Region property to the newly created 
    // circle region.
    roundButton.Region = new System.Drawing.Region(buttonPath);
}

Remarques

La zone de fenêtre est une collection de pixels dans la fenêtre où le système d’exploitation autorise le dessin. Le système d’exploitation n’affiche aucune partie d’une fenêtre située en dehors de la région de la fenêtre. Les coordonnées de la région d’un contrôle sont relatives à l’angle supérieur gauche du contrôle, et non à la zone cliente du contrôle.

Note

La collection de pixels contenue dans la région peut être non incohérente.

S’applique à

Voir aussi

• ClientRectangle
• Bounds