ScrollableControl.AutoScrollPosition ScrollableControl.AutoScrollPosition ScrollableControl.AutoScrollPosition ScrollableControl.AutoScrollPosition Property

Definición

Obtiene o establece la ubicación de la posición de desplazamiento automático.Gets or sets the location of the auto-scroll position.

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; }
member this.AutoScrollPosition : System.Drawing.Point with get, set
Public Property AutoScrollPosition As Point

Valor de propiedad

Un Point que representa la posición de desplazamiento automático en píxeles.A Point that represents the auto-scroll position in pixels.

Ejemplos

El siguiente ejemplo de código utiliza el ScrollableControl clase derivada Panel y agrega un botón a la esquina superior izquierda del área desplazable.The following code example uses the ScrollableControl derived class Panel and adds a button to the upper left corner of the scrollable area. En el ejemplo se permite el desplazamiento determinado por la AutoScrollPosition.The example allows for the offset determined by the AutoScrollPosition. En el ejemplo se escribió con la asunción de que tiene un Form que contiene un Panel con un Button en él.The example was written under the assumption that you have a Form that contains a Panel with a Button on it. Para habilitar el desplazamiento automático, coloque el botón fuera del área cliente de la Panel.To enable auto-scrolling, place the button outside of the client area of the 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

El AutoScrollPosition propiedad representa la ubicación de la parte visible de un control de desplazamiento.The AutoScrollPosition property represents the location of the visible portion of a scrollable control. Utilice esta propiedad para cambiar la parte del control que se muestra.Use this property to change the portion of the control that is displayed.

Agregar controles mediante programación a un formulario, use el AutoScrollPosition propiedad para colocar el control dentro o fuera del área de desplazamiento visible actual.When adding controls programmatically to a form, use the AutoScrollPosition property to position the control either inside or outside of the current viewable scroll area.

Nota

El X y Y recuperados los valores de coordenadas están negativos si se ha desplazado el control de su posición inicial (0,0).The X and Y coordinate values retrieved are negative if the control has scrolled away from its starting position (0,0). Al establecer esta propiedad, siempre debe asignar positivo X y Y valores para establecer la posición de desplazamiento con respecto a la posición inicial.When you set this property, you must always assign positive X and Y values to set the scroll position relative to the starting position. Por ejemplo, si tiene una barra de desplazamiento horizontal y establece las coordenadas x e y a 200, mueva el desplazamiento 200 píxeles a la derecha; Si, a continuación, Establece las coordenadas x e y en 100, el desplazamiento aparece saltar a la izquierda por 100 píxeles, porque se están estableciendo 100 píxeles fuera de la posición inicial.For example, if you have a horizontal scroll bar and you set x and y to 200, you move the scroll 200 pixels to the right; if you then set x and y to 100, the scroll appears to jump the left by 100 pixels, because you are setting it 100 pixels away from the starting position. En el primer caso, AutoScrollPosition devuelve {-200, 0}; en el segundo caso, devuelve {-100,0}.In the first case, AutoScrollPosition returns {-200, 0}; in the second case, it returns {-100,0}.

Para detectar cuándo AutoScrollPosition cambios, cree un controlador de eventos para el Paint evento, guarde el valor antiguo de la posición en una variable privada y compare el nuevo valor para el valor antiguo en sucesivas Paint eventos.To detect when AutoScrollPosition changes, create an event handler for the Paint event, save the old position value in a private variable, and compare the new value to the old value on subsequent Paint events.

Se aplica a

Consulte también: