Form.AutoScroll Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si en el formulario se permite el desplazamiento automático.

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 de propiedad

Boolean

true para habilitar el desplazamiento automático en el formulario; de lo contrario, false. De manera predeterminada, es false.

Ejemplos

En el ejemplo siguiente se muestra cómo usar la AutoScroll propiedad para habilitar la presentación de controles que están fuera del área cliente de un formulario. En el ejemplo se crea un formulario y se agrega un Button control al formulario. El Button control se coloca fuera del área cliente del nuevo formulario. La AutoScroll propiedad se establece en true para mostrar barras de desplazamiento en el formulario para permitir que el usuario se desplace hasta el control. En este ejemplo se requiere que se llame al método definido en este ejemplo desde otro formulario en un controlador de eventos u otro 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

Comentarios

Si esta propiedad se establece trueen , las barras de desplazamiento se muestran en el formulario si alguno de los controles se encuentra fuera del área cliente del formulario. Además, cuando la inscripción automática está activada, el área cliente del formulario se desplaza automáticamente para que el control con el foco de entrada sea visible.

Puede usar esta propiedad para evitar que los usuarios pierdan la capacidad de ver los controles cuando su configuración de resolución de vídeo esté establecida en una resolución baja.