Gets or sets the width of the control.

[Visual Basic]
Public Property Width As Integer
[C#]
public int Width {get; set;}
[C++]
public: __property int get_Width();
public: __property void set_Width(int);
[JScript]
public function get Width() : int;
public function set Width(int);

Property Value

The width of the control in pixels.

Remarks

Changes made to the Width and Left property values cause the Right property value of the control to change.

Example

[Visual Basic, C#, C++] The following example creates three Button controls on a form and sets their size and location by using the various size-related and location-related properties. This example assumes you have a Form that has a width and height of at least 300 pixels.

[Visual Basic] 
' 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

[C#] 
// 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} );
}

[C++] 
// 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 = new 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 = S"&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 = S"&Cancel";
   this->CancelButton = buttonCancel;

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

   // Add the buttons to the form.

   Control* temp1 [] = {buttonOK, buttonCancel, buttonHelp};
   this->Controls->AddRange(temp1);
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Control Class | Control Members | System.Windows.Forms Namespace | Bounds | Height | Size.Width | SetBounds