ScrollBar.Maximum-Eigenschaft

Artikel
08/20/2007

Ruft die Obergrenze für Werte des bildlauffähigen Bereichs ab oder legt diese fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property Maximum As Integer
'Usage
Dim instance As ScrollBar
Dim value As Integer

value = instance.Maximum

instance.Maximum = value

public int Maximum { get; set; }

public:
property int Maximum {
    int get ();
    void set (int value);
}

/** @property */
public int get_Maximum ()

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

public function get Maximum () : int

public function set Maximum (value : int)

Eigenschaftenwert

Ein numerischer Wert. Der Standardwert ist 100.

Hinweise

Sie können die Maximum-Eigenschaft auch dynamisch anpassen, um die Größe des übergeordneten Elements der Bildlaufleiste proportional an die Größe in Pixel bzw. an die Anzahl der angezeigten Zeilen anzugleichen.

Hinweis

Der Wert einer Bildlaufleiste kann durch einen Benutzervorgang während der Laufzeit nicht seinen größtmöglichen Wert erreichen. Der maximale Wert, der erreicht werden kann, entspricht 1 plus dem Maximum-Eigenschaftswert minus dem LargeChange-Eigenschaftswert. Der maximale Wert kann nur programmgesteuert erreicht werden.

Beispiel

Im folgenden Codebeispiel werden die abgeleitete VScrollBar-Klasse und HScrollBar-Klasse verwendet und einige ihrer allgemeinen Eigenschaften festgelegt. Die Maximum-Eigenschaften werden entsprechend der Höhe oder Breite 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 Sub SetScrollBarValues()
   ' Set the Maximum, Minimum, LargeChange and SmallChange properties.
   Me.vScrollBar1.Minimum = 0
   Me.hScrollBar1.Minimum = 0
   
   ' If the offset does not make the Maximum less than zero, set its value.
   If Me.pictureBox1.Image.Size.Width - pictureBox1.ClientSize.Width > 0 Then
      Me.hScrollBar1.Maximum = Me.pictureBox1.Image.Size.Width - _
        pictureBox1.ClientSize.Width
   End If
   ' If the VScrollBar is visible, adjust the Maximum of the 
   ' HSCrollBar to account for the width of the VScrollBar.
   If Me.vScrollBar1.Visible Then
      Me.hScrollBar1.Maximum += Me.vScrollBar1.Width
   End If
   Me.hScrollBar1.LargeChange = Me.hScrollBar1.Maximum / 10
   Me.hScrollBar1.SmallChange = Me.hScrollBar1.Maximum / 20
   ' Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   Me.hScrollBar1.Maximum += Me.hScrollBar1.LargeChange
         
   ' If the offset does not make the Maximum less than zero, set its value.
   If Me.pictureBox1.Image.Size.Height - pictureBox1.ClientSize.Height > 0 Then
      Me.vScrollBar1.Maximum = Me.pictureBox1.Image.Size.Height - _
        pictureBox1.ClientSize.Height
   End If
   ' If the HScrollBar is visible, adjust the Maximum of the 
   ' VSCrollBar to account for the width of the HScrollBar.
   If Me.hScrollBar1.Visible Then
      Me.vScrollBar1.Maximum += Me.hScrollBar1.Height
   End If
   Me.vScrollBar1.LargeChange = Me.vScrollBar1.Maximum / 10
   Me.vScrollBar1.SmallChange = Me.vScrollBar1.Maximum / 20
   ' Adjust the Maximum value to make the raw Maximum value attainable by user interaction.
   Me.vScrollBar1.Maximum += Me.vScrollBar1.LargeChange
End Sub

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;
}

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

Plattformen

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.

Freigeben über

ScrollBar.Maximum-Eigenschaft

Syntax

Eigenschaftenwert

Hinweise

Beispiel

Plattformen

Versionsinformationen

.NET Framework

.NET Compact Framework

Siehe auch

Referenz

Zusätzliche Ressourcen