Поделиться через

Обзор элемента управления ProgressBar (Windows Forms)

  • Статья

Важный

Элемент управления ToolStripProgressBar заменяет и добавляет функции в элемент управления ProgressBar; однако элемент управления ProgressBar сохраняется как для обратной совместимости, так и для дальнейшего использования, если вы выберете.

Элемент управления Windows Forms ProgressBar указывает ход выполнения процесса, отображая соответствующее количество прямоугольников, расположенных на горизонтальной панели. Когда процесс будет завершён, полоса будет заполнена. Индикаторы хода выполнения обычно используются для предоставления пользователю представления о том, как долго ждать завершения процесса; например, при загрузке большого файла.

Заметка

Элемент управления ProgressBar может быть ориентирован на форме исключительно горизонтально.

Ключевые свойства и методы

Ключевыми свойствами элемента управления ProgressBar являются Value, Minimumи Maximum. Свойства Minimum и Maximum задают максимальное и минимальное значения, отображаемые индикатором выполнения. Свойство Value отражает прогресс, достигнутый на пути к завершению операции. Так как панель, отображаемая в элементе управления, состоит из блоков, значение, отображаемое элементом управления ProgressBar, только приблизительно соответствует значению свойства Value в настоящее время. На основе размера элемента управления ProgressBar свойство Value определяет, когда будет отображаться следующий блок.

Наиболее распространенным способом обновления текущего значения хода выполнения является написание кода для задания свойства Value. В примере загрузки большого файла можно задать максимальный размер файла в килобайтах. Например, если для свойства Maximum задано значение 100, то для свойства Minimum задано значение 10, а для свойства Value задано значение 50, 5 прямоугольников будут отображаться. Это половина отображаемого числа.

Однако существуют и другие способы изменения значения, отображаемого элементом управления ProgressBar, помимо настройки свойства Value напрямую. Свойство Step можно использовать для указания значения для увеличения свойства Value. Затем вызов метода PerformStep добавит значение. Чтобы изменить значение добавочного значения, можно использовать метод Increment и указать значение, с помощью которого необходимо увеличить свойство Value.

Другой элемент управления, который графически сообщает пользователю о текущем действии, является элементом управления StatusBar.

Важный

Элементы управления StatusStrip и ToolStripStatusLabel заменяют и добавляют функциональные возможности в элементы управления StatusBar и StatusBarPanel; однако элементы управления StatusBar и StatusBarPanel сохраняются как для обратной совместимости, так и для дальнейшего использования, если вы выбрали.

См. также