Control::Height Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com 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)

public:
[BrowsableAttribute(false)]
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.

System_CAPS_noteNote

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
Show: