Difference between revisions of "Form.UpdateProgress"
(→Примеры) |
m (1 revision imported) |
(No difference)
|
Revision as of 08:50, 7 February 2021
UpdateProgress (Оповещение пользователя) | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Функция изменяет текст и рисунок статуса выполнения, выводимый на текущей кнопке панели задач формы, а также во всплывающей подсказке при наведении курсора мыши на эту кнопку. Статус выполнения выводится для каждого окна отдельно. Текущий прогресс не может быть равен нулю, при передаче аргумента, равного -1, процесс не будет выводиться в виде процента выполнения (режим неопределенного прогресса). Кроме рисунка процента выполнения, можно также указать текст для задания этапа выполнения. Рисование статуса выполнения автоматически останавливается, когда текущая программа завершает работу (переходит в режим ожидания ввода пользователя). Функция может использоваться до инициализации формы.
Синтаксис
Form.UpdateProgress(<Текущий прогресс выполнения (INT)>,<Максимальный прогресс выполнения (STRING)>,<Текущий текст выполнения (STRING)>)
Аргументы
<Текущий прогресс выполнения (INT)>
- Задает число -- текущий прогресс, число должно быть меньше или равно максимальному значению прогресса. Если число равно -1, текущий прогресс не определен, иначе он будет выведен в виде процента и индикатора выполнения.<Максимальный прогресс выполнения (STRING)>
- (необязательный аргумент) Задает число -- максимальный прогресс. Аргумент должен быть задан при каждом вызове функции, если максимальный прогресс необходим.<Текущий текст выполнения (STRING)>
- (необязательный аргумент) Задает дополнительный текст, который выводится в подсказке совместно с индикатором выполнения.
Примеры
//З -- запрос, пример показывает возможное применение функции UpdateProgress While З.Next(1) Do Form.StatusText(Str(Round(З.ResultTable.CurLine/З.ResultTable.Size()*100,2))+"%"); Form.UpdateProgress(З.ResultTable.CurLine,З.ResultTable.Size(),"Обновление цен..."); ... EndDo Form.StopProgress();