Form.AutoScroll Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает значение, определяющее, разрешена ли в форме автоматическая прокрутка.

public:
 virtual property bool AutoScroll { bool get(); void set(bool value); };

public override bool AutoScroll { get; set; }

member this.AutoScroll : bool with get, set

Public Overrides Property AutoScroll As Boolean

Значение свойства

Boolean

true для включения автопрокрутки на форме; в противном случае — false. Значение по умолчанию — false.

Примеры

В следующем примере показано, как использовать AutoScroll свойство для включения отображения элементов управления, которые выходят за пределы клиентской области формы. В примере создается новая форма и добавляется Button элемент управления в форму. Элемент Button управления размещается вне клиентской области новой формы. Свойство AutoScroll имеет значение true, чтобы отобразить полосы прокрутки в форме, чтобы пользователь мог прокрутить элемент управления. В этом примере требуется, чтобы метод, определенный в этом примере, вызывался из другой формы в обработчике событий или другом методе.

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

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

Комментарии

Если для этого свойства задано значение true, полосы прокрутки отображаются в форме, если какие-либо элементы управления находятся за пределами клиентской области формы. Кроме того, при включенной автозакроллинге клиентская область формы автоматически прокручивается, чтобы сделать элемент управления видимым с фокусом ввода.

Это свойство можно использовать, чтобы запретить пользователям потерять возможность просматривать элементы управления, если для параметров разрешения видео задано низкое разрешение.