Sdílet prostřednictvím

Přehled ovládacího prvku ProgressBar (Windows Forms)

Důležité

Ovládací prvek ToolStripProgressBar nahrazuje a přidává funkce do ovládacího prvku ProgressBar; ovládací prvek ProgressBar je však zachován pro zpětnou kompatibilitu i budoucí použití, pokud zvolíte.

Ovládací prvek Windows Forms ProgressBar označuje průběh procesu zobrazením odpovídajícího počtu obdélníků uspořádaných do vodorovného pruhu. Po dokončení procesu se pruh vyplní. Indikátory průběhu se běžně používají k tomu, aby uživatel získal představu o tom, jak dlouho čekat na dokončení procesu; Například při načítání velkého souboru.

Poznámka:

Ovládací prvek ProgressBar lze vodorovně orientovat pouze ve formuláři.

Klíčové vlastnosti a metody

Klíčové vlastnosti ovládacího prvku ProgressBar jsou Value, Minimuma Maximum. Vlastnosti Minimum a Maximum nastaví maximální a minimální hodnoty, které může indikátor průběhu zobrazit. Vlastnost Value představuje pokrok, který byl učiněn směrem k dokončení operace. Vzhledem k tomu, že se pruh zobrazený v ovládacím prvku skládá z bloků, hodnota zobrazená ovládacím prvku ProgressBar pouze přibližuje aktuální hodnotu vlastnosti Value. Na základě velikosti ovládacího prvku ProgressBar určuje vlastnost Value, kdy se má zobrazit další blok.

Nejběžnější způsob, jak aktualizovat aktuální hodnotu průběhu, je napsat kód pro nastavení vlastnosti Value. V příkladu načtení velkého souboru můžete nastavit maximální velikost souboru v kilobajtech. Pokud je například vlastnost Maximum nastavena na 100, Minimum vlastnost je nastavena na 10 a vlastnost Value je nastavena na 50, zobrazí se 5 obdélníků. Jedná se o polovinu čísla, které se dá zobrazit.

Existují však další způsoby, jak upravit hodnotu zobrazenou ovládacím prvku ProgressBar, a to kromě nastavení vlastnosti Value přímo. Vlastnost Step lze použít k určení hodnoty, kterou se zvýší vlastnost Value. Potom volání PerformStep metoda zvýší hodnotu. Pokud chcete zvýšit hodnotu, můžete použít Increment metodu a zadat hodnotu, pomocí které chcete zvýšit Value vlastnost.

Dalším ovládacím prvek, který graficky informuje uživatele o aktuální akci, je StatusBar ovládací prvek.

Důležité

Ovládací prvky StatusStrip a ToolStripStatusLabel nahrazují a přidávají funkce do ovládacích prvků StatusBar a StatusBarPanel; ovládací prvky StatusBar a StatusBarPanel se však zachovají pro zpětnou kompatibilitu i budoucí použití, pokud zvolíte.

Viz také

  • Last updated on