ScrollableControl.ScrollControlIntoView メソッド

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

ScrollableControl.ScrollControlIntoView メソッド

自動スクロール機能が有効になっているコントロール上で、指定した子コントロールが表示されるまでスクロールします。

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

Visual Basic (宣言)

Public Sub ScrollControlIntoView ( _
    activeControl As Control _
)

Visual Basic (使用法)

Dim instance As ScrollableControl
Dim activeControl As Control

instance.ScrollControlIntoView(activeControl)

C#

public void ScrollControlIntoView (
    Control activeControl
)

C++

public:
void ScrollControlIntoView (
    Control^ activeControl
)

J#

public void ScrollControlIntoView (
    Control activeControl
)

JScript

public function ScrollControlIntoView (
    activeControl : Control
)

パラメータ

activeControl

スクロールして表示する子コントロール。

解説

ScrollControlIntoView メソッドの効果を出すには、AutoScroll プロパティを true に設定し、少なくとも 1 つのスクロール バー (水平または垂直) を表示しておく必要があります。水平スクロール バーを表示するには HScroll プロパティを、垂直スクロール バーを表示するには VScroll プロパティを、それぞれ true に設定します。

activeControl パラメータが子コントロールでない場合、アクションは実行されません。

このメソッドを呼び出すと、Scroll イベントが発生する場合があります。

使用例

フォームでの自動スクロール機能を有効にしてそのフォームのサイズを変更し、サイズ変更した後もボタンが非表示にならないようにするコード例を次に示します。この例では、button2 という名前の Button が配置された Form が作成されている必要があります。

Visual Basic

Private Sub ResizeForm()
   ' Enable auto-scrolling for the form.
   Me.AutoScroll = True
   
   ' Resize the form.
   Dim r As Rectangle = Me.ClientRectangle
   ' Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(- 100, - 100)
   Me.Bounds = Me.RectangleToScreen(r)
   
   ' Make sure button2 is visible.
   Me.ScrollControlIntoView(button2)
End Sub

C#

private void ResizeForm()
{
   // Enable auto-scrolling for the form.
   this.AutoScroll = true;

   // Resize the form.
   Rectangle r = this.ClientRectangle;
   // Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(-100, -100);
   this.Bounds = this.RectangleToScreen(r);

   // Make sure button2 is visible.
   this.ScrollControlIntoView(button2);
}

C++

private:
   void ResizeForm()
   {
      
      // Enable auto-scrolling for the form.
      this->AutoScroll = true;
      
      // Resize the form.
      Rectangle r = this->ClientRectangle;
      
      // Subtract 100 pixels from each side of the Rectangle.
      r.Inflate(  -100, -100 );
      this->Bounds = this->RectangleToScreen(
 r );
      
      // Make sure button2 is visible.
      this->ScrollControlIntoView( button2 );
   }

J#

private void ResizeForm()
{
    // Enable auto-scrolling for the form.
    this.set_AutoScroll(true);
    // Resize the form.
    Rectangle r = this.get_ClientRectangle();
    // Subtract 100 pixels from each side of the Rectangle.
    r.Inflate(-100, -100);
    this.set_Bounds(this.RectangleToScreen(r));
    // Make sure button2 is visible.
    this.ScrollControlIntoView(button2);
} //ResizeForm

プラットフォーム

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 名前空間
AutoScroll
SetDisplayRectLocation
HScroll
VScroll
Scroll