Control.Width-Eigenschaft

Ruft die Breite des Steuerelements ab oder legt diese fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property Width As Integer
'Usage
Dim instance As Control
Dim value As Integer

value = instance.Width

instance.Width = value

public int Width { get; set; }

public:
property int Width {
    int get ();
    void set (int value);
}

/** @property */
public int get_Width ()

/** @property */
public void set_Width (int value)

public function get Width () : int

public function set Width (value : int)

Eigenschaftenwert

Die Breite des Steuerelements in Pixel.

Hinweise

Wenn Änderungen am Width-Eigenschaftenwert und am Left-Eigenschaftenwert vorgenommen wurden, wird die Änderung des Right-Eigenschaftenwerts des Steuerelements erzwungen.

Beispiel

Im folgenden Codebeispiel werden drei Button-Steuerelemente in einem Formular erstellt und mehrere entsprechende Eigenschaften zum Festlegen von Größe und Position verwendet. Bei diesem Beispiel muss ein Form mit einer Höhe und Breite von mindestens 300 Pixel vorhanden sein.

' Create three buttons and place them on a form using 
' several size and location related properties. 
Private Sub AddOKCancelButtons()
   ' Set the button size and location using 
      ' the Size and Location properties. 
   Dim buttonOK As New Button()
   buttonOK.Location = New Point(136, 248)
   buttonOK.Size = New Size(75, 25)
   ' Set the Text property and make the 
   ' button the form's default button. 
   buttonOK.Text = "&OK"
   Me.AcceptButton = buttonOK
   
   ' Set the button size and location using the Top, 
   ' Left, Width, and Height properties. 
   Dim buttonCancel As New Button()
   buttonCancel.Top = buttonOK.Top
   buttonCancel.Left = buttonOK.Right + 5
   buttonCancel.Width = buttonOK.Width
   buttonCancel.Height = buttonOK.Height
   ' Set the Text property and make the 
   ' button the form's cancel button. 
   buttonCancel.Text = "&Cancel"
   Me.CancelButton = buttonCancel
   
   ' Set the button size and location using 
   ' the Bounds property. 
   Dim buttonHelp As New Button()
   buttonHelp.Bounds = New Rectangle(10, 10, 75, 25)
   ' Set the Text property of the button.
   buttonHelp.Text = "&Help"
   
   ' Add the buttons to the form.
   Me.Controls.AddRange(New Control() {buttonOK, buttonCancel, buttonHelp})
End Sub

// Create three buttons and place them on a form using 
// several size and location related properties. 
private void AddOKCancelButtons()
{
   // Set the button size and location using 
   // the Size and Location properties.
   Button buttonOK = new Button();
   buttonOK.Location = new Point(136,248);
   buttonOK.Size = new Size(75,25);
   // Set the Text property and make the 
   // button the form's default button. 
   buttonOK.Text = "&OK";
   this.AcceptButton = buttonOK;

   // Set the button size and location using the Top, 
   // Left, Width, and Height properties.
   Button buttonCancel = new Button();
   buttonCancel.Top = buttonOK.Top;
   buttonCancel.Left = buttonOK.Right + 5;
   buttonCancel.Width = buttonOK.Width;
   buttonCancel.Height = buttonOK.Height;
   // Set the Text property and make the 
   // button the form's cancel button.
   buttonCancel.Text = "&Cancel";
   this.CancelButton = buttonCancel;

   // Set the button size and location using 
   // the Bounds property.
   Button buttonHelp = new Button();
   buttonHelp.Bounds = new Rectangle(10,10, 75, 25);
   // Set the Text property of the button.
   buttonHelp.Text = "&Help";

   // Add the buttons to the form.
   this.Controls.AddRange(new Control[] {buttonOK, buttonCancel, buttonHelp} );
}

// Create three buttons and place them on a form using
// several size and location related properties.
void AddOKCancelButtons()
{
   
   // Set the button size and location using
   // the Size and Location properties.
   Button^ buttonOK = gcnew Button;
   buttonOK->Location = Point(136,248);
   buttonOK->Size = System::Drawing::Size( 75, 25 );
   
   // Set the Text property and make the
   // button the form's default button.
   buttonOK->Text = "&OK";
   this->AcceptButton = buttonOK;
   
   // Set the button size and location using the Top,
   // Left, Width, and Height properties.
   Button^ buttonCancel = gcnew Button;
   buttonCancel->Top = buttonOK->Top;
   buttonCancel->Left = buttonOK->Right + 5;
   buttonCancel->Width = buttonOK->Width;
   buttonCancel->Height = buttonOK->Height;
   
   // Set the Text property and make the
   // button the form's cancel button.
   buttonCancel->Text = "&Cancel";
   this->CancelButton = buttonCancel;
   
   // Set the button size and location using
   // the Bounds property.
   Button^ buttonHelp = gcnew Button;
   buttonHelp->Bounds = Rectangle(10,10,75,25);
   
   // Set the Text property of the button.
   buttonHelp->Text = "&Help";
   
   // Add the buttons to the form.
   array<Control^>^temp1 = {buttonOK,buttonCancel,buttonHelp};
   this->Controls->AddRange( temp1 );
}

// Create three buttons and place them on a form using 
// several size and location related properties. 
private void AddOKCancelButtons()
{
    // Set the button size and location using 
    // the Size and Location properties.
    Button buttonOK = new Button();
    buttonOK.set_Location(new Point(136, 248));
    buttonOK.set_Size(new Size(75, 25));
    // Set the Text property and make the 
    // button the form's default button. 
    buttonOK.set_Text("&OK");
    this.set_AcceptButton(buttonOK);
    // Set the button size and location using the Top, 
    // Left, Width, and Height properties.
    Button buttonCancel = new Button();
    buttonCancel.set_Top(buttonOK.get_Top());
    buttonCancel.set_Left(buttonOK.get_Right() + 5);
    buttonCancel.set_Width(buttonOK.get_Width());
    buttonCancel.set_Height(buttonOK.get_Height());
    // Set the Text property and make the 
    // button the form's cancel button.
    buttonCancel.set_Text("&Cancel");
    this.set_CancelButton(buttonCancel);
    // Set the button size and location using 
    // the Bounds property.
    Button buttonHelp = new Button();
    buttonHelp.set_Bounds(new Rectangle(10, 10, 75, 25));
    // Set the Text property of the button.
    buttonHelp.set_Text("&Help");
    // Add the buttons to the form.
    this.get_Controls().AddRange(new Control[] { buttonOK, buttonCancel,
        buttonHelp });
} //AddOKCancelButtons

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Windows.Forms-Namespace
Control.Bounds-Eigenschaft
Control.Height-Eigenschaft
Size.Width
SetBounds