ProgressBar.PerformStep ProgressBar.PerformStep ProgressBar.PerformStep ProgressBar.PerformStep Method

Definizione

Sposta in avanti la posizione corrente dell'indicatore di stato in base al valore della proprietà Step.Advances the current position of the progress bar by the amount of the Step property.

public:
 void PerformStep();
public void PerformStep ();
member this.PerformStep : unit -> unit
Public Sub PerformStep ()

Eccezioni

Esempi

Nell'esempio di codice seguente viene ProgressBar usato un controllo per visualizzare lo stato di avanzamento di un'operazione di copia file.The following code example uses a ProgressBar control to display the progress of a file copy operation. Nell'esempio vengono utilizzate Minimum le Maximum proprietà e per specificare un intervallo per ProgressBar l'equivalente al numero di file da copiare.The example uses the Minimum and Maximum properties to specify a range for the ProgressBar that is equivalent to the number of files to copy. Il codice usa anche la Step proprietà con il PerformStep metodo per ProgressBar incrementare il valore di durante la copia di un file.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. Questo esempio richiede che sia stato creato ProgressBar un controllo denominato pBar1 creato all'interno di un Formoggetto e che sia stato creato un metodo denominato CopyFile (che restituisce un valore booleano che indica che l'operazione di copia del file è stata completato correttamente) che esegue l'operazione di copia del file.This example requires that you have a ProgressBar control created called pBar1 that is created within a Form, and that there is a method created called CopyFile (that returns a Boolean value indicating the file copy operation was completed successfully) that performs the file copy operation. Il codice richiede inoltre che una matrice di stringhe contenente i file da copiare venga creata e passata al CopyWithProgress metodo definito nell'esempio e che il metodo venga chiamato da un altro metodo o evento Formin.The code also requires that an array of strings containing the files to copy is created and passed to the CopyWithProgress method defined in the example, and that the method is called from another method or event in the Form.

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

Commenti

Il PerformStep metodo incrementa il valore dell'indicatore di stato in base alla quantità specificata Step dalla proprietà.The PerformStep method increments the value of the progress bar by the amount specified by the Step property. È possibile usare la Step proprietà per specificare la quantità di tempo per cui ogni attività completata in un'operazione modifica il valore dell'indicatore di stato.You can use the Step property to specify the amount that each completed task in an operation changes the value of the progress bar. Se ad esempio si copia un gruppo di file, potrebbe essere necessario impostare il valore della Step proprietà su 1 e il valore Maximum della proprietà sul numero totale di file da copiare.For example, if you are copying a group of files, you might want to set the value of the Step property to 1 and the value of the Maximum property to the total number of files to copy. Quando ogni file viene copiato, è possibile chiamare il PerformStep metodo per incrementare l'indicatore di stato in base al Step valore della proprietà.When each file is copied, you can call the PerformStep method to increment the progress bar by the value of the Step property. Se si desidera un controllo più flessibile del valore dell'indicatore di stato, è possibile utilizzare il Increment metodo o impostare direttamente il valore Value della proprietà.If you want to have more flexible control of the value of the progress bar, you can use the Increment method or set the value of the Value property directly.

La Value proprietà specifica la posizione corrente dell'oggetto ProgressBar.The Value property specifies the current position of the ProgressBar. Se, dopo aver chiamato PerformStep il metodo, Value la proprietà è maggiore del valore della Maximum proprietà, Maximum la Value proprietà rimane in corrispondenza del valore della proprietà.If, after calling the PerformStep method, the Value property is greater than the value of the Maximum property, the Value property remains at the value of the Maximum property. Se, dopo aver chiamato PerformStep il metodo con un valore negativo specificato Stepin, Value la Minimum proprietà è minore del valore della proprietà, la Value proprietà rimane in corrispondenza del valore della Minimum proprietà. .If, after calling the PerformStep method with a negative value specified in Step, the Value property is less than the value of the Minimum property, the Value property remains at the value of the Minimum property.

Poiché un ProgressBar oggetto il cui stile è impostato in modo da visualizzare una barra di scorrimento continua Valueanziché il PerformStep relativo, la chiamata a Marquee non InvalidOperationExceptionè necessaria e genererà un.Because a ProgressBar object whose style is set to Marquee displays a continuously scrolling bar instead of its Value, calling PerformStep is unnecessary and will raise an InvalidOperationException.

Si applica a

Vedi anche