Общие сведения об элементе управления ProgressBar (Windows Forms)
Важно!
Элемент управления ToolStripProgressBar заменяет элемент управления ProgressBar и расширяет его функциональные возможности; однако при необходимости элемент управления ProgressBar можно сохранить для обратной совместимости и использования в будущем.
Элемент управления форм Windows Forms ProgressBar показывает, на какой стадии находится выполняемый процесс, что выражается в соответствующем числе прямоугольников, расположенных на горизонтальной шкале. Завершение процесса характеризуется заполненной шкалой. Индикаторы выполнения обычно используются, чтобы показать пользователю время, оставшееся до завершения процесса, например при загрузке большого файла.
Примечание
Элемент управления ProgressBar может быть ориентирован в форме только горизонтально.
Ключевые свойства и методы
Ключевыми свойствами элемента управления ProgressBar являются Value, Minimum и Maximum. Свойства Minimum и Maximum задают минимальное и максимальное значения, отображаемые на индикаторе выполнения. Свойство Value представляет объем выполненной работы для завершения операции. Поскольку полоска, отображаемая в этом элементе управления, состоит из блоков, значение, отображаемое в ProgressBar, представляет только приблизительное текущее значение свойства Value. Свойство Value определяет момент отображения следующего блока исходя из размера ProgressBar.
Наиболее распространенным способом обновления текущего значения выполнения является запись кода, задающего свойство Value. Например, при загрузке большого файла можно задать в качестве максимального значения размер файла в килобайтах. Так, если для свойства Maximum задано значение 100, для свойства Minimum — значение 10, а для свойства Value — значение 50, на шкале отобразятся 5 прямоугольников. Это составляет половину числа, которое может быть отображено.
Однако помимо непосредственного задания свойства Value существуют другие способы изменить значение, отображаемое в элементе управления ProgressBar. Можно использовать свойство Step для указания значения шага изменения свойства Value. При этом значение будет изменяться при вызове метода PerformStep. Для изменения значения приращения можно использовать метод Increment и задать значение, которое будет использовать для приращения свойства Value.
Другим элементом управления для графического представления пользователю сведений о текущем действии является элемент управления StatusBar.
Важно!
Элементы управления StatusStrip и ToolStripStatusLabel заменяют элементы управления StatusBar и StatusBarPanel и расширяют их функциональные возможности; однако при необходимости элементы управления StatusBar и StatusBarPanel можно сохранить для обратной совместимости и использования в будущем.