Cette documentation est archivée et n’est pas conservée.

ScrollBar.SmallChange, propriété

Obtient ou définit la valeur à ajouter ou à soustraire de la propriété Value lorsque la case de défilement est déplacée sur une petite distance.

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

public int SmallChange { get; set; }
/** @property */
public int get_SmallChange ()

/** @property */
public void set_SmallChange (int value)

public function get SmallChange () : int

public function set SmallChange (value : int)

Valeur de la propriété

Valeur numérique. La valeur par défaut est 1.

Type d'exceptionCondition

ArgumentOutOfRangeException

La valeur assignée est inférieure à 0.

Lorsque l'utilisateur appuie sur l'une des touches de direction ou clique sur l'un des boutons de la barre de défilement, la propriété Value change en fonction de la valeur définie dans la propriété SmallChange.

Vous pouvez définir la valeur SmallChange à un pourcentage des valeurs Height (pour une barre de défilement verticale) ou Width (pour une barre de défilement horizontale). Ceci maintient la distance de déplacement de votre barre de défilement proportionnellement à sa taille.

L'exemple de code suivant utilise les classes dérivées VScrollBar et HScrollBar et définit certaines de leurs propriétés communes. La valeur de leurs propriétés Maximum est égale à la valeur de Height ou de Width du Image assigné à leur parent, PictureBox. La propriété LargeChange est égale à la taille de la zone d'image (en soustrayant la hauteur ou la largeur des barres de défilement). La valeur de la propriété SmallChange est égale à celle de la propriété LargeChange divisée par 5. Enfin, les valeurs de la propriété Value des deux barres de défilement sont égales à 0. Il en résulte des barres de défilement verticale et horizontale affichées sur une zone d'image qui affiche le coin supérieur gauche de Image. Les barres de défilement ne défileront pas après la fin de l'image et, lorsqu'un défilement LargeChange se produit, l'image ne se déplacera que selon une distance égale à celle de la zone affichée dans la zone d'image. Cinq défilements SmallChange sont nécessaires pour se déplacer de la même distance qu'un défilement LargeChange. Le code suppose que PictureBox, HScrollBar, VScrollBar et Image ont tous été créés sur Form. Il suppose également l'ajout préalable d'une référence à l'espace de noms System.Drawing. Pour du code supplémentaire pouvant étendre cet exemple, consultez la vue d'ensemble de la classe ScrollBar.

public void SetScrollBarValues() 
{
   // Set the Maximum, Minimum, LargeChange and SmallChange properties.
   this.vScrollBar1.Minimum = 0;
   this.hScrollBar1.Minimum = 0;
   // If the offset does not make the Maximum less than zero, set its value. 
   if( (this.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width) > 0)
   {
      this.hScrollBar1.Maximum = this.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width;
   }
   /* If the VScrollBar is visible, adjust the Maximum of the 
      HSCrollBar to account for the width of the VScrollBar. */
   if(this.vScrollBar1.Visible)
   {
      this.hScrollBar1.Maximum += this.vScrollBar1.Width;
   }
   this.hScrollBar1.LargeChange = this.hScrollBar1.Maximum / 10;
   this.hScrollBar1.SmallChange = this.hScrollBar1.Maximum / 20;
   // Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   this.hScrollBar1.Maximum += this.hScrollBar1.LargeChange;
     
   // If the offset does not make the Maximum less than zero, set its value.    
   if( (this.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height) > 0)
   {
      this.vScrollBar1.Maximum = this.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height;
   }
   /* If the HScrollBar is visible, adjust the Maximum of the 
      VSCrollBar to account for the width of the HScrollBar.*/
   if(this.hScrollBar1.Visible)
   {
      this.vScrollBar1.Maximum += this.hScrollBar1.Height;
   }
   this.vScrollBar1.LargeChange = this.vScrollBar1.Maximum / 10;
   this.vScrollBar1.SmallChange = this.vScrollBar1.Maximum / 20;
   // Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   this.vScrollBar1.Maximum += this.vScrollBar1.LargeChange;
}

public void SetScrollBarValues()
{
    // Set the Maximum, Minimum, LargeChange and SmallChange properties.
    this.vScrollBar1.set_Minimum(0);
    this.hScrollBar1.set_Minimum(0);

    // If the offset does not make the Maximum less than zero, 
    // set its value. 
    if (this.pictureBox1.get_Image().get_Size().get_Width() 
        - pictureBox1.get_ClientSize().get_Width() > 0) {
            this.hScrollBar1.set_Maximum(
                this.pictureBox1.get_Image().get_Size().get_Width() 
                - pictureBox1.get_ClientSize().get_Width());
    }

    /* If the VScrollBar is visible, adjust the Maximum of the 
       HSCrollBar to account for the width of the VScrollBar. 
     */
    if (this.vScrollBar1.get_Visible()) {
        this.hScrollBar1.set_Maximum(
            this.hScrollBar1.get_Maximum() + this.vScrollBar1.get_Width());
    }

    this.hScrollBar1.set_LargeChange(this.hScrollBar1.get_Maximum() / 10);
    this.hScrollBar1.set_SmallChange(this.hScrollBar1.get_Maximum() / 20);

    // Adjust the Maximum value to make the raw Maximum value attainable 
    // by user interaction.
    this.hScrollBar1.set_Maximum(
        this.hScrollBar1.get_Maximum() 
        + this.hScrollBar1.get_LargeChange());

    // If the offset does not make the Maximum less than zero, 
    // set its value.    
    if (this.pictureBox1.get_Image().get_Size().get_Height() 
        - pictureBox1.get_ClientSize().get_Height() > 0) {
            this.vScrollBar1.set_Maximum(
                this.pictureBox1.get_Image().get_Size().get_Height() 
                - pictureBox1.get_ClientSize().get_Height());
    }

    /* If the HScrollBar is visible, adjust the Maximum of the 
       VSCrollBar to account for the width of the HScrollBar.
     */
    if (this.hScrollBar1.get_Visible()) {
        this.vScrollBar1.set_Maximum(this.vScrollBar1.get_Maximum() 
            + this.hScrollBar1.get_Height());
    }

    this.vScrollBar1.set_LargeChange(this.vScrollBar1.get_Maximum() / 10);
    this.vScrollBar1.set_SmallChange(this.vScrollBar1.get_Maximum() / 20);

    // Adjust the Maximum value to make the raw Maximum value attainable 
    // by user interaction.
    this.vScrollBar1.set_Maximum(
        this.vScrollBar1.get_Maximum() 
        + this.vScrollBar1.get_LargeChange());
} //SetScrollBarValues

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Afficher: