ScrollableControl.ScrollControlIntoView(Control) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Führt einen Bildlauf durch, um das angegebene untergeordnete Steuerelement in einem Steuerelement anzuzeigen, für das der automatische Bildlauf aktiviert ist.

public:
 void ScrollControlIntoView(System::Windows::Forms::Control ^ activeControl);

public void ScrollControlIntoView (System.Windows.Forms.Control? activeControl);

member this.ScrollControlIntoView : System.Windows.Forms.Control -> unit

Public Sub ScrollControlIntoView (activeControl As Control)

Parameter

activeControl

Control

Das durch einen Bildlauf anzuzeigende untergeordnete Steuerelement.

Beispiele

Das folgende Codebeispiel aktiviert den automatischen Bildlauf für ein Formular, ändert die Größe des Formulars und stellt sicher, dass eine Schaltfläche sichtbar bleibt, nachdem die Größe des Formulars geändert wurde. Das Beispiel erfordert, dass Sie über eine Form mit einem Button benannten button2 verfügen.

private:
   void ResizeForm()
   {
      
      // Enable auto-scrolling for the form.
      this->AutoScroll = true;
      
      // Resize the form.
      Rectangle r = this->ClientRectangle;
      
      // Subtract 100 pixels from each side of the Rectangle.
      r.Inflate(  -100, -100 );
      this->Bounds = this->RectangleToScreen( r );
      
      // Make sure button2 is visible.
      this->ScrollControlIntoView( button2 );
   }

private void ResizeForm()
{
   // Enable auto-scrolling for the form.
   this.AutoScroll = true;

   // Resize the form.
   Rectangle r = this.ClientRectangle;
   // Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(-100, -100);
   this.Bounds = this.RectangleToScreen(r);

   // Make sure button2 is visible.
   this.ScrollControlIntoView(button2);
}

Private Sub ResizeForm()
   ' Enable auto-scrolling for the form.
   Me.AutoScroll = True
   
   ' Resize the form.
   Dim r As Rectangle = Me.ClientRectangle
   ' Subtract 100 pixels from each side of the Rectangle.
   r.Inflate(- 100, - 100)
   Me.Bounds = Me.RectangleToScreen(r)
   
   ' Make sure button2 is visible.
   Me.ScrollControlIntoView(button2)
End Sub

Hinweise

Die AutoScroll -Eigenschaft muss auf truefestgelegt werden, und mindestens eine der Bildlaufleisten (horizontal oder vertikal) muss ebenfalls sichtbar sein, damit die ScrollControlIntoView -Methode eine Wirkung hat. Um die horizontalen und vertikalen Bildlaufleisten sichtbar zu machen, müssen die HScroll Eigenschaften und VScroll auf festgelegt truewerden.

Wenn der activeControl Parameter kein untergeordnetes Steuerelement ist, wird keine Aktion ausgeführt.

Diese Methode kann das Scroll -Ereignis auslösen.

Weitere Informationen

• AutoScroll
• SetDisplayRectLocation(Int32, Int32)
• HScroll
• VScroll
• Scroll