Control.Top Control.Top Control.Top Control.Top Property

Definición

Obtiene o establece la distancia, en píxeles, que existe entre el borde superior del control y el borde superior del área cliente de su contenedor.Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.

public:
 property int Top { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public int Top { get; set; }
member this.Top : int with get, set
Public Property Top As Integer

Valor de propiedad

Int32 que representa la distancia, en píxeles, que existe entre el borde inferior del control y el borde superior del área cliente de su contenedor.An Int32 representing the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.

Ejemplos

En el ejemplo de código siguiente Button se crean tres controles en un formulario y se establece su tamaño y ubicación mediante el uso de las distintas propiedades relacionadas con el tamaño y la ubicación.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. Este ejemplo requiere que tenga Form un que tenga un ancho y un alto de al menos 300 píxeles.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 );
}
// 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. 
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

Comentarios

El Top valor de propiedad es equivalente a Point.Y la propiedad del Location valor de propiedad del control.The Top property value is equivalent to the Point.Y property of the Location property value of the control.

Los cambios realizados en Height los Top valores de las propiedades Bottom y hacen que el valor de la propiedad del control cambie.Changes made to the Height and Top property values cause the Bottom property value of the control to change.

Se aplica a

Consulte también: