Nyelv

ScrollableControl.AutoScrollPosition Tulajdonság

Definíció

Lekéri vagy beállítja az automatikus görgetés helyét.

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

Tulajdonság értéke

Az Point automatikus görgetési pozíció képpontban való ábrázolása.

Attribútumok

Példák

Az alábbi példakód a ScrollableControl származtatott osztályt Panel használja, és hozzáad egy gombot a görgethető terület bal felső sarkához. A példa lehetővé teszi a AutoScrollPosition. A példa azzal a feltételezéssel lett megírva, hogy van egy Form olyanja, amely tartalmaz egy-egynel PanelButton . Az automatikus görgetés engedélyezéséhez helyezze a gombot az ügyfélterületen kívülre 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

Megjegyzések

A AutoScrollPosition tulajdonság a görgethető vezérlőelem látható részének helyét jelöli. Ezzel a tulajdonságot használva módosíthatja a vezérlőelem azon részét, amely megjelenik.

Amikor programozott módon ad hozzá vezérlőket egy űrlaphoz, a AutoScrollPosition tulajdonság használatával helyezze a vezérlőt az aktuális megtekinthető görgetőterületen belülre vagy kívülre.

Note

A X lekért és Y a koordináta-értékek negatívak, ha a vezérlő el van görgetve a kezdő helyzetétől (0,0). A tulajdonság beállításakor mindig pozitív X és Y értékeket kell hozzárendelnie ahhoz, hogy a görgetési pozíciót a kezdő pozícióhoz viszonyítva állítsa be. Ha például van egy vízszintes görgetősávja, és az x és az y értéket 200-ra állítja, a görgetést 200 képponttal jobbra mozgatja; ha ezután az x és az y értéket 100-ra állítja, a görgetés úgy tűnik, hogy 100 képponttal balra ugrik, mivel a kezdő pozíciótól 100 képpontnyira állítja be. Az első esetben a következőt adja vissza: AutoScrollPosition {-200, 0}; a második esetben az {-100,0}eredmény.

A változások észleléséhez AutoScrollPosition hozzon létre egy eseménykezelőt az Paint eseményhez, mentse a régi pozícióértéket egy privát változóban, és hasonlítsa össze az új értéket a későbbi Paint események régi értékével.

A következőre érvényes:

Lásd még