Udostępnij przez


ProgressBar — Przegląd kontrolki (Formularze systemu Windows)

Ważne

Kontrolka ToolStripProgressBar zastępuje i dodaje funkcje do kontrolki ProgressBar; jednak kontrolka ProgressBar jest zachowywana w celu zachowania zgodności z poprzednimi wersjami i użycia w przyszłości, jeśli wybierzesz.

Kontrolka Formularze ProgressBar systemu Windows wskazuje postęp procesu, wyświetlając odpowiednią liczbę prostokątów rozmieszczonych na pasku poziomym. Po zakończeniu procesu pasek zostanie wypełniony. Paski postępu są często używane do nadania użytkownikowi pojęcia, jak długo czekać na ukończenie procesu; na przykład podczas ładowania dużego pliku.

Uwaga / Notatka

Kontrolka ProgressBar może być zorientowana tylko w poziomie na formularzu.

Kluczowe właściwości i metody

Kluczowe właściwości kontrolki ProgressBar to Value, Minimumi Maximum. Właściwości Minimum i Maximum ustawiają maksymalne i minimalne wartości wyświetlane na pasku postępu. Właściwość Value reprezentuje postęp, który został osiągnięty w celu ukończenia operacji. Ponieważ pasek wyświetlany w kontrolce składa się z bloków, wartość wyświetlana przez ProgressBar kontrolkę tylko przybliża bieżącą wartość właściwości Value. Na podstawie rozmiaru kontrolki ProgressBar właściwość Value określa, kiedy ma być wyświetlany następny blok.

Najczęstszym sposobem aktualizowania bieżącej wartości postępu jest napisanie kodu, aby ustawić właściwość Value. W przykładzie ładowania dużego pliku można ustawić maksymalny rozmiar pliku w kilobajtach. Na przykład jeśli Maximum właściwość jest ustawiona na 100, Minimum właściwość jest ustawiona na 10, a Value właściwość jest ustawiona na 50, zostanie wyświetlonych 50, 5 prostokątów. Jest to połowa liczby, którą można wyświetlić.

Istnieją jednak inne sposoby modyfikowania wartości wyświetlanej przez kontrolkę ProgressBar , oprócz bezpośredniego ustawiania Value właściwości. Właściwość Step może służyć do określania wartości, o którą zwiększana jest właściwość Value. Następnie wywołanie PerformStep metody zwiększy wartość. Aby zmienić wartość przyrostu, można użyć Increment metody i określić wartość, z którą chcesz zwiększać Value właściwość.

Inną kontrolką, która graficznie informuje użytkownika o bieżącej akcji, jest kontrolka StatusBar .

Ważne

Kontrolki StatusStrip i ToolStripStatusLabel zastępują i dodają funkcje do kontrolek StatusBar i StatusBarPanel; jednak kontrolki StatusBar i StatusBarPanel są zachowywane w celu zachowania zgodności z poprzednimi wersjami i użycia w przyszłości, jeśli wybierzesz.

Zobacz także