Control.Anchor プロパティ

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

Control.Anchor プロパティ

コントロールがバインドされるコンテナの端を取得または設定し、親のサイズ変更時に、コントロールのサイズがどのように変化するかを決定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overridable Property
 Anchor As AnchorStyles

Visual Basic (使用法)

Dim instance As Control
Dim value As AnchorStyles

value = instance.Anchor

instance.Anchor = value

C#

[LocalizableAttribute(true)] 
public virtual AnchorStyles Anchor { get; set;
 }

C++

[LocalizableAttribute(true)] 
public:
virtual property AnchorStyles Anchor {
    AnchorStyles get ();
    void set (AnchorStyles value);
}

J#

/** @property */
public AnchorStyles get_Anchor ()

/** @property */
public void set_Anchor (AnchorStyles value)

JScript

public function get Anchor
 () : AnchorStyles

public function set Anchor
 (value : AnchorStyles)

プロパティ値
AnchorStyles 値のビットごとの組み合わせ。既定値は Top および Left です。

解説

親コントロールのサイズ変更に合わせてコントロールのサイズを自動的に変更する方法を定義するには、Anchor プロパティを使用します。コントロールをその親コントロールに固定すると、親コントロールのサイズが変更されても、固定された端の位置を親コントロールの端に対して相対的に同じ位置に保つことができます。

コントロールは、コンテナの 1 つ以上の端に固定できます。たとえば、Anchor プロパティ値が Top および Bottom に設定された Button を持つ Form がある場合、Button は Form の Height が大きくなるにつれて拡大され、Form の上端と下端までの固定距離を維持します。

メモ
Anchor プロパティと Dock プロパティは同時には指定できません。いずれか一方のみを設定でき、一度に両方のプロパティを設定した場合は、最後に設定された方が優先されます。

継承時の注意 派生クラスで Anchor プロパティをオーバーライドする場合は、基本クラスの Anchor プロパティを使用して、基本の実装を拡張します。それ以外の場合は、すべての実装を提供する必要があります。Anchor プロパティの get アクセサと set アクセサの両方をオーバーライドする必要はありません。必要に応じて 1 つのアクセサだけをオーバーライドできます。

使用例

フォームに Button を追加し、共通プロパティの一部を設定するコード例を次に示します。この例では、ボタンをフォームの右下隅に固定することにより、フォームのサイズが変更されても、相対的な位置関係が維持されるようにしています。次に、BackgroundImage を設定して、ボタンを Image と同じサイズに変更します。この例では、TabStop を true に設定し、TabIndex プロパティを設定しています。最後に、ボタンの Click イベントを処理するイベント ハンドラを追加します。この例では、imageList1 という名前の ImageList が存在している必要があります。

Visual Basic

' Add a button to a form and set some of its common properties.
Private Sub AddMyButton()
   ' Create a button and add it to the form.
   Dim button1 As New Button()
   
   ' Anchor the button to the bottom right corner of the form
   button1.Anchor = AnchorStyles.Bottom Or AnchorStyles.Right
   
   ' Assign a background image.
   button1.BackgroundImage = imageList1.Images(0)

   ' Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center
   
   ' Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size
   
   ' Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1
   button1.TabStop = True

   ' Add a delegate to handle the Click event.
   AddHandler button1.Click, AddressOf Me.button1_Click
   
   ' Add the button to the form.
   Me.Controls.Add(button1)
End Sub

C#

// Add a button to a form and set some of its common properties.
private void AddMyButton()
{
   // Create a button and add it to the form.
   Button button1 = new Button();

   // Anchor the button to the bottom right corner of the form
   button1.Anchor = (AnchorStyles.Bottom | AnchorStyles.Right);

   // Assign a background image.
   button1.BackgroundImage = imageList1.Images[0];

   // Specify the layout style of the background image. Tile is the
 default.
   button1.BackgroundImageLayout = ImageLayout.Center;
   
   // Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size;

   // Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1;
   button1.TabStop = true;

   // Add a delegate to handle the Click event.
   button1.Click += new System.EventHandler(this.button1_Click);

   // Add the button to the form.
   this.Controls.Add(button1);
}

C++

   // Add a button to a form and set some of its common properties.
private:
   void AddMyButton()
   {
      // Create a button and add it to the form.
      Button^ button1 = gcnew Button;

      // Anchor the button to the bottom right corner of the form
      button1->Anchor = static_cast<AnchorStyles>(AnchorStyles::Bottom |
 AnchorStyles::Right);

      // Assign a background image.
      button1->BackgroundImage = imageList1->Images[ 0 ];

      // Specify the layout style of the background image. Tile is the
 default.
      button1->BackgroundImageLayout = ImageLayout::Center;

      // Make the button the same size as the image.
      button1->Size = button1->BackgroundImage->Size;

      // Set the button's TabIndex and TabStop properties.
      button1->TabIndex = 1;
      button1->TabStop = true;

      // Add a delegate to handle the Click event.
      button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click
 );

      // Add the button to the form.
      this->Controls->Add( button1 );
   }

J#

// Add a button to a form and set some of its common properties.
private void AddMyButton()
{
    // Create a button and add it to the form.
    Button button1 = new Button();
    // Anchor the button to the bottom right corner of the form
    button1.set_Anchor(AnchorStyles.Bottom | AnchorStyles.Right);
    // Assign a background image.
    button1.set_BackgroundImage(imageList1.get_Images().get_Item(0));
    // Specify the layout style of the background image. Tile is the
 
    // default.
    button1.set_BackgroundImageLayout(ImageLayout.Center);
    // Make the button the same size as the image.
    button1.set_Size(button1.get_BackgroundImage().get_Size());
    // Set the button's TabIndex and TabStop properties.
    button1.set_TabIndex(1);
    button1.set_TabStop(true);
    // Add a delegate to handle the Click event.
    button1.add_Click(new System.EventHandler(this.button1_Click));
    // Add the button to the form.
    this.get_Controls().Add(button1);
} //AddMyButton

プラットフォーム

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

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間
AnchorStyles 列挙体
Dock
Layout