ProgressBar.Minimum Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta il valore minimo dell'intervallo del controllo.
public:
property int Minimum { int get(); void set(int value); };
public int Minimum { get; set; }
member this.Minimum : int with get, set
Public Property Minimum As Integer
Valore della proprietà
Valore minimo dell'intervallo. Il valore predefinito è 0.
Eccezioni
Il valore specificato per la proprietà è minore di 0.
Esempio
Nell'esempio di codice seguente viene usato un controllo per visualizzare lo stato di avanzamento di un'operazione ProgressBar di copia file. Nell'esempio ProgressBar vengono usate le Minimum proprietà e Maximum per specificare un intervallo equivalente al numero di file da copiare. Il codice usa anche la Step proprietà con il PerformStep metodo per incrementare il valore di ProgressBar come file viene copiato. In questo esempio è necessario che sia stato creato un controllo denominato pBar1
creato all'interno di un Formoggetto e che sia stato creato un metodo denominato CopyFile
(che restituisce un ProgressBar valore booleano che indica che l'operazione di copia file è stata completata correttamente) che esegue l'operazione di copia file. Il codice richiede inoltre che una matrice di stringhe contenenti 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 nell'oggetto 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
Questa proprietà specifica il limite inferiore della Value proprietà. Quando il valore della Minimum proprietà viene modificato, il ProgressBar controllo viene ridisegnato per riflettere il nuovo intervallo del controllo. Quando il valore della proprietà è uguale al valore della proprietà, la barra di Value Minimum stato è vuota. Per modificare il valore della barra di stato, usare la Step proprietà con PerformStep il metodo, usare il metodo o impostare direttamente il Increment valore della Value proprietà.