ScrollableControl.AutoScrollPosition Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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ść właściwości

Point

Element Point reprezentujący położenie przewijania automatycznego w pikselach.

Atrybuty
BrowsableAttribute

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ń.

Dotyczy

Zobacz też