ScrollableControl.AutoScrollPosition Własność
Definicja
Ważny
Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.
Pobiera lub ustawia lokalizację położenia automatycznego przewijania.
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
Wartość nieruchomości
Element Point reprezentujący położenie przewijania automatycznego w pikselach.
- Atrybuty
Przykłady
Poniższy przykład kodu używa klasy Panel pochodnej ScrollableControl i dodaje przycisk do lewego górnego rogu obszaru przewijanego. Przykład umożliwia przesunięcie określone przez element AutoScrollPosition. Przykład został napisany przy założeniu, że masz element Form zawierający element Panel z elementem Button na nim. Aby włączyć automatyczne przewijanie, umieść przycisk poza obszarem klienta obiektu 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
Uwagi
Właściwość AutoScrollPosition reprezentuje lokalizację widocznej części kontrolki przewijanej. Użyj tej właściwości, aby zmienić część wyświetlanej kontrolki.
Podczas programowego dodawania kontrolek do formularza użyj AutoScrollPosition właściwości , aby ustawić kontrolkę wewnątrz lub na zewnątrz bieżącego widocznego obszaru przewijania.
Uwaga
X Pobrane wartości współrzędnych i Y są ujemne, jeśli kontrolka została przewinięta od pozycji początkowej (0,0). Po ustawieniu tej właściwości należy zawsze przypisywać wartości dodatnie X i Y , aby ustawić położenie przewijania względem pozycji początkowej. Jeśli na przykład masz poziomy pasek przewijania i ustawisz wartość x i y na 200, przesuwasz przewijanie 200 pikseli po prawej stronie; Jeśli następnie ustawisz wartość x i y na 100, przewijanie pojawi się, aby przeskoczyć w lewo o 100 pikseli, ponieważ ustawiasz go 100 pikseli od pozycji początkowej. W pierwszym przypadku AutoScrollPosition zwraca wartość {-200, 0}. W drugim przypadku zwraca wartość {-100,0}.
Aby wykryć, kiedy AutoScrollPosition zmiany, utwórz program obsługi zdarzeń dla Paint zdarzenia, zapisz starą wartość pozycji w zmiennej prywatnej i porównaj nową wartość ze starą wartością dla kolejnych Paint zdarzeń.