Control.Anchor プロパティ

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

Control.cs

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

C#

public virtual System.Windows.Forms.AnchorStyles Anchor { get; set; }

プロパティ値

AnchorStyles

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

例

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

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);
}

注釈

プロパティを Anchor 使用して、親コントロールのサイズを変更する際にコントロールのサイズを自動的に変更する方法を定義します。 コントロールを親コントロールに固定すると、親コントロールのサイズが変更されたときに、アンカー付きエッジが親コントロールのエッジに対して相対的に同じ位置に維持されます。

コントロールをコンテナーの 1 つ以上の端に固定できます。 たとえば、 プロパティ値が にButtonTopBottom設定されている を持Formつ AnchorButton がある場合、 は の増加に合わせて FormHeight の上端と下端Formまでの固定距離を維持するように引き伸ばされます。

注意

Anchorプロパティと Dock プロパティは相互に排他的です。 一度に設定できるセットは 1 つだけで、最後のセットが優先されます。

注意 (継承者)

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

適用対象

こちらもご覧ください

• AnchorStyles
• Dock
• Layout