ScrollableControl.AutoScrollPosition Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la ubicación de la posición de desplazamiento automático.
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 propiedad
Un objeto Point que representa la posición de desplazamiento automático en píxeles.
- Atributos
Ejemplos
En el ejemplo de código siguiente se usa la ScrollableControl clase Panel derivada y se agrega un botón a la esquina superior izquierda del área desplazable. En el ejemplo se permite el desplazamiento determinado por .AutoScrollPosition El ejemplo se escribió bajo la suposición de que tiene un Form objeto que contiene un Panel con un Button en él. Para habilitar el desplazamiento automático, coloque el botón fuera del área cliente de 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
Comentarios
La AutoScrollPosition propiedad representa la ubicación de la parte visible de un control desplazable. Utilice esta propiedad para cambiar la parte del control que se muestra.
Al agregar controles mediante programación a un formulario, use la AutoScrollPosition propiedad para colocar el control dentro o fuera del área de desplazamiento visible actual.
Nota:
Los X valores de coordenada y Y recuperados son negativos si el control se ha desplazado lejos de su posición inicial (0,0). Al establecer esta propiedad, siempre debe asignar valores positivos X y Y para establecer la posición de desplazamiento en relación con la posición inicial. Por ejemplo, si tiene una barra de desplazamiento horizontal y establece x e y en 200, mueve el desplazamiento de 200 píxeles a la derecha; Si después establece x e y en 100, el desplazamiento parece saltar a la izquierda en 100 píxeles, ya que está estableciendo 100 píxeles lejos de la posición inicial. En el primer caso, AutoScrollPosition devuelve {-200, 0}; en el segundo caso, devuelve {-100,0}.
Para detectar cuándo AutoScrollPosition cambian, cree un controlador de eventos para el Paint evento, guarde el valor de posición anterior en una variable privada y compare el nuevo valor con el valor anterior en eventos posteriores Paint .
