ProgressBar.Value-Eigenschaft

Ruft die aktuelle Position der Statusanzeige ab oder legt diese fest.

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

Syntax

'Declaration
<BindableAttribute(True)> _
Public Property Value As Integer
'Usage
Dim instance As ProgressBar
Dim value As Integer

value = instance.Value

instance.Value = value

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

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

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

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

public function get Value () : int

public function set Value (value : int)

Eigenschaftenwert

Die Position innerhalb des Bereichs der Statusanzeige. Der Standardwert ist 0 (null).

Ausnahmen

Hinweise

Der Höchstwert und der Mindestwert der Value-Eigenschaft werden von der Minimum-Eigenschaft bzw. der Maximum-Eigenschaft angegeben. Mit dieser Eigenschaft können Sie den Wert der Statusanzeige direkt erhöhen oder verringern. Um den Wert des ProgressBar-Steuerelements gleichmäßig zu erhöhen, können Sie die Step-Eigenschaft mit der PerformStep-Methode verwenden. Um den Wert der Statusanzeige um unterschiedliche Werte zu erhöhen, verwenden Sie die Increment-Methode.

Beispiel

Das folgende Codebeispiel veranschaulicht, wie Sie mit der Increment-Methode und der Value-Eigenschaft den Wert einer ProgressBar im Tick-Ereignis von Timer schrittweise erhöhen können. Im Beispiel wird auch die Value-Eigenschaft in einem StatusBarPanel angezeigt, um eine Textdarstellung der ProgressBar bereitzustellen. Für dieses Beispiel ist es erforderlich, dass ein ProgressBar-Steuerelement mit dem Namen progressBar1 sowie ein StatusBar-Steuerelement mit einem StatusBarPanel und dem Namen statusBarPanel1 vorhanden sind. Der Timer mit dem Namen time muss dem Formular als Member hinzugefügt werden.

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

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

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.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

ProgressBar-Klasse
ProgressBar-Member
System.Windows.Forms-Namespace
ProgressBar.Maximum-Eigenschaft
ProgressBar.Minimum-Eigenschaft