Control.Size 속성

정의

컨트롤의 높이와 너비를 가져오거나 설정합니다.Gets or sets the height and width of the control.

public:
 property System::Drawing::Size Size { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size Size { get; set; }
member this.Size : System.Drawing.Size with get, set
Public Property Size As Size

속성 값

컨트롤의 높이와 너비를 픽셀 단위로 나타내는 Size입니다.The Size that represents the height and width of the control in pixels.

예제

다음 코드 예제에서는 폼에 Button을 추가 하 고 일부 공용 속성을 설정 합니다.The following code example adds a Button to a form and sets some of its common properties. 이 예제에서는 폼 크기가 조정 될 때의 상대적 위치를 유지할 수 있도록 단추를 폼의 오른쪽 아래 모퉁이 고정 합니다.The example anchors the button to the bottom-right corner of the form so it keeps its relative position as the form is resized. 설정 옆의 BackgroundImage 단추와 같은 크기를 조정 하 고는 Image합니다.Next it sets the BackgroundImage and resizes the button to the same size as the Image. 설정한 후 합니다 TabStoptrue 설정 하 고는 TabIndex 속성.The example then sets the TabStop to true and sets the TabIndex property. 마지막으로 처리 하는 이벤트 처리기 추가 Click 단추의 이벤트입니다.Lastly, it adds an event handler to handle the Click event of the button. 이 예에서는 이름이 imageList1ImageList 있어야 합니다.This example requires that you have an ImageList named imageList1.

   // Add a button to a form and set some of its common properties.
private:
   void AddMyButton()
   {
      // Create a button and add it to the form.
      Button^ button1 = gcnew Button;

      // Anchor the button to the bottom right corner of the form
      button1->Anchor = static_cast<AnchorStyles>(AnchorStyles::Bottom | AnchorStyles::Right);

      // Assign a background image.
      button1->BackgroundImage = imageList1->Images[ 0 ];

      // Specify the layout style of the background image. Tile is the default.
      button1->BackgroundImageLayout = ImageLayout::Center;

      // Make the button the same size as the image.
      button1->Size = button1->BackgroundImage->Size;

      // Set the button's TabIndex and TabStop properties.
      button1->TabIndex = 1;
      button1->TabStop = true;

      // Add a delegate to handle the Click event.
      button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click );

      // Add the button to the form.
      this->Controls->Add( button1 );
   }
// Add a button to a form and set some of its common properties.
private void AddMyButton()
{
   // Create a button and add it to the form.
   Button button1 = new Button();

   // Anchor the button to the bottom right corner of the form
   button1.Anchor = (AnchorStyles.Bottom | AnchorStyles.Right);

   // Assign a background image.
   button1.BackgroundImage = imageList1.Images[0];

   // Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center;
   
   // Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size;

   // Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1;
   button1.TabStop = true;

   // Add a delegate to handle the Click event.
   button1.Click += new System.EventHandler(this.button1_Click);

   // Add the button to the form.
   this.Controls.Add(button1);
}
' Add a button to a form and set some of its common properties.
Private Sub AddMyButton()
   ' Create a button and add it to the form.
   Dim button1 As New Button()
   
   ' Anchor the button to the bottom right corner of the form
   button1.Anchor = AnchorStyles.Bottom Or AnchorStyles.Right
   
   ' Assign a background image.
   button1.BackgroundImage = imageList1.Images(0)

   ' Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center
   
   ' Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size
   
   ' Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1
   button1.TabStop = True

   ' Add a delegate to handle the Click event.
   AddHandler button1.Click, AddressOf Me.button1_Click
   
   ' Add the button to the form.
   Me.Controls.Add(button1)
End Sub

설명

Size 클래스는 값 형식 (시각적 개체 C#struct Visual BasicStructure) 이므로 값으로 반환 됩니다. 즉, 속성에 액세스 하면 컨트롤 크기의 복사본이 반환 됩니다.Because the Size class is a value type (Structure in Visual Basic, struct in Visual C#), it is returned by value, meaning accessing the property returns a copy of the size of the control. 따라서이 속성에서 반환 되는 SizeWidth 또는 Height 속성을 조정 해도 컨트롤의 Width 또는 Height에는 영향을 주지 않습니다.So, adjusting the Width or Height properties of the Size returned from this property will not affect the Width or Height of the control. 컨트롤의 Width 또는 Height를 조정 하려면 컨트롤의 Width 또는 Height 속성을 설정 하거나 새 Size를 사용 하 여 Size속성을 설정 해야 합니다.To adjust the Width or Height of the control, you must set the control's Width or Height property, or set the Size property with a new Size.

참고

성능을 향상 시키려면 해당 생성자에서 컨트롤의 Size 설정 하지 마십시오.To maintain better performance, do not set the Size of a control in its constructor. 기본 방법은 DefaultSize 속성을 재정의 하는 것입니다.The preferred method is to override the DefaultSize property.

참고

Windows Server 2003 시스템에서 Form 크기는 모니터의 최대 픽셀 너비와 높이에 의해 제한 됩니다.On Windows Server 2003 systems, the size of a Form is restricted by the maximum pixel width and height of the monitor.

적용 대상

추가 정보