ScrollableControl.AutoScrollPosition Propriedade
Definição
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.
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, setPublic Property AutoScrollPosition As PointValor da propriedade
Um Point que representa a posição de rolagem automática em pixels.
- Atributos
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 .
