Udostępnij za pośrednictwem

ProgressBar — Informacje o formancie [Formularze systemu Windows]

  • Artykuł

Ważne

Kontrolka ToolStripProgressBar zastępuje i dodaje funkcje do ProgressBar kontrolki, jednak kontrolka ProgressBar jest zachowywana zarówno w celu zapewnienia zgodności z poprzednimi wersjami, jak 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

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ł wykonany w celu ukończenia operacji. Ponieważ pasek wyświetlany w kontrolce składa się z bloków, wartość wyświetlana przez ProgressBar kontrolkę przybliża Value tylko bieżącą wartość właściwości. Na podstawie rozmiaru kontrolki ProgressBar właściwość określa, Value kiedy ma być wyświetlany następny blok.

Najczęstszym sposobem aktualizowania bieżącej wartości postępu jest napisanie kodu w celu ustawienia Value właściwości. 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, aby zwiększać Value właściwość według. 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 StatusBar kontrolek i StatusBarPanel , StatusBar jednak kontrolki i StatusBarPanel są zachowywane zarówno w celu zachowania zgodności z poprzednimi wersjami, jak i użycia w przyszłości, jeśli wybierzesz.

Zobacz też