ScrollableControl.SetAutoScrollMargin(Int32, Int32) メソッド

定義

自動スクロールのマージンのサイズを設定します。Sets the size of the auto-scroll margins.

public:
 void SetAutoScrollMargin(int x, int y);
public void SetAutoScrollMargin (int x, int y);
member this.SetAutoScrollMargin : int * int -> unit
Public Sub SetAutoScrollMargin (x As Integer, y As Integer)

パラメーター

x
Int32

Width 値。The Width value.

y
Int32

Height 値。The Height value.

次のコード例では、派生クラスPanelを使用します。The following code example uses the derived class, Panel. この例では、テキストボックスの位置を評価し、その親コンテナーである 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 box on the panel so that it overlaps at least one of the panel's edges. ボタンをクリックすると、このサブプロシージャを呼び出して、パネルの動作と外観の違いを確認できます。Call this subprocedure on the click of a button to see the difference in the panel's behavior and appearance.

void MySub()
{
   /* 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 MySub()
 {
    /* 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 MySub()
    ' 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 margin sets the width and height of the border around each control. この余白は、コンテナーでスクロールバーが必要になるタイミングと、コントロールが選択されたときにスクロールする場所を決定するために使用されます。This margin is used to determine when scroll bars are needed on the container and where to scroll to when a control is selected.

注意

負の数がxまたはyの値として渡された場合、値は0にリセットされます。If a negative number is passed in as the x or y values, the value will be reset to 0.

適用対象

こちらもご覧ください