ScrollableControl.SetAutoScrollMargin メソッド

.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)

C#

public void SetAutoScrollMargin (
    int x,
    int y
)

C++

public:
void SetAutoScrollMargin (
    int x, 
    int y
)

J#

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

C#

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

J#

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

プラットフォーム

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

参照

関連項目
ScrollableControl クラス
ScrollableControl メンバ
System.Windows.Forms 名前空間
AutoScrollMargin
AutoScroll
AutoScrollMinSize