Form.AutoScroll Propiedad

Definición

Obtiene o establece un valor que indica si en el formulario se permite el desplazamiento automático.Gets or sets a value indicating whether the form enables autoscrolling.

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

true para habilitar el desplazamiento automático en el formulario; de lo contrario, false.true to enable autoscrolling on the form; otherwise, false. El valor predeterminado es false.The default is false.

Ejemplos

En el ejemplo siguiente se muestra cómo utilizar la propiedad AutoScroll para habilitar la presentación de controles que están sobredimensionados en el área cliente de un formulario.The following example demonstrates how to use the AutoScroll property to enable the display of controls that are outsize the client area of a form. En el ejemplo se crea un nuevo formulario y se agrega un control Button al formulario.The example creates a new form and adds a Button control to the form. El control Button está colocado en el área de cliente del nuevo formulario.The Button control is positioned outsize the client area of the new form. La propiedad AutoScroll está establecida en true para mostrar las barras de desplazamiento en el formulario y permitir al usuario desplazarse hasta el control.The AutoScroll property is set to true to display scroll bars on the form to enable the user to scroll to the control. Este ejemplo requiere que el método definido en este ejemplo se llame desde otro formulario en un controlador de eventos u otro método.This example requires that the method defined in this example is called from another form in an event handler or other method.

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 en true, las barras de desplazamiento se muestran en el formulario si los controles se encuentran fuera de la región cliente del formulario.If this property is set to true, scroll bars are displayed on the form if any controls are located outside the form's client region. Además, cuando el desplazamiento automático está activado, el área cliente del formulario se desplaza automáticamente para que el control con el foco de entrada esté visible.Additionally, when autoscrolling is on, the client area of the form automatically scrolls to make the control with input focus visible.

Puede usar esta propiedad para evitar que los usuarios pierdan la capacidad de ver los controles cuando la configuración de la resolución de vídeo está establecida en una resolución baja.You can use this property to prevent users from losing the ability to view controls when their video resolution settings are set to a low resolution.

Se aplica a