PictureBox.SizeMode PictureBox.SizeMode PictureBox.SizeMode PictureBox.SizeMode Property

定義

イメージの表示方法を示します。Indicates how the image is displayed.

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

プロパティ値

PictureBoxSizeMode 値のいずれか。One of the PictureBoxSizeMode values. 既定値は、Normal です。The default is Normal.

例外

代入された値が、PictureBoxSizeMode 値ではありません。The value assigned is not one of the PictureBoxSizeMode values.

次のコード例は、 SizeModeプロパティの使用方法を示しています。The following code example demonstrates the use of the SizeMode property. この例を実行するには、次のコードを Windows フォームに貼りInitializePictureBoxAndButton付け、フォームのコンストラクターまたは読み込みイベント処理メソッドからメソッドを呼び出します。To run this example, paste the following code into a Windows Form and call the InitializePictureBoxAndButton method from the form's constructor or Load-event handling method.

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

注釈

このプロパティの有効な値は、 PictureBoxSizeMode列挙体から取得されます。Valid values for this property are taken from the PictureBoxSizeMode enumeration.

既定では、 NormalモードImageでは、はの左上隅PictureBoxに配置され、のサイズPictureBoxが大きすぎるイメージの一部はクリップされます。By default, in Normal mode, the Image is positioned in the upper-left corner of the PictureBox, and any part of the image that is too big for the PictureBox is clipped. 値を使用すると、 PictureBoxイメージはに合うように拡大または縮小されます。 StretchImageUsing the StretchImage value causes the image to stretch or shrink to fit the PictureBox. 値を使用すると、 PictureBoxイメージはに合うように拡大または縮小されますが、元の縦横比は維持されます。 ZoomUsing the Zoom value causes the image to be stretched or shrunk to fit the PictureBox; however, the aspect ratio in the original is maintained.

AutoSize値を使用すると、常にイメージに合わせてコントロールのサイズが変更されます。Using the AutoSize value causes the control to resize to always fit the image. CenterImage値を使用すると、イメージがクライアント領域の中央に配置されます。Using the CenterImage value causes the image to be centered in the client area.

適用対象

こちらもご覧ください