ScrollableControl.AutoScrollMargin Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtient ou définit la taille de la marge de défilement automatique.

public:
 property System::Drawing::Size AutoScrollMargin { System::Drawing::Size get(); void set(System::Drawing::Size value); };
public System.Drawing.Size AutoScrollMargin { get; set; }
member this.AutoScrollMargin : System.Drawing.Size with get, set
Public Property AutoScrollMargin As Size

Valeur de propriété

Size

Un Size qui représente la hauteur et la largeur, en pixels, de la marge de défilement automatique.

Exceptions

ArgumentOutOfRangeException

La valeur Height ou Width assignée est inférieure à 0.

Exemples

L’exemple de code suivant utilise la classe dérivée. Panel L’exemple évalue l’emplacement d’une zone de texte et modifie l’apparence et le comportement de son conteneur parent, le contrôle du panneau. L’exemple nécessite que vous ayez créé une instance d’un Panel contrôle, TextBoxet Button. Placez la zone de texte sur le panneau afin qu’elle chevauche au moins l’un des bords du panneau. Appelez cette fonction sur le clic d’un bouton pour voir la différence dans le comportement et l’apparence du panneau.

void SetAutoScrollMargins()
{
   /* If the text box is outside the panel's bounds, 
          turn on auto-scrolling and set the margin. */
   if ( text1->Location.X > panel1->Location.X || text1->Location.Y > panel1->Location.Y )
   {
      panel1->AutoScroll = true;

      /* If the AutoScrollMargin is set to less 
                than (5,5), set it to 5,5. */
      if ( panel1->AutoScrollMargin.Width < 5 || panel1->AutoScrollMargin.Height < 5 )
      {
         panel1->SetAutoScrollMargin( 5, 5 );
      }
   }
}

private void SetAutoScrollMargins()
 {
    /* If the text box is outside the panel's bounds, 
       turn on auto-scrolling and set the margin. */  
    if (text1.Location.X > panel1.Location.X || 
       text1.Location.Y > panel1.Location.Y)
    {
       panel1.AutoScroll = true;
       /* If the AutoScrollMargin is set to less 
          than (5,5), set it to 5,5. */
       if( panel1.AutoScrollMargin.Width < 5 || 
          panel1.AutoScrollMargin.Height < 5)
       {
          panel1.SetAutoScrollMargin(5, 5);
       }
    }
 }

Private Sub SetAutoScrollMargins()
    ' If the text box is outside the panel's bounds,
    ' turn on auto-scrolling and set the margin. 
    If (text1.Location.X > panel1.Location.X) Or _
        (text1.Location.Y > panel1.Location.Y) Then
        panel1.AutoScroll = True
        ' If the AutoScrollMargin is set to less
        ' than (5,5), set it to 5,5. 
        If (panel1.AutoScrollMargin.Width < 5) Or _
            (panel1.AutoScrollMargin.Height < 5) Then
            
            panel1.SetAutoScrollMargin(5, 5)
        End If
    End If
End Sub

Remarques

La marge de défilement automatique est la distance entre les contrôles enfants et les bords du contrôle parent pouvant faire défiler. La AutoScrollMargin taille est ajoutée à la taille des contrôles enfants contenus dans le contrôle de défilement pour déterminer si des barres de défilement sont nécessaires ou non. La AutoScrollMargin propriété est évaluée lorsque le contrôle de défilement parent est redimensionné ou que les contrôles enfants individuels sont affichés et sont utilisés pour déterminer si les barres de défilement doivent être affichées. Les contrôles ancrés sont exclus des calculs qui déterminent si les barres de défilement doivent être affichées.

Notes

Si la propriété d’un Dock contrôle ancré est définie DockStyle.Fillsur , le contrôle remplit le contrôle de défilement parent et le contrôle ancré est ignoré lors de l’utilisation des AutoScrollMargin barres de défilement pour déterminer si des barres de défilement sont nécessaires.

Si la distance entre le bord d’un contrôle enfant et le contrôle de défilement parent est inférieure à la valeur affectée à la AutoScrollMargin propriété et que la AutoScroll propriété est définie truesur , la barre de défilement appropriée s’affiche.

Notes

Nous vous recommandons, lors de l’ancrage de contrôles dans un contrôle de défilement, d’ajouter un contrôle de défilement enfant, tel qu’un Panel, pour contenir d’autres contrôles susceptibles de nécessiter un défilement. Vous devez ajouter le contrôle enfant Panel au contrôle scrollable et sa Dock propriété définie DockStyle.Fill sur et sa AutoScroll propriété définie truesur . Vous devez définir la AutoScroll propriété du contrôle de défilement parent sur false.

S’applique à

Voir aussi