ScrollableControl.AutoScrollPosition Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o local da posição de rolagem automática.

public:
 property System::Drawing::Point AutoScrollPosition { System::Drawing::Point get(); void set(System::Drawing::Point value); };

[System.ComponentModel.Browsable(false)]
public System.Drawing.Point AutoScrollPosition { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.AutoScrollPosition : System.Drawing.Point with get, set

Public Property AutoScrollPosition As Point

Valor da propriedade

Point

Um Point que representa a posição de rolagem automática em pixels.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código a seguir usa a ScrollableControl classe Panel derivada e adiciona um botão ao canto superior esquerdo da área rolável. O exemplo permite o deslocamento determinado pelo AutoScrollPosition. O exemplo foi escrito sob a suposição de que você tem um Form que contém um Panel com um Button nele. Para habilitar a rolagem automática, coloque o botão fora da área do cliente do Panel.

private:
   void button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      /* Add a button to top left corner of the
            * scrollable area, allowing for the offset. */
      panel1->AutoScroll = true;
      Button^ myButton = gcnew Button;
      myButton->Location = Point(0 + panel1->AutoScrollPosition.X,0 + panel1->AutoScrollPosition.Y);
      panel1->Controls->Add( myButton );
   }

private void button1_Click(object sender, EventArgs e)
{
   /* Add a button to top left corner of the 
    * scrollable area, allowing for the offset. */
   panel1.AutoScroll = true;
   Button myButton = new Button();
   myButton.Location = new Point(
      0 + panel1.AutoScrollPosition.X, 
      0 + panel1.AutoScrollPosition.Y);
   panel1.Controls.Add(myButton);
}

Private Sub button1_Click(sender As Object, _
   e As EventArgs) Handles button1.Click
   ' Add a button to top left corner of the 
   ' scrollable area, allowing for the offset. 
   panel1.AutoScroll = True
   Dim myButton As New Button()
   myButton.Location = New Point( _
      0 + panel1.AutoScrollPosition.X, _
      0 + panel1.AutoScrollPosition.Y)
   panel1.Controls.Add(myButton)
End Sub

Comentários

A AutoScrollPosition propriedade representa o local da parte visível de um controle rolável. Use essa propriedade para alterar a parte do controle que é exibida.

Ao adicionar controles programaticamente a um formulário, use a AutoScrollPosition propriedade para posicionar o controle dentro ou fora da área de rolagem visível atual.

Observação

Os X valores de coordenadas e Y recuperados serão negativos se o controle tiver rolado para longe de sua posição inicial (0,0). Ao definir essa propriedade, você sempre deve atribuir valores positivos X e Y para definir a posição de rolagem em relação à posição inicial. Por exemplo, se você tiver uma barra de rolagem horizontal e definir x e y como 200, mova a rolagem de 200 pixels para a direita; se você definir x e y como 100, a rolagem parecerá saltar para a esquerda em 100 pixels, pois você está definindo-a a 100 pixels da posição inicial. No primeiro caso, AutoScrollPosition retorna {-200, 0}; no segundo caso, ele retorna {-100,0}.

Para detectar quando AutoScrollPosition as alterações são feitas, crie um manipulador de eventos para o Paint evento, salve o valor da posição antiga em uma variável privada e compare o novo valor com o valor antigo em eventos subsequentes Paint .

Confira também

• AutoScroll
• AutoScrollMargin
• AutoScrollMinSize
• VerticalScroll
• HorizontalScroll