ScrollableControl.ScrollControlIntoView(Control) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

O controle filho especificado é movido para o modo de exibição em um controle habilitado para rolagem automática.

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

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)

Parâmetros

activeControl: Control

O controle filho para rolar na exibição.

Exemplos

O exemplo de código a seguir habilita a rolagem automática para um formulário, redimensiona o formulário e garante que um botão permaneça visível depois que o formulário for redimensionado. O exemplo requer que você tenha um Form com um Button nomeado 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 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

Comentários

A AutoScroll propriedade deve ser definida truecomo e pelo menos uma das barras de rolagem, horizontal ou vertical, também deve estar visível, para que o ScrollControlIntoView método tenha um efeito. Para tornar as barras de rolagem horizontal e vertical visíveis, as HScroll propriedades e VScroll , respectivamente, devem ser definidas truecomo .

Se o activeControl parâmetro não for um controle filho, nenhuma ação ocorrerá.

Esse método pode gerar o Scroll evento.

Aplica-se a

Partilhar via