ScrollableControl.AutoScrollPosition Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l'emplacement de la position du défilement automatique.
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 PointValeur de propriété
Point qui représente la position du défilement automatique en pixels.
- Attributs
Exemples
L’exemple de code suivant utilise la ScrollableControl classe Panel dérivée et ajoute un bouton dans le coin supérieur gauche de la zone de défilement. L’exemple autorise le décalage déterminé par .AutoScrollPosition L’exemple a été écrit en partant du principe que vous avez un Form contenant un Panel avec un Button . Pour activer le défilement automatique, placez le bouton en dehors de la zone cliente du 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
Remarques
La AutoScrollPosition propriété représente l’emplacement de la partie visible d’un contrôle avec défilement. Utilisez cette propriété pour modifier la partie du contrôle affichée.
Lorsque vous ajoutez des contrôles par programmation à un formulaire, utilisez la AutoScrollPosition propriété pour positionner le contrôle à l’intérieur ou à l’extérieur de la zone de défilement visible actuelle.
Notes
Les X valeurs de coordonnées et Y récupérées sont négatives si le contrôle a fait défiler de sa position de départ (0,0). Lorsque vous définissez cette propriété, vous devez toujours affecter des valeurs positives X et Y pour définir la position de défilement par rapport à la position de départ. Par exemple, si vous avez une barre de défilement horizontale et que vous définissez x et y sur 200, vous déplacez le défilement de 200 pixels vers la droite ; si vous définissez ensuite x et y sur 100, le défilement apparaît pour faire sauter la gauche de 100 pixels, car vous le définissez à 100 pixels de la position de départ. Dans le premier cas, AutoScrollPosition retourne {-200, 0} ; dans le deuxième cas, elle retourne {-100,0}.
Pour détecter les AutoScrollPosition modifications, créez un gestionnaire d’événements pour l’événement Paint , enregistrez l’ancienne valeur de position dans une variable privée et comparez la nouvelle valeur à l’ancienne valeur sur les événements suivants Paint .
