Form.AutoScroll Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob das Formular den automatischen Bildlauf ermöglicht, oder legt diesen fest.

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

Eigenschaftswert

Boolean

true, um den automatischen Bildlauf für das Formular zu aktivieren, andernfalls false. Der Standardwert ist false.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die AutoScroll Eigenschaft verwenden, um die Anzeige von Steuerelementen zu aktivieren, die den Clientbereich eines Formulars outsize. Im Beispiel wird ein neues Formular erstellt und dem Formular ein Button Steuerelement hinzugefügt. Das Button Steuerelement wird positioniert, um den Clientbereich des neuen Formulars zu verkleinern. Die AutoScroll Eigenschaft ist auf true festgelegt, um Bildlaufleisten im Formular anzuzeigen, damit der Benutzer zum Steuerelement scrollen kann. In diesem Beispiel muss die in diesem Beispiel definierte Methode aus einem anderen Formular in einem Ereignishandler oder einer anderen Methode aufgerufen werden.

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

Hinweise

Wenn diese Eigenschaft auf true"" festgelegt ist, werden Bildlaufleisten im Formular angezeigt, wenn sich steuerelemente außerhalb des Clientbereichs des Formulars befinden. Wenn die automatische Registrierung aktiviert ist, wird der Clientbereich des Formulars automatisch scrollen, um das Steuerelement mit dem Eingabefokus sichtbar zu machen.

Sie können diese Eigenschaft verwenden, um zu verhindern, dass Benutzer die Möglichkeit haben, Steuerelemente anzuzeigen, wenn ihre Einstellungen für die Videoauflösung auf eine niedrige Auflösung festgelegt sind.