PictureBox.SizeMode Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

PictureBox.cs

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 PictureBoxSizeMode valeurs. La valeur par défaut est Normal.

Exceptions

InvalidEnumArgumentException

La valeur affectée n’est pas l’une PictureBoxSizeMode des valeurs.

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 méthode à partir de la InitializePictureBoxAndButton méthode de gestion des événements du formulaire ou du constructeur du formulaire.

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, il Image est positionné dans le coin supérieur gauche du , et toute partie de PictureBoxl’image trop volumineuse pour l’image PictureBox est clippée. L’utilisation de la StretchImage valeur entraîne l’étirement ou la réduction de l’image PictureBoxpour qu’elle corresponde. L’utilisation de la Zoom valeur entraîne l’étirement ou le rétrécissement PictureBoxde l’image ; toutefois, le rapport d’aspect dans l’original est conservé.

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

Voir aussi

• Image
• PictureBoxSizeMode