Control.Top プロパティ

コントロールの下端とコンテナのクライアント領域の上端の間の距離をピクセルで取得または設定します。

Public Property Top As Integer
[C#]
public int Top {get; set;}
[C++]
public: __property int get_Top();public: __property void set_Top(int);
[JScript]
public function get Top() : int;public function set Top(int);

プロパティ値

Int32 は、コントロールの下端とコンテナのクライアント領域の上端の間の距離をピクセルで示します。

解説

Top プロパティ値は、コントロールの Location プロパティ値の Point.Y プロパティと同じです。

Height プロパティおよび Top プロパティの値を変更すると、コントロールの Bottom プロパティの値が変更されます。

使用例

[Visual Basic, C#, C++] フォームに 3 つの Button コントロールを作成し、サイズ関連と位置関連の各種プロパティを使用してそのサイズと位置を設定する例を次に示します。この例は、幅と高さが 300 ピクセル以上ある Form があることを前提にしています。

 
' 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] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | Point.Y | Bottom | Bounds