ScrollableControl.AutoScrollPosition Propiedad

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 objeto Point que representa la posición de desplazamiento automático en píxeles.A Point that represents the auto-scroll position in pixels.

Atributos

Ejemplos

En el ejemplo de código siguiente ScrollableControl se usa Panel la clase derivada y se 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. El ejemplo permite el desplazamiento determinado por el AutoScrollPosition.The example allows for the offset determined by the AutoScrollPosition. El ejemplo se ha escrito bajo la suposición de que Form tiene un que Panel contiene un Button con un.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 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

La AutoScrollPosition propiedad representa la ubicación de la parte visible de un control desplazable.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.

Al agregar controles mediante programación a un formulario, utilice la 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

Los X valores Y de las coordenadas y recuperados son negativos si el control se ha desplazado fuera 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 valores y X Y positivos para establecer la posición de desplazamiento en relación con 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 x e y en 200, mueva el desplazamiento 200 píxeles a la derecha; Si, a continuación, establece x e y en 100, parece que el desplazamiento salta a la izquierda en 100 píxeles, porque está configurando 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 AutoScrollPosition los cambios, cree un controlador de eventos para Paint el evento, guarde el valor de posición anterior en una variable privada y compare el nuevo valor con el valor anterior en Paint los eventos posteriores.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: