ProgressBar.Step Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Yöntemine yapılan çağrının ilerleme çubuğunun PerformStep() geçerli konumunu artırdığı miktarı alır veya ayarlar.

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

public int Step { get; set; }

member this.Step : int with get, set

Public Property Step As Integer

Özellik Değeri

Int32

yöntemine yapılan her çağrıyla ilerleme çubuğunun artırıldığı PerformStep() tutar. Varsayılan değer 10'dur.

Örnekler

Aşağıdaki kod örneği, dosya ProgressBar kopyalama işleminin ilerleme durumunu görüntülemek için bir denetim kullanır. Örnek, kopyalanacak dosya sayısına eşdeğer bir aralığı belirtmek için ProgressBar ve Maximum özelliklerini kullanırMinimum. Kod ayrıca dosyasının Step değerini ProgressBar dosya kopyalanırken artırmak için yöntemiyle özelliğini PerformStep kullanır. Bu örnek, içinde oluşturulan Formadlı pBar1 bir ProgressBar denetimin oluşturulmasını ve dosya kopyalama işlemini gerçekleştiren adlı CopyFile bir yöntemin (dosya kopyalama işleminin başarıyla tamamlandığını belirten boole değeri döndüren) olmasını gerektirir. Kod ayrıca kopyalanacak dosyaları içeren bir dize dizisinin oluşturulmasını ve örnekte tanımlanan yönteme CopyWithProgress geçirilmesini ve yönteminin içindeki başka bir yöntemden veya olaydan çağrılmayı Formgerektirir.

private:
   void CopyWithProgress( array<String^>^filenames )
   {
      // Display the ProgressBar control.
      pBar1->Visible = true;

      // Set Minimum to 1 to represent the first file being copied.
      pBar1->Minimum = 1;

      // Set Maximum to the total number of files to copy.
      pBar1->Maximum = filenames->Length;

      // Set the initial value of the ProgressBar.
      pBar1->Value = 1;

      // Set the Step property to a value of 1 to represent each file being copied.
      pBar1->Step = 1;

      // Loop through all files to copy.
      for ( int x = 1; x <= filenames->Length; x++ )
      {
         // Copy the file and increment the ProgressBar if successful.
         if ( CopyFile( filenames[ x - 1 ] ) == true )
         {
            // Perform the increment on the ProgressBar.
            pBar1->PerformStep();
         }
      }
   }

private void CopyWithProgress(string[] filenames)
{
    // Display the ProgressBar control.
    pBar1.Visible = true;
    // Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1;
    // Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length;
    // Set the initial value of the ProgressBar.
    pBar1.Value = 1;
    // Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1;
    
    // Loop through all files to copy.
    for (int x = 1; x <= filenames.Length; x++)
    {
        // Copy the file and increment the ProgressBar if successful.
        if(CopyFile(filenames[x-1]) == true)
        {
            // Perform the increment on the ProgressBar.
            pBar1.PerformStep();
        }
    }
}

Private Sub CopyWithProgress(ByVal ParamArray filenames As String())
    ' Display the ProgressBar control.
    pBar1.Visible = True
    ' Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1
    ' Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length
    ' Set the initial value of the ProgressBar.
    pBar1.Value = 1
    ' Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1

    ' Loop through all files to copy.
    Dim x As Integer
    for x = 1 To filenames.Length - 1
        ' Copy the file and increment the ProgressBar if successful.
        If CopyFile(filenames(x - 1)) = True Then
            ' Perform the increment on the ProgressBar.
            pBar1.PerformStep()
        End If
    Next x
End Sub

Açıklamalar

bir işlemdeki Step tamamlanan her görevin ilerleme çubuğunun değerini değiştireceğini belirtmek için özelliğini kullanabilirsiniz. Örneğin, bir dosya grubunu kopyaladığınızda, özelliğin Step değerini 1, özelliğinin Maximum değerini de kopyalanacak toplam dosya sayısına ayarlamak isteyebilirsiniz. Her dosya kopyalandığında, ilerleme çubuğunu özelliğinin PerformStep değerine Step göre artırmak için yöntemini çağırabilirsiniz. İlerleme çubuğunun değeri hakkında daha esnek bir denetime sahip olmak istiyorsanız yöntemini kullanabilir Increment veya özelliğin Value değerini doğrudan ayarlayabilirsiniz.

Ayrıca bkz.

• PerformStep()
• Value
• Increment(Int32)