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

Definizione

Ottiene o imposta la posizione dello scorrimento automatico.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

Valore della proprietà

Oggetto Point che rappresenta la posizione di scorrimento automatico in pixel.A Point that represents the auto-scroll position in pixels.

Esempi

Il codice seguente viene illustrato come utilizzare il ScrollableControl classe derivata Panel e aggiunge un pulsante nell'angolo in alto a sinistra dell'area di scorrimento.The following code example uses the ScrollableControl derived class Panel and adds a button to the upper left corner of the scrollable area. Nell'esempio viene consentito per l'offset in base il AutoScrollPosition.The example allows for the offset determined by the AutoScrollPosition. L'esempio è stata scritta in base al presupposto che è necessario un Form che contiene un Panel con un Button su di esso.The example was written under the assumption that you have a Form that contains a Panel with a Button on it. Per abilitare lo scorrimento automatico, posizionare il pulsante di fuori dell'area client del 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

Commenti

Il AutoScrollPosition proprietà rappresenta la posizione della parte di un controllo scorrevole visibile.The AutoScrollPosition property represents the location of the visible portion of a scrollable control. Utilizzare questa proprietà per modificare la parte del controllo che viene visualizzato.Use this property to change the portion of the control that is displayed.

Quando si aggiungono i controlli a livello di codice a un modulo, usare il AutoScrollPosition proprietà per posizionare il controllo all'interno o all'esterno dell'area di scorrimento visibile corrente.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

Il X e Y coordinati valori recuperati sono negativi se il controllo è stata fatta scorrere la posizione iniziale (0,0).The X and Y coordinate values retrieved are negative if the control has scrolled away from its starting position (0,0). Quando si imposta questa proprietà, è necessario assegnare sempre positive X e Y valori da impostare la posizione di scorrimento relativo alla posizione iniziale.When you set this property, you must always assign positive X and Y values to set the scroll position relative to the starting position. Ad esempio, se si dispone di una barra di scorrimento orizzontale e si impostare x e y a 200, spostare lo scorrimento 200 pixel a destra; Se quindi impostare x e y a 100, lo scorrimento viene spostato a sinistra di 100 pixel, dal momento che sono impostato è 100 pixel dalla posizione iniziale.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. Nel primo caso AutoScrollPosition restituisce {-200, 0}; nel secondo caso, viene restituito {-100,0}.In the first case, AutoScrollPosition returns {-200, 0}; in the second case, it returns {-100,0}.

Per rilevare il momento AutoScrollPosition le modifiche, creare un gestore eventi per il Paint evento, salvare il valore di posizione precedente in una variabile privata e confrontare il nuovo valore per il valore precedente in successive Paint gli eventi.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.

Si applica a

Vedi anche