ProgressBar.Value プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ProgressBar.Value プロパティ

プログレスバーの現在位置を取得または設定します。

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

Visual Basic (宣言)

<BindableAttribute(True)> _
Public Property Value As
 Integer

Visual Basic (使用法)

Dim instance As ProgressBar
Dim value As Integer

value = instance.Value

instance.Value = value

[BindableAttribute(true)] 
public int Value { get;
 set; }

C++

[BindableAttribute(true)] 
public:
property int Value {
    int get ();
    void set (int value);
}

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

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

JScript

public function get Value
 () : int

public function set Value
 (value : int)

プロパティ値
プログレスバーの範囲内の位置。既定値は 0 です。

例外

例外の種類	条件
ArgumentException	指定された値が Maximum プロパティの値を超えます。または指定された値が Minimum プロパティの値未満です。

例外の種類

条件

ArgumentException

指定された値が Maximum プロパティの値を超えます。

または

指定された値が Minimum プロパティの値未満です。

解説

Value プロパティの最小値および最大値は、Minimum プロパティおよび Maximum プロパティで指定します。このプロパティを使用すると、プログレスバーの値を直接インクリメントまたはデクリメントできます。ProgressBar コントロールの値を一定の量ずつ増やすには、PerformStep メソッドで Step プロパティを使用します。プログレスバーの値を増分量を変化させて増やすには、Increment メソッドを使用します。

使用例

Increment メソッドと Value プロパティを使用して、Timer の Tick イベントで ProgressBar の値をインクリメントするコード例を次に示します。またこの例では、StatusBarPanel に Value プロパティを表示して、ProgressBar をテキストで表します。この例では、progressBar1 という名前の ProgressBar コントロール、および statusBarPanel1 という名前の StatusBarPanel が配置された StatusBar コントロールが存在する必要があります。また、time という名前の Timer を、メンバとしてフォームに追加する必要があります。

Visual Basic

Private time As New Timer()

' Call this method from the constructor of the form.
Private Sub InitializeMyTimer()
   ' Set the interval for the timer.
   time.Interval = 250
   ' Connect the Tick event of the timer to its event handler.
   AddHandler time.Tick, AddressOf IncreaseProgressBar
   ' Start the timer.
   time.Start()
End Sub


Private Sub IncreaseProgressBar(ByVal
 sender As Object, ByVal
 e As EventArgs)
   ' Increment the value of the ProgressBar a value of one each time.
   ProgressBar1.Increment(1)
   ' Display the textual value of the ProgressBar in the StatusBar control's
 first panel.
   statusBarPanel1.Text = ProgressBar1.Value.ToString() + "% Completed"
   ' Determine if we have completed by comparing the value of the Value
 property to the Maximum value.
   If ProgressBar1.Value = ProgressBar1.Maximum Then
      ' Stop the timer.
      time.Stop()
   End If
End Sub

private Timer time = new Timer();

// Call this method from the constructor of the form.
private void InitializeMyTimer()
{
   // Set the interval for the timer.
   time.Interval = 250;
   // Connect the Tick event of the timer to its event handler.
   time.Tick += new EventHandler(IncreaseProgressBar);
   // Start the timer.
   time.Start();
}

private void IncreaseProgressBar(object sender,
 EventArgs e)
{
   // Increment the value of the ProgressBar a value of one each time.
   progressBar1.Increment(1);
   // Display the textual value of the ProgressBar in the StatusBar
 control's first panel.
   statusBarPanel1.Text = progressBar1.Value.ToString() + "% Completed";
   // Determine if we have completed by comparing the value of the Value
 property to the Maximum value.
   if (progressBar1.Value == progressBar1.Maximum)
      // Stop the timer.
      time.Stop();
}

C++

private:
   Timer^ time;

   // Call this method from the constructor of the form.
   void InitializeMyTimer()
   {
      // Set the interval for the timer.
      time->Interval = 250;

      // Connect the Tick event of the timer to its event handler.
      time->Tick += gcnew EventHandler( this, &Form1::IncreaseProgressBar
 );

      // Start the timer.
      time->Start();
   }

   void IncreaseProgressBar( Object^ /*sender*/, EventArgs^ /*e*/
 )
   {
      // Increment the value of the ProgressBar a value of one each
 time.
      progressBar1->Increment( 1 );

      // Display the textual value of the ProgressBar in the StatusBar
 control's first panel.
      statusBarPanel1->Text = String::Concat( progressBar1->Value, "%
 Completed" );

      // Determine if we have completed by comparing the value of the Value
 property to the Maximum value.
      if ( progressBar1->Value == progressBar1->Maximum
 )

      // Stop the timer.
      time->Stop();
   }

private Timer time = new Timer();

// Call this method from the constructor of the form.
private void InitializeMyTimer()
{
    // Set the interval for the timer.
    time.set_Interval(250);
    // Connect the Tick event of the timer to its event handler.
    time.add_Tick(new EventHandler(IncreaseProgressBar));
    // Start the timer.
    time.Start();
} //InitializeMyTimer

private void IncreaseProgressBar(Object sender,
 EventArgs e)
{
    // Increment the value of the ProgressBar a value of one each time.
    progressBar1.Increment(1);
    // Display the textual value of the ProgressBar in the StatusBar
    // control's first panel.
    statusBarPanel1.set_Text(progressBar1.get_Value() + "% Completed");
    // Determine if we have completed by comparing the value of the
 Value
    // property to the Maximum value.
    if (progressBar1.get_Value() == progressBar1.get_Maximum())
 {
        // Stop the timer.
        time.Stop();
    }        
} //IncreaseProgressBar