ScrollableControl.AutoScrollPosition Propriété

Définition

Obtient ou définit l'emplacement de la position du défilement automatique.Gets or sets the location of the auto-scroll position.

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; }
member this.AutoScrollPosition : System.Drawing.Point with get, set
Public Property AutoScrollPosition As Point

Valeur de propriété

Point qui représente la position du défilement automatique en pixels.A Point that represents the auto-scroll position in pixels.

Attributs

Exemples

L’exemple de code suivant utilise la classe dérivée ScrollableControl Panel et ajoute un bouton dans l’angle supérieur gauche de la zone déroulante.The following code example uses the ScrollableControl derived class Panel and adds a button to the upper left corner of the scrollable area. L’exemple autorise l’offset déterminé par le AutoScrollPosition.The example allows for the offset determined by the AutoScrollPosition. L’exemple a été écrit en supposant que vous disposez d’un Form qui contient un Panel avec un Button.The example was written under the assumption that you have a Form that contains a Panel with a Button on it. Pour activer le défilement automatique, placez le bouton en dehors de la zone cliente du Panel.To enable auto-scrolling, place the button outside of the client area of the 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 propriété AutoScrollPosition représente l’emplacement de la partie visible d’un contrôle à défilement.The AutoScrollPosition property represents the location of the visible portion of a scrollable control. Utilisez cette propriété pour modifier la partie du contrôle qui s’affiche.Use this property to change the portion of the control that is displayed.

Quand vous ajoutez des contrôles par programmation à un formulaire, utilisez la propriété AutoScrollPosition pour positionner le contrôle à l’intérieur ou à l’extérieur de la zone de défilement affichable actuelle.When adding controls programmatically to a form, use the AutoScrollPosition property to position the control either inside or outside of the current viewable scroll area.

Notes

Les valeurs de coordonnée X et Y récupérées sont négatives si le contrôle a défilé en dehors de sa position de départ (0,0).The X and Y coordinate values retrieved are negative if the control has scrolled away from its starting position (0,0). Lorsque vous définissez cette propriété, vous devez toujours assigner des valeurs X et Y positives pour définir la position de défilement par rapport à la position de départ.When you set this property, you must always assign positive X and Y values to set the scroll position relative to the starting position. Par exemple, si vous avez une barre de défilement horizontale et que vous affectez à x et y la valeur 200, vous déplacez le défilement de 200 pixels vers la droite ; Si vous affectez ensuite la valeur 100 à x et y, le défilement s’affiche pour sauter la gauche de 100 pixels, car vous la définissez 100 pixels à partir de la position de départ.For example, if you have a horizontal scroll bar and you set x and y to 200, you move the scroll 200 pixels to the right; if you then set x and y to 100, the scroll appears to jump the left by 100 pixels, because you are setting it 100 pixels away from the starting position. Dans le premier cas, AutoScrollPosition retourne {-200, 0}; dans le deuxième cas, elle retourne {-100,0}.In the first case, AutoScrollPosition returns {-200, 0}; in the second case, it returns {-100,0}.

Pour détecter les modifications apportées par AutoScrollPosition, créez un gestionnaire d’événements pour l’événement Paint, enregistrez l’ancienne valeur position dans une variable privée et comparez la nouvelle valeur à l’ancienne valeur sur les événements Paint suivants.To detect when AutoScrollPosition changes, create an event handler for the Paint event, save the old position value in a private variable, and compare the new value to the old value on subsequent Paint events.

S’applique à

Voir aussi