PictureBox.SizeMode 속성

정의

이미지가 표시되는 방식을 나타냅니다.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 Form에 다음 코드를 붙여 넣습니다는 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. 사용 하는 StretchImage 값을 사용 하면 이미지에 맞게 늘이거나를 PictureBox합니다.Using the StretchImage value causes the image to stretch or shrink to fit the PictureBox. 사용 하는 Zoom 값을 늘리거나에 맞게 축소 이미지를 사용 하면는 PictureBox하지만 원래에서 가로 세로 비율이 유지 됩니다.Using 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.

적용 대상

추가 정보