ProgressBar.Minimum Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví minimální hodnotu rozsahu ovládacího prvku.
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
Hodnota vlastnosti
Minimální hodnota rozsahu. Výchozí hodnota je 0.
Výjimky
Hodnota zadaná pro vlastnost je menší než 0.
Příklady
Následující příklad kódu používá ProgressBar ovládací prvek k zobrazení průběhu operace kopírování souboru. V příkladu se Minimum používají vlastnosti a Maximum určuje rozsah, ProgressBar který odpovídá počtu souborů, které se mají zkopírovat. Kód také používá Step vlastnost s metodou PerformStep zvýšit hodnotu ProgressBar jako soubor je zkopírován. Tento příklad vyžaduje, ProgressBar abyste měli vytvořený ovládací prvek, který je vytvořen pBar1
v rámci objektu Form, a že existuje metoda vytvořená CopyFile
(která vrací logickou hodnotu označující, že operace kopírování souboru byla úspěšně dokončena), která provádí operaci kopírování souboru. Kód také vyžaduje, aby byla vytvořena pole řetězců obsahujících soubory ke kopírování a předáno CopyWithProgress
metodě definované v příkladu a že metoda je volána z jiné metody nebo události v .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
Poznámky
Tato vlastnost určuje dolní limit Value vlastnosti. Při změně hodnoty Minimum vlastnosti je ovládací prvek překreslen tak, ProgressBar aby odrážel nový rozsah ovládacího prvku. Pokud je hodnota Value vlastnosti rovna hodnotě Minimum vlastnosti, indikátor průběhu je prázdný. Chcete-li změnit hodnotu indikátoru průběhu, použijte Step vlastnost s metodou PerformStep , použijte metodu Increment nebo nastavte hodnotu Value vlastnosti přímo.