ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin ScrollableControl.AutoScrollMargin Property

定義

自動スクロールのマージンのサイズを取得または設定します。Gets or sets the size of the auto-scroll margin.

public:
 property System::Drawing::Size AutoScrollMargin { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size AutoScrollMargin { get; set; }
member this.AutoScrollMargin : System.Drawing.Size with get, set
Public Property AutoScrollMargin As Size

プロパティ値

ASizeピクセル単位で自動スクロールのマージンの幅と高さを表します。A Size that represents the height and width of the auto-scroll margin in pixels.

例外

HeightまたはWidth割り当てられた値が 0 未満です。The Height or Width value assigned is less than 0.

次のコード例は、派生クラスを使用してPanelします。The following code example uses the derived class, Panel. 例はテキスト ボックスの位置を評価し、その親コンテナーをパネル コントロールの動作と外観を変更します。The example evaluates the location of a text box and changes the appearance and behavior of its parent container, the panel control. 例では、インスタンスを作成することが必要です、Panelコントロール、 TextBox、およびButtonします。The example requires that you have created an instance of a Panel control, TextBox, and Button. 少なくとも 1 つのパネルの端と重なるようにパネルに、テキスト ボックスを配置します。Place the text box on the panel so that it overlaps at least one of the panel's edges. パネルの動作と外観の違いを確認するためのボタンのクリックで、この関数を呼び出します。Call this function on the click of a button to see the difference in the panel's behavior and appearance.

void SetAutoScrollMargins()
{
   /* If the text box is outside the panel's bounds, 
          turn on auto-scrolling and set the margin. */
   if ( text1->Location.X > panel1->Location.X || text1->Location.Y > panel1->Location.Y )
   {
      panel1->AutoScroll = true;

      /* If the AutoScrollMargin is set to less 
                than (5,5), set it to 5,5. */
      if ( panel1->AutoScrollMargin.Width < 5 || panel1->AutoScrollMargin.Height < 5 )
      {
         panel1->SetAutoScrollMargin( 5, 5 );
      }
   }
}
private void SetAutoScrollMargins()
 {
    /* If the text box is outside the panel's bounds, 
       turn on auto-scrolling and set the margin. */  
    if (text1.Location.X > panel1.Location.X || 
       text1.Location.Y > panel1.Location.Y)
    {
       panel1.AutoScroll = true;
       /* If the AutoScrollMargin is set to less 
          than (5,5), set it to 5,5. */
       if( panel1.AutoScrollMargin.Width < 5 || 
          panel1.AutoScrollMargin.Height < 5)
       {
          panel1.SetAutoScrollMargin(5, 5);
       }
    }
 }
 
Private Sub SetAutoScrollMargins()
    ' If the text box is outside the panel's bounds,
    ' turn on auto-scrolling and set the margin. 
    If (text1.Location.X > panel1.Location.X) Or _
        (text1.Location.Y > panel1.Location.Y) Then
        panel1.AutoScroll = True
        ' If the AutoScrollMargin is set to less
        ' than (5,5), set it to 5,5. 
        If (panel1.AutoScrollMargin.Width < 5) Or _
            (panel1.AutoScrollMargin.Height < 5) Then
            
            panel1.SetAutoScrollMargin(5, 5)
        End If
    End If
End Sub

注釈

自動スクロールのマージンは、すべての子コントロール、スクロール可能な親コントロールの端との距離です。The auto-scroll margin is the distance between any child controls and the edges of the scrollable parent control. AutoScrollMarginサイズは、スクロール バーが必要かどうかを判断するスクロール可能なコントロールに含まれる子コントロールのサイズに追加されます。The AutoScrollMargin size is added to the size of any child controls contained in the scrollable control to determine whether or not scroll bars are needed. AutoScrollMarginプロパティは、親のスクロール可能なコントロールがサイズ変更または個々 の子コントロールは、ビュー、取り込まれるときに評価され、スクロール バーを表示する必要があるかどうかを決定するために使用します。The AutoScrollMargin property is evaluated when the parent scrollable control is resized or the individual child controls are brought into view, and is used to determine if scroll bars must be displayed. ドッキングされたコントロールは、スクロール バーを表示するかどうかを決定する計算から除外されます。Docked controls are excluded from the calculations that determine if scroll bars must be displayed.

注意

ドッキングされたコントロールの場合Dockプロパティに設定されてDockStyle.Fill、コントロールが親のスクロール可能なコントロールを格納および使用する場合、ドッキングされたコントロールは無視されます、AutoScrollMarginスクロール バーが必要かどうかを判断します。If a docked control's Dock property is set to DockStyle.Fill, the control fills the parent scrollable control and the docked control is ignored when using the AutoScrollMargin to determine whether scroll bars are needed.

親のスクロール可能なコントロールに子コントロールの端からの距離に割り当てられている値よりも小さいかどうか、AutoScrollMarginプロパティおよびAutoScrollプロパティに設定されてtrue、適切なスクロール バーが表示されます。If the distance from the edge of a child control to the parent scrollable control is less than the value assigned to the AutoScrollMargin property and the AutoScroll property is set to true, the appropriate scroll bar is displayed.

注意

お勧め、スクロール可能なコントロール内のコントロールをドッキングするときなど、子のスクロール可能なコントロールを追加する、 Panel、スクロールが必要となるその他のコントロールを格納します。We recommend, when docking controls within a scrollable control, that you add a child scrollable control, such as a Panel, to contain any other controls that might require scrolling. 子を追加する必要がありますPanelコントロールをスクロール可能なコントロールとそのDockプロパティに設定DockStyle.FillとそのAutoScrollプロパティに設定trueします。You should add the child Panel control to the scrollable control and its Dock property set to DockStyle.Fill and its AutoScroll property set to true. 設定する必要があります、AutoScrollに親のスクロール可能なコントロールのプロパティfalseします。You should set the AutoScroll property of the parent scrollable control to false.

適用対象

こちらもご覧ください