ScrollableControl.AutoScrollPosition Egenskap

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
ScrollableControl.cs
Källa:
ScrollableControl.cs
Källa:
ScrollableControl.cs
Källa:
ScrollableControl.cs
Källa:
ScrollableControl.cs

Hämtar eller anger platsen för den automatiska rullningspositionen.

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

Egenskapsvärde

Point

En Point som representerar autorullningspositionen i bildpunkter.

Attribut
BrowsableAttribute

Exempel

I följande kodexempel används den ScrollableControl härledda klassen Panel och en knapp läggs till i det övre vänstra hörnet i det rullningsbara området. Exemplet tillåter den förskjutning som bestäms av AutoScrollPosition. Exemplet skrevs under antagandet att du har en Form som innehåller en Panel med en Button på den. Om du vill aktivera automatisk rullning placerar du knappen utanför klientområdet i 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

Kommentarer

Egenskapen AutoScrollPosition representerar platsen för den synliga delen av en rullningsbar kontroll. Använd den här egenskapen om du vill ändra den del av kontrollen som visas.

När du lägger till kontroller programmatiskt i ett formulär använder du AutoScrollPosition egenskapen för att placera kontrollen i eller utanför det aktuella visningsbara rullningsområdet.

Note

X Och Y koordinatvärdena som hämtas är negativa om kontrollen har rullat bort från sin startposition (0,0). När du anger den här egenskapen måste du alltid tilldela positiva X värden och Y värden för att ställa in rullningspositionen i förhållande till startpositionen. Om du till exempel har en vågrät rullningslist och anger x och y till 200 flyttar du rullningslisten 200 bildpunkter åt höger. Om du sedan anger x och y till 100, verkar rullningslisten hoppa åt vänster med 100 bildpunkter, eftersom du ställer in den 100 bildpunkter bort från startpositionen. I det första fallet AutoScrollPosition returnerar {-200, 0}. I det andra fallet returneras {-100,0}.

Om du vill identifiera när AutoScrollPosition ändringar ändras skapar du en händelsehanterare för Paint händelsen, sparar det gamla positionsvärdet i en privat variabel och jämför det nya värdet med det gamla värdet för efterföljande Paint händelser.

Gäller för

Se även