ScrollableControl.AutoScrollPosition Proprietà

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; }
[<System.ComponentModel.Browsable(false)>]
member this.AutoScrollPosition : System.Drawing.Point with get, set
Public Property AutoScrollPosition As Point

Valore della proprietà

Point

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

Attributi

Esempio

Nell'esempio di codice seguente viene usata la ScrollableControl classe derivata Panel e viene aggiunto un pulsante nell'angolo superiore sinistro dell'area scorrevole.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 l'offset determinato da AutoScrollPosition .The example allows for the offset determined by the AutoScrollPosition. L'esempio è stato scritto supponendo che sia presente un oggetto Form che contiene un oggetto Panel con un oggetto Button .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 all'esterno dell'area client di 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

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

Quando si aggiungono controlli a livello di codice a un form, utilizzare la AutoScrollPosition proprietà per posizionare il controllo all'interno o all'esterno dell'area di scorrimento visualizzabile 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

I X Y valori della coordinata e recuperati sono negativi se il controllo è stato spostato fuori dalla 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à, è sempre necessario assegnare X valori positivi e Y per impostare la posizione di scorrimento rispetto 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 impostano x e y su 200, si sposta lo scorrimento 200 pixel a destra; Se successivamente si impostano x e y su 100, lo scorrimento verrà visualizzato a sinistra di 100 pixel, perché si sta impostando il valore di 100 pixel a partire 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, restituisce {-100,0} .In the first case, AutoScrollPosition returns {-200, 0}; in the second case, it returns {-100,0}.

Per rilevare le AutoScrollPosition modifiche apportate, creare un gestore eventi per l' Paint evento, salvare il valore di posizione precedente in una variabile privata e confrontare il nuovo valore con quello precedente negli Paint eventi successivi.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