ScrollableControl.ScrollControlIntoView(Control) Method

Definition

Fait défiler le contrôle enfant spécifié pour qu'il apparaisse sur un contrôle à défilement automatique.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)

Parameters

activeControl
Control

Contrôle enfant devant apparaître.The child control to scroll into view.

Examples

L’exemple de code suivant active le défilement automatique pour un formulaire, redimensionne le formulaire et s’assure qu’un bouton reste visible après le redimensionnement du formulaire.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. L’exemple nécessite que vous disposiez d’une Form avec un Button nommé button2.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

Remarks

La propriété AutoScroll doit être définie sur true, et au moins l’une des barres de défilement, horizontale ou verticale, doit également être visible, pour que la méthode ScrollControlIntoView ait un effet.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. Pour afficher les barres de défilement horizontale et verticale, les propriétés HScroll et VScroll, respectivement, doivent être définies sur true.To make the horizontal and vertical scroll bars visible, the HScroll and VScroll properties, respectively, must be set to true.

Si le paramètre activeControl n’est pas un contrôle enfant, aucune action n’a lieu.If the activeControl parameter is not a child control, no action takes place.

Cette méthode peut déclencher l’événement Scroll.This method may raise the Scroll event.

Applies to

See also