Control.Size Eigenschaft

Definition

Ruft die Höhe und Breite des Steuerelements ab oder legt diese fest.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

Eigenschaftswert

Die Size, die die Höhe und Breite des Steuerelements in Pixel darstellt.The Size that represents the height and width of the control in pixels.

Beispiele

Im folgenden Codebeispiel wird ein Button zu einem Formular hinzugefügt, und einige der allgemeinen Eigenschaften werden festgelegt.The following code example adds a Button to a form and sets some of its common properties. Im Beispiel wird die Schaltfläche in der unteren rechten Ecke des Formulars verankert, sodass die relative Position bei der Größenänderung des Formulars beibehalten wird.The example anchors the button to the bottom-right corner of the form so it keeps its relative position as the form is resized. Anschließend wird die BackgroundImage festgelegt und die Größe der Schaltfläche auf die gleiche Größe wie die Image festgelegt.Next it sets the BackgroundImage and resizes the button to the same size as the Image. Im Beispiel wird dann der TabStop auf true festgelegt, und die Eigenschaft TabIndex wird festgelegt.The example then sets the TabStop to true and sets the TabIndex property. Schließlich fügt Sie einen Ereignishandler hinzu, der das Click-Ereignis der Schaltfläche behandelt.Lastly, it adds an event handler to handle the Click event of the button. Für dieses Beispiel ist es erforderlich, dass Sie über eine ImageList mit dem Namen imageList1 verfügen.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

Hinweise

Da die Size-Klasse ein Werttyp ist (Structure in Visual Basic, struct C#in Visual), wird Sie als Wert zurückgegeben, was bedeutet, dass der Zugriff auf die-Eigenschaft eine Kopie der Größe des Steuer Elements zurückgibt.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. Das Anpassen der Eigenschaften "Width" oder "Height" der von dieser Eigenschaft zurückgegebenen Size wirkt sich nicht auf das Width oder Height des Steuer Elements aus.So, adjusting the Width or Height properties of the Size returned from this property will not affect the Width or Height of the control. Um die Width oder Height des Steuer Elements anzupassen, müssen Sie die Width-oder Height-Eigenschaft des Steuer Elements festlegen oder die Size-Eigenschaft mit einer neuen Size festlegen.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.

Hinweis

Um eine bessere Leistung zu gewährleisten, legen Sie die Size eines Steuer Elements nicht im Konstruktor fest.To maintain better performance, do not set the Size of a control in its constructor. Die bevorzugte Methode besteht darin, die DefaultSize-Eigenschaft zu überschreiben.The preferred method is to override the DefaultSize property.

Hinweis

Auf Windows Server 2003-Systemen wird die Größe eines Form durch die maximale Pixel Breite und Höhe des Monitors eingeschränkt.On Windows Server 2003 systems, the size of a Form is restricted by the maximum pixel width and height of the monitor.

Gilt für:

Siehe auch