ScrollableControl.SetAutoScrollMargin メソッドとは何？わかりやすく解説 Weblio辞書

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

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

ScrollableControl.SetAutoScrollMargin メソッド

自動スクロールのマージンのサイズを設定します。

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

Visual Basic (宣言)

Public Sub SetAutoScrollMargin ( _
    x As Integer, _
    y As Integer _
)

Visual Basic (使用法)

Dim instance As ScrollableControl
Dim x As Integer
Dim y As Integer

instance.SetAutoScrollMargin(x, y)

public void SetAutoScrollMargin (
    int x,
    int y
)

C++

public:
void SetAutoScrollMargin (
    int x, 
    int y
)

public void SetAutoScrollMargin (
    int x, 
    int y
)

JScript

public function SetAutoScrollMargin (
    x : int, 
    y : int
)

パラメータ

x: Width 値。

y: Height 値。

解説

マージンでは、各コントロールの境界線の幅と高さを設定します。このマージンを使用して、コンテナにスクロールバーが必要な場合を決定したり、コントロールが選択されたときのスクロール先の位置を決定したりします。

メモ
x または y の値として負の数が渡されると、値は 0 にリセットされます。

使用例

派生クラス Panel を使用するコード例を次に示します。この例では、テキストボックスの位置を評価し、その親コンテナであるパネルコントロールの外観と動作を変更します。この例では、Panel コントロール、TextBox、および Button のインスタンスが作成されている必要があります。テキストボックスを少なくとも 1 つのパネルの端と重なるようにパネルに配置します。ボタンがクリックされたときにこの Sub プロシージャを呼び出して、パネルの動作と外観の違いを確認します。

Visual Basic

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

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

C++

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.get_Location().get_X() > panel1.get_Location().get_X()
 
        || text1.get_Location().get_Y() > panel1.get_Location().get_Y()) {
            panel1.set_AutoScroll(true);

        /* If the AutoScrollMargin is set to 
           less than (5,5), set it to 5,5. 
         */
        if (panel1.get_AutoScrollMargin().get_Width() < 5 
            || panel1.get_AutoScrollMargin().get_Height() < 5) {
                panel1.SetAutoScrollMargin(5, 5);
        }
    }
} //MySub