Form.AutoScroll Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define um valor que indica se o formulário permite a rolagem automática.

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

Valor da propriedade

Boolean

true para habilitar a rolagem automática no formulário; caso contrário, false. O padrão é false.

Exemplos

O exemplo a seguir demonstra como usar a AutoScroll propriedade para habilitar a exibição de controles que superam a área do cliente de um formulário. O exemplo cria um novo formulário e adiciona um Button controle ao formulário. O Button controle é posicionado supere a área do cliente do novo formulário. A AutoScroll propriedade é definida como true para exibir barras de rolagem no formulário para permitir que o usuário role até o controle. Este exemplo requer que o método definido neste exemplo seja chamado de outro formulário em um manipulador de eventos ou outro método.

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

Comentários

Se essa propriedade estiver definida como true, as barras de rolagem serão exibidas no formulário se algum controle estiver localizado fora da região do cliente do formulário. Além disso, quando o registro automático está ativado, a área do cliente do formulário rola automaticamente para tornar o controle com foco de entrada visível.

Você pode usar essa propriedade para impedir que os usuários percam a capacidade de exibir controles quando suas configurações de resolução de vídeo são definidas como uma resolução baixa.