ScrollBar.Maximum プロパティ

.NET Framework クラス ライブラリ リファレンス

ScrollBar.Maximum プロパティ

スクロール可能な範囲の上限値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property Maximum As
 Integer

Visual Basic (使用法)

Dim instance As ScrollBar
Dim value As Integer

value = instance.Maximum

instance.Maximum = value

C#

public int Maximum { get;
 set; }

C++

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

J#

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

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

JScript

public function get Maximum
 () : int

public function set Maximum
 (value : int)

プロパティ値
数値。既定値は、100 です。

解説

表示するピクセル サイズまたは行数、線数に比例してスクロール バーの親コントロールのサイズを調整する場合は、Maximum プロパティの値を動的に調整することもできます。

メモ
スクロール バーの値を、実行時にユーザーとのやり取りを通じて最大値にすることはできません。到達できる最大値は、1 に Maximum プロパティ値を加えてから LargeChange プロパティ値を引いた値と同じです。最大値にはプログラムによってしか到達できません。

使用例

派生クラス VScrollBar と HScrollBar を使用して、これらのクラスの共通プロパティの一部を設定するコード例を次に示します。これらの Maximum プロパティは、親である PictureBox に割り当てられている Image の高さおよび幅と等しくなるように設定されます。LargeChange プロパティは、ピクチャ ボックスのサイズからスクロール バーの高さまたは幅を引いたサイズに設定されます。SmallChange プロパティは、LargeChange プロパティの値を 5 で割った値に設定されます。最後に、両方のスクロール バーの Value プロパティの値が 0 に設定されます。この結果、Image の左上隅を表示するピクチャ ボックスに、垂直スクロール バーと水平スクロール バーが表示されます。スクロール バーは、イメージの範囲を越えてスクロールすることはありません。LargeChange が実行された場合、イメージは、ピクチャ ボックスに表示された領域と同じ距離だけ移動します。5 回の SmallChange スクロールで、1 回の LargeChange スクロールと同じ距離だけ移動します。このコードは、PictureBox、HScrollBar、VScrollBar、および Image が Form 上ですべて作成されていることを前提にしています。この例は、System.Drawing 名前空間への参照が追加されていることも前提にしています。この例を拡張するための追加コードについては、ScrollBar クラス概要のトピックを参照してください。

Visual Basic

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

C#

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

C++

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

J#

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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ScrollBar クラス
ScrollBar メンバ
System.Windows.Forms 名前空間
Minimum