ControlLocationとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.Location プロパティ

コンテナの左上隅に対する相対座標として、コントロールの左上隅の座標を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Property Location As
 Point

Visual Basic (使用法)

Dim instance As Control
Dim value As Point

value = instance.Location

instance.Location = value

[LocalizableAttribute(true)] 
public Point Location { get; set;
 }

C++

[LocalizableAttribute(true)] 
public:
property Point Location {
    Point get ();
    void set (Point value);
}

/** @property */
public Point get_Location ()

/** @property */
public void set_Location (Point value)

JScript

public function get Location
 () : Point

public function set Location
 (value : Point)

プロパティ値
コントロールの左上隅をコンテナの左上隅に対して相対的に表す Point。

解説

Point クラスは値型 (Visual Basic では Structure、Visual C# では struct) であるため、値で返されます。つまり、このプロパティにアクセスすると、コントロールの左上隅のコピーが返されます。したがって、このプロパティから返された Point の X プロパティまたは Y プロパティを調整しても、コントロールの Left、Right、Top、または Bottom の各プロパティ値に影響はありません。これらのプロパティを調整するには、各プロパティ値を個別に設定するか、または新しい Point で Location プロパティを設定します。

Control が Form の場合、Location プロパティ値は Form の左上隅の画面座標を表します。

使用例

GroupBox を作成して、共通プロパティの一部を設定するコード例を次に示します。この例では、TextBox を作成し、グループボックス内での Location を設定しています。次に、グループボックスの Text プロパティを設定して、グループボックスをフォームの上部にドッキングします。最後に、Enabled プロパティを false に設定してグループを無効にします。これにより、グループボックスに含まれるすべてのコントロールが無効になります。

Visual Basic

' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New
 GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}

C++

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
    // Create a GroupBox and add a TextBox to it.
    GroupBox groupBox1 = new GroupBox();
    TextBox textBox1 = new TextBox();
    textBox1.set_Location(new Point(15, 15));
    groupBox1.get_Controls().Add(textBox1);
    // Set the Text and Dock properties of the GroupBox.
    groupBox1.set_Text("MyGroupBox");
    groupBox1.set_Dock(DockStyle.Top);
    // Disable the GroupBox (which disables all its child controls)
    groupBox1.set_Enabled(false);
    // Add the Groupbox to the form.
    this.get_Controls().Add(groupBox1);
} //AddMyGroupBox

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
Form
ContainerControl クラス
その他の技術情報
Windows フォームの座標

ControlLocation 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

コントロールを追加する、コンテナ内の位置を指定します。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Enumeration ControlLocation

Visual Basic (使用法)

Dim instance As ControlLocation

public enum ControlLocation

C++

public enum class ControlLocation

public enum ControlLocation

JScript

public enum ControlLocation

メンバ

	メンバ名	説明
	After	現在選択されているコントロール (つまり現在のコントロール) の後にコントロールを追加します。
	Before	現在選択されているコントロール (つまり現在のコントロール) の前にコントロールを追加します。
	First	ドキュメントの先頭にコントロールを追加します。
	FirstChild	選択されているコントロールがコンテナコントロールである場合、選択されているコントロールの最初の子としてコントロールを追加します。
	Last	ドキュメントの末尾にコントロールを追加します。
	LastChild	選択されているコントロールがコンテナコントロールである場合、選択されているコントロールの最後の子としてコントロールを追加します。