Compartir a través de


ScrollableControl.AutoScrollPosition Propiedad

Definición

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, set
Public Property AutoScrollPosition As Point

Valor 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 .

Se aplica a

Consulte también