ScrollableControl.AutoScrollPosition Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a localização da posição do auto-scroll.
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 de Propriedade
A Point que representa a posição de auto-scroll em pixels.
- Atributos
Exemplos
O exemplo de código seguinte usa a ScrollableControl classe Panel derivada e adiciona um botão no canto superior esquerdo da área deslizável. O exemplo permite o deslocamento determinado pelo AutoScrollPosition. O exemplo foi escrito sob a suposição de que tens um Form que contém um Panel com a Button sobre ele. Para ativar o deslocamento automático, coloque o botão fora da área do cliente do Panelarquivo .
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
Observações
A AutoScrollPosition propriedade representa a localização da parte visível de um controlo deslocável. Use esta propriedade para alterar a parte do controlo que é exibida.
Ao adicionar controlos programaticamente a um formulário, use a AutoScrollPosition propriedade para posicionar o controlo dentro ou fora da área de scroll visualizável atual.
Note
Os X valores das coordenadas e Y recuperados são negativos se o controlo se afastou da sua posição inicial (0,0). Ao definir esta propriedade, deve sempre atribuir valores positivos XY e para definir a posição do scroll em relação à posição inicial. Por exemplo, se tiver uma barra de scroll horizontal e definir x e y para 200, move o scroll 200 pixels para a direita; Se depois definires X e Y para 100, o scroll parece saltar para a esquerda 100 pixels, porque estás a definir para 100 pixels da posição inicial. No primeiro caso, AutoScrollPosition devolve {-200, 0}; no segundo caso, devolve {-100,0}.
Para detetar quando AutoScrollPosition muda, crie um gestor de eventos para o Paint evento, guarde o valor da posição antiga numa variável privada e compare o novo valor com o valor antigo em eventos subsequentes Paint .