ScrollableControl.AutoScrollPosition Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Source:: ScrollableControl.cs

Source:: ScrollableControl.cs

Source:: ScrollableControl.cs

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, set

Public Property AutoScrollPosition As Point

Valeur de propriété

Point

Point qui représente la position du défilement automatique en pixels.

Attributs: BrowsableAttribute

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.

Remarque

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 .

S’applique à

Produit	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Partage via