Form.AutoScroll プロパティとは何？わかりやすく解説 Weblio辞書

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

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

Form.AutoScroll プロパティ

フォームで自動スクロールを有効にするかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

<LocalizableAttribute(True)> _
Public Overrides Property
 AutoScroll As Boolean

Visual Basic (使用法)

Dim instance As Form
Dim value As Boolean

value = instance.AutoScroll

instance.AutoScroll = value

[LocalizableAttribute(true)] 
public override bool AutoScroll { get;
 set; }

C++

[LocalizableAttribute(true)] 
public:
virtual property bool AutoScroll {
    bool get () override;
    void set (bool value)
 override;
}

/** @property */
public boolean get_AutoScroll ()

/** @property */
public void set_AutoScroll (boolean value)

JScript

public override function get
 AutoScroll () : boolean

public override function set
 AutoScroll (value : boolean)

プロパティ値
フォームで自動スクロールを有効にする場合は true。それ以外の場合は false。既定値は false です。

解説

このプロパティが true に設定された場合、フォームのクライアント領域外に配置されたコントロールがあると、スクロールバーが表示されます。また、自動スクロールが有効な場合、入力フォーカスを持つコントロールが表示されるように、フォームのクライアント領域が自動的にスクロールします。

このプロパティを使用すると、ビデオ解像度が低い値に設定されている場合でも、コントロールを表示できないという事態を避けることができます。

使用例

AutoScroll プロパティを使用して、フォームのクライアント領域より大きいコントロールの表示を有効にする方法を次のコード例に示します。この例では、新しいフォームを作成し、そのフォームに Button コントロールを追加します。この Button コントロールのサイズは、作成した新しいフォームのクライアント領域より大きくなっています。ユーザーがコントロールでスクロールを行えるように、AutoScroll プロパティを true に設定して、フォーム上にスクロールバーを表示します。この例は、この例で定義されているメソッドが別のフォームからイベントハンドラか他のメソッドで呼び出されることを前提にしています。

Visual Basic

Private Sub DisplayMyScrollableForm()
   ' Create a new form.
   Dim form2 As New Form()
   ' Create a button to add to the new form.
   Dim button1 As New Button()
   ' Set text for the button.
   button1.Text = "Scrolled Button"
   ' Set the size of the button.
   button1.Size = New Size(100, 30)
   ' Set the location of the button to be outside the form's client
 area.
   button1.Location = New Point(form2.Size.Width + 200, form2.Size.Height
 + 200)

   ' Add the button control to the new form.
   form2.Controls.Add(button1)
   ' Set the AutoScroll property to true to provide scrollbars.
   form2.AutoScroll = True

   ' Display the new form as a dialog box.
   form2.ShowDialog()
End Sub

private void DisplayMyScrollableForm()
{
   // Create a new form.
   Form form2 = new Form();
   // Create a button to add to the new form.
   Button button1 = new Button();
   // Set text for the button.
   button1.Text = "Scrolled Button";
   // Set the size of the button.
   button1.Size = new Size(100,30);
   // Set the location of the button to be outside the form's client
 area.
   button1.Location = new Point(form2.Size.Width + 200, form2.Size.Height
 + 200);

   // Add the button control to the new form.
   form2.Controls.Add(button1);
   // Set the AutoScroll property to true to provide scrollbars.
   form2.AutoScroll = true;

   // Display the new form as a dialog box.
   form2.ShowDialog();
}

C++

private:
   void DisplayMyScrollableForm()
   {
      // Create a new form.
      Form^ form2 = gcnew Form;

      // Create a button to add to the new form.
      Button^ button1 = gcnew Button;

      // Set text for the button.
      button1->Text = "Scrolled Button";

      // Set the size of the button.
      button1->Size = System::Drawing::Size( 100, 30 );

      // Set the location of the button to be outside the form's client
 area.
      button1->Location = Point(form2->Size.Width + 200,form2->Size.Height
 + 200);

      // Add the button control to the new form.
      form2->Controls->Add( button1 );

      // Set the AutoScroll property to true to provide scrollbars.
      form2->AutoScroll = true;

      // Display the new form as a dialog box.
      form2->ShowDialog();
   }

private void DisplayMyScrollableForm()
{
    // Create a new form.
    Form form2 = new Form();

    // Create a button to add to the new form.
    Button button1 = new Button();

    // Set text for the button.
    button1.set_Text("Scrolled Button");

    // Set the size of the button.
    button1.set_Size(new Size(100, 30));

    // Set the location of the button to be outside the form's client
 area.
    button1.set_Location(new Point(form2.get_Size().get_Width()
 + 200, 
        form2.get_Size().get_Height() + 200));

    // Add the button control to the new form.
    form2.get_Controls().Add(button1);

    // Set the AutoScroll property to true to provide scrollbars.
    form2.set_AutoScroll(true);

    // Display the new form as a dialog box.
    form2.ShowDialog();       
} //DisplayMyScrollableForm