(0) exportieren Drucken
Alle erweitern

ScrollBar.SmallChange-Eigenschaft

Ruft den Wert ab, der zur Value-Eigenschaft addiert oder von dieser subtrahiert werden soll, wenn das Bildlauffeld um eine kleine Strecke verschoben wird, oder legt diesen fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in 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)

Eigenschaftenwert

Ein numerischer Wert. Der Standardwert ist 1.

AusnahmetypBedingung

ArgumentOutOfRangeException

Der zugewiesene Wert ist kleiner als 0.

Wenn Benutzer eine der Pfeiltasten drücken oder auf eine der Schaltflächen der Bildlaufleiste klicken, wird die Value-Eigenschaft entsprechend dem in der SmallChange-Eigenschaft festgelegten Wert geändert.

Sie können den SmallChange-Wert auch auf einen Prozentsatz des Height-Werts (bei einer vertikalen Bildlaufleiste) oder des Width-Werts (bei einer horizontalen Bildlaufleiste) festlegen. Dadurch verhält sich der Abstand, um den die Bildlaufleiste verschoben wird, relativ zu ihrer Größe.

Im folgenden Codebeispiel werden die abgeleitete VScrollBar-Klasse und HScrollBar-Klasse verwendet und einige ihrer allgemeinen Eigenschaften festgelegt. Die Maximum-Eigenschaften werden entsprechend der Height oder der Width des Image festgelegt, das dem übergeordneten Element, einer PictureBox, zugewiesen ist. Die LargeChange-Eigenschaft wird entsprechend der Größe des Bildfelds festgelegt, abzüglich der Höhe und Breite der Bildlaufleisten. Die SmallChange-Eigenschaft wird gleich dem LargeChange-Eigenschaftenwert geteilt durch 5 festgelegt. Schließlich werden die Value-Eigenschaftenwerte für beide Bildlaufleisten auf 0 festgelegt. Dadurch werden die vertikale und die horizontale Bildlaufleiste in einem Bildfeld angezeigt, in dem die obere linke Ecke von Image angezeigt wird. Sie können mit den Bildlaufleisten keinen Bildlauf über den Rand des Bildes hinaus durchführen, und bei einem LargeChange-Bildlauf verschiebt sich das Bild nur so weit, wie auch der im Bildfeld angezeigte Bereich verschoben wird. Fünf SmallChange-Bildläufe entsprechen dem Verschiebungsabstand eines LargeChange-Bildlaufs. In diesem Code wird davon ausgegangen, dass in einem Form eine PictureBox, eine HScrollBar, eine VScrollBar und ein Image erstellt wurden. Außerdem wird davon ausgegangen, dass ein Verweis auf den System.Drawing-Namespace hinzugefügt wurde. Zusätzlichen Code für die Erweiterung dieses Beispiels finden Sie in der Übersicht zur ScrollBar-Klasse.

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 für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Anzeigen:
© 2014 Microsoft