ScrollableControl.AutoScrollPosition Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta la posizione dello scorrimento automatico.

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.

Attributi

BrowsableAttribute

Esempio

Nell'esempio di codice seguente viene usata la ScrollableControl classe Panel derivata e viene aggiunto un pulsante all'angolo superiore sinistro dell'area scorrevole. L'esempio consente l'offset determinato da AutoScrollPosition. L'esempio è stato scritto sotto il presupposto che sia presente un Form oggetto contenente un Panel oggetto con un Button oggetto su di esso. Per abilitare lo scorrimento automatico, posizionare il pulsante all'esterno dell'area Panelclient di .

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 la posizione della parte visibile di un controllo scorrevole. Utilizzare questa proprietà per modificare la parte del controllo visualizzato.

Quando si aggiungono controlli a livello di codice a un modulo, usare la proprietà per posizionare il AutoScrollPosition controllo all'interno o all'esterno dell'area di scorrimento visualizzabile corrente.

Nota

I X valori delle coordinate e Y recuperati sono negativi se il controllo è stato spostato dalla posizione iniziale (0,0). Quando si imposta questa proprietà, è sempre necessario assegnare valori positivi X e Y positivi per impostare la posizione di scorrimento rispetto alla posizione iniziale. Ad esempio, se si dispone di una barra di scorrimento orizzontale e si imposta x e y su 200, si sposta lo scorrimento 200 pixel a destra; se si imposta x e y su 100, lo scorrimento appare saltare a sinistra per 100 pixel, perché lo si imposta da 100 pixel dalla posizione iniziale. Nel primo caso restituisce AutoScrollPosition {-200, 0}; nel secondo caso restituisce {-100,0}.

Per rilevare le AutoScrollPosition modifiche, creare un gestore eventi per l'evento Paint , salvare il valore di posizione precedente in una variabile privata e confrontare il nuovo valore con il valore precedente negli eventi successivi Paint .

Vedi anche

• AutoScroll
• AutoScrollMargin
• AutoScrollMinSize
• VerticalScroll
• HorizontalScroll