ScrollableControl.ScrollControlIntoView(Control) Methode

Definition

Führt einen Bildlauf durch, um das angegebene untergeordnete Steuerelement in einem Steuerelement anzuzeigen, für das der automatische Bildlauf aktiviert ist.Scrolls the specified child control into view on an auto-scroll enabled control.

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.The child control to scroll into view.

Beispiele

Im folgenden Codebeispiel wird der automatische Bildlauf für ein Formular aktiviert, die Größe des Formulars geändert und sichergestellt, dass eine Schaltfläche sichtbar bleibt, nachdem die Größe des Formulars geändert wurde.The following code example enables auto-scrolling for a form, resizes the form, and ensures that a button remains visible after the form is resized. Für das Beispiel ist es erforderlich, Form dass über Button ein button2 mit dem Namen verfügt.The example requires that you have a Form with a Button named button2 on it.

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 Schiebe leisten (horizontal oder vertikal) muss sichtbar sein, damit die ScrollControlIntoView -Methode einen Effekt hat.The AutoScroll property must be set to true, and at least one of the scroll bars, horizontal or vertical, must also be visible, for the ScrollControlIntoView method to have an effect. Um die horizontalen und vertikalen Scrollleisten sichtbar zu machen, HScroll müssen VScroll die-Eigenschaft und die-Eigenschaft auf truefestgelegt werden.To make the horizontal and vertical scroll bars visible, the HScroll and VScroll properties, respectively, must be set to true.

Wenn der activeControl -Parameter kein untergeordnetes Steuerelement ist, findet keine Aktion statt.If the activeControl parameter is not a child control, no action takes place.

Diese Methode kann das Scroll -Ereignis hervorheben.This method may raise the Scroll event.

Gilt für:

Siehe auch