ScrollableControl.AutoScrollPosition Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de locatie van de positie van automatisch schuiven op of stelt u deze in.
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 PointWaarde van eigenschap
Een Point die de positie van automatisch schuiven in pixels vertegenwoordigt.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld wordt de ScrollableControl afgeleide klasse Panel gebruikt en wordt een knop toegevoegd aan de linkerbovenhoek van het schuifbare gebied. In het voorbeeld kan de offset worden bepaald door de AutoScrollPosition. Het voorbeeld is geschreven onder de veronderstelling dat u een Form met een Panel bevat Button erop. Als u automatisch schuiven wilt inschakelen, plaatst u de knop buiten het clientgebied van het 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
Opmerkingen
De AutoScrollPosition eigenschap vertegenwoordigt de locatie van het zichtbare gedeelte van een besturingselement waarop u kunt schuiven. Gebruik deze eigenschap om het gedeelte van het weergegeven besturingselement te wijzigen.
Wanneer u besturingselementen programmatisch aan een formulier toevoegt, gebruikt u de AutoScrollPosition eigenschap om het besturingselement binnen of buiten het huidige, zichtbaar schuifgebied te plaatsen.
Note
De X opgehaalde waarden en Y coördinaatwaarden zijn negatief als het besturingselement van de beginpositie (0,0) is weggeschoven. Wanneer u deze eigenschap instelt, moet u altijd positieve X waarden Y toewijzen om de schuifpositie ten opzichte van de beginpositie in te stellen. Als u bijvoorbeeld een horizontale schuifbalk hebt en u x en y instelt op 200, verplaatst u de schuifbalk van 200 pixels naar rechts; als u vervolgens x en y instelt op 100, lijkt de schuif met 100 pixels naar links te springen, omdat u deze 100 pixels van de beginpositie instelt. In het eerste geval AutoScrollPosition wordt {-200, 0} geretourneerd; in het tweede geval wordt het geretourneerd {-100,0}.
Als u wilt detecteren wanneer AutoScrollPosition wijzigingen zijn aangebracht, maakt u een gebeurtenis-handler voor de Paint gebeurtenis, slaat u de oude positiewaarde op in een privévariabele en vergelijkt u de nieuwe waarde met de oude waarde op volgende Paint gebeurtenissen.
