ScrollableControl.AutoScrollPosition Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la posizione della posizione di 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, setPublic Property AutoScrollPosition As PointValore della proprietà
Oggetto Point che rappresenta la posizione di scorrimento automatico in pixel.
- Attributi
Esempio
Nell'esempio di codice seguente viene utilizzata la ScrollableControl classe Panel derivata e viene aggiunto un pulsante all'angolo superiore sinistro dell'area scorrevole. L'esempio consente l'offset determinato dall'oggetto AutoScrollPosition. L'esempio è stato scritto presupponendo che sia presente un Form oggetto che contiene un Panel oggetto con un oggetto su di Button esso. Per abilitare lo scorrimento automatico, posizionare il pulsante all'esterno dell'area client di 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 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 una maschera, utilizzare la AutoScrollPosition proprietà per posizionare il controllo all'interno o all'esterno dell'area di scorrimento visualizzabile corrente.
Annotazioni
I valori delle X coordinate e Y recuperati sono negativi se il controllo è stato spostato dalla posizione iniziale (0,0). Quando si imposta questa proprietà, è necessario assegnare sempre valori positivi X e Y 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 di 200 pixel a destra; se quindi si imposta x e y su 100, lo scorrimento sembra saltare a sinistra di 100 pixel, perché lo si imposta 100 pixel di distanza 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 della posizione precedente in una variabile privata e confrontare il nuovo valore con il valore precedente negli eventi successivi Paint .
