Control::Height Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the height of the control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

property int Height {
	int get();
	void set(int value);

Property Value

Type: System::Int32

The height of the control in pixels.

Changes made to the Height and Top property values cause the Bottom property value of the control to change.


The minimum height for the derived control Splitter is one pixel. The default height for the Splitter control is three pixels. Setting the height of the Splitter control to a value less than one will reset the property value to the default height.

The following code 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 requires that you have a Form that has a width and height of at least 300 pixels.

// 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 );

.NET Framework
Available since 1.1
Return to top