PictureBox.SizeMode Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Indique comment l'image est affichée.

public:
 property System::Windows::Forms::PictureBoxSizeMode SizeMode { System::Windows::Forms::PictureBoxSizeMode get(); void set(System::Windows::Forms::PictureBoxSizeMode value); };

public System.Windows.Forms.PictureBoxSizeMode SizeMode { get; set; }

member this.SizeMode : System.Windows.Forms.PictureBoxSizeMode with get, set

Public Property SizeMode As PictureBoxSizeMode

Valeur de propriété

PictureBoxSizeMode

Une des valeurs de l'objet PictureBoxSizeMode. La valeur par défaut est Normal.

Exceptions

InvalidEnumArgumentException

La valeur assignée ne fait pas partie des valeurs PictureBoxSizeMode.

Exemples

L’exemple de code suivant illustre l’utilisation de la SizeMode propriété . Pour exécuter cet exemple, collez le code suivant dans un Windows Form et appelez la InitializePictureBoxAndButton méthode à partir du constructeur du formulaire ou de la méthode de gestion des événements load.

PictureBox PictureBox1 = new PictureBox();
Button Button1 = new Button();

private void InitializePictureBoxAndButton()
{

    this.Controls.Add(PictureBox1);
    this.Controls.Add(Button1);
    Button1.Location = new Point(175, 20);
    Button1.Text = "Stretch";
    Button1.Click += new EventHandler(Button1_Click);

    // Set the size of the PictureBox control.
    this.PictureBox1.Size = new System.Drawing.Size(140, 140);

    //Set the SizeMode to center the image.
    this.PictureBox1.SizeMode = PictureBoxSizeMode.CenterImage;

    // Set the border style to a three-dimensional border.
    this.PictureBox1.BorderStyle = BorderStyle.Fixed3D;

    // Set the image property.
    this.PictureBox1.Image = new Bitmap(typeof(Button), "Button.bmp");
}

private void Button1_Click(System.Object sender, System.EventArgs e)
{
    // Set the SizeMode property to the StretchImage value.  This
    // will enlarge the image as needed to fit into
    // the PictureBox.
    PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
}

Dim PictureBox1 As New PictureBox()
Dim WithEvents Button1 As New Button

<STAThread()> _
Public Shared Sub Main()
    Application.EnableVisualStyles()
    Application.Run(New Form1())
End Sub

Private Sub InitializePictureBoxAndButton()

    Me.Controls.Add(PictureBox1)
    Me.Controls.Add(Button1)
    Button1.Location = New Point(175, 20)
    Button1.Text = "Stretch"

    ' Set the size of the PictureBox control.
    Me.PictureBox1.Size = New System.Drawing.Size(140, 140)

    'Set the SizeMode to center the image.
    Me.PictureBox1.SizeMode = PictureBoxSizeMode.CenterImage

    ' Set the border style to a three-dimensional border.
    Me.PictureBox1.BorderStyle = BorderStyle.Fixed3D

    ' Set the image property.
    Me.PictureBox1.Image = New Bitmap(GetType(Button), "Button.bmp")
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click
    ' Set the SizeMode property to the StretchImage value.  This
    ' will enlarge the image as needed to fit into
    ' the PictureBox.
    PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
End Sub

Remarques

Les valeurs valides pour cette propriété sont extraites de l’énumération PictureBoxSizeMode .

Par défaut, en Normal mode, le Image est positionné dans le coin supérieur gauche du PictureBox, et toute partie de l’image qui est trop grande pour le PictureBox est clippée. L’utilisation de la StretchImage valeur entraîne l’étirement ou la réduction de l’image pour s’adapter à .PictureBox L’utilisation de la Zoom valeur entraîne l’étirement ou le rétrécissement de l’image pour s’adapter PictureBoxau ; toutefois, les proportions dans l’original sont conservées.

L’utilisation de la AutoSize valeur entraîne le redimensionnement du contrôle pour toujours s’adapter à l’image. L’utilisation de la CenterImage valeur entraîne le centre de l’image dans la zone cliente.

Voir aussi

• Image
• PictureBoxSizeMode