PictureBox.SizeMode Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Označuje způsob zobrazení obrázku.
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
Hodnota vlastnosti
Jedna z PictureBoxSizeMode hodnot. Výchozí formát je Normal.
Výjimky
Přiřazená hodnota není jednou z PictureBoxSizeMode hodnot.
Příklady
Následující příklad kódu ukazuje použití SizeMode vlastnosti. Pokud chcete tento příklad spustit, vložte do Windows Form následující kód a volejte metodu InitializePictureBoxAndButton
z konstruktoru formuláře nebo metody load-event handling.
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
Poznámky
Platné hodnoty pro tuto vlastnost jsou převzaty z výčtu PictureBoxSizeMode .
Ve výchozím nastavení Normal se v režimu Image umístí do levého horního PictureBoxrohu obrázku a jakákoli část obrázku, která je příliš velká pro vystřihování PictureBox . StretchImage Použití hodnoty způsobí, že se obrázek roztáhne nebo zmenšíPictureBox. Zoom Použití hodnoty způsobí, že se obrázek roztáhne nebo zvětší PictureBox, ale poměr stran v původním stavu se zachová.
AutoSize Použití hodnoty způsobí, že ovládací prvek změní velikost tak, aby se vždy přizpůsobil obrázku. CenterImage Použití hodnoty způsobí, že image bude na střed v klientské oblasti.