Form.UpdateProgress - Revision history

Admin: 1 revision imported

2023-06-08T10:11:33Z

1 revision imported

1>Admin at 19:20, 1 May 2023

2023-05-01T19:20:19Z

Admin: 1 revision imported

2021-02-07T06:50:59Z

1 revision imported

Admin: /* Примеры */

2020-06-10T16:51:33Z

‎Примеры

New page

{{infobox function
|name=UpdateProgress
|object=[[Форма]]
|caption=Оповещение пользователя
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=1}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Форма]]}}
Функция изменяет текст и рисунок статуса выполнения, выводимый на текущей кнопке панели задач формы, а также во всплывающей подсказке при наведении курсора мыши на эту кнопку. Статус выполнения выводится для каждого окна отдельно. Текущий прогресс не может быть равен нулю, при передаче аргумента, равного ''-1'', процесс не будет выводиться в виде процента выполнения (режим неопределенного прогресса). Кроме рисунка процента выполнения, можно также указать текст для задания этапа выполнения. Рисование статуса выполнения автоматически останавливается, когда текущая программа завершает работу (переходит в режим ожидания ввода пользователя). Функция может использоваться до инициализации формы.

== Синтаксис ==
<code>
{{Grey|Form.}}'''UpdateProgress'''(''<Текущий прогресс выполнения (INT)>''{{Optional|,<Максимальный прогресс выполнения (STRING)>,<Текущий текст выполнения (STRING)>}})
</code>

==== Аргументы ====
* <code>''<Текущий прогресс выполнения (INT)>''</code> - Задает число -- текущий прогресс, число должно быть меньше или равно максимальному значению прогресса. Если число равно -1, текущий прогресс не определен, иначе он будет выведен в виде процента и индикатора выполнения.
* <code>''<Максимальный прогресс выполнения (STRING)>''</code> - {{Optional}} Задает число -- максимальный прогресс. Аргумент должен быть задан при каждом вызове функции, если максимальный прогресс необходим.
* <code>''<Текущий текст выполнения (STRING)>''</code> - {{Optional}} Задает дополнительный текст, который выводится в подсказке совместно с индикатором выполнения.

== Примеры ==
<pre>
//З -- запрос, пример показывает возможное применение функции UpdateProgress
While З.Next(1) Do
Form.StatusText(Str(Round(З.ResultTable.CurLine/З.ResultTable.Size()*100,2))+"%");
Form.UpdateProgress(З.ResultTable.CurLine,З.ResultTable.Size(),"Обновление цен...");

...
EndDo
Form.StopProgress();
</pre>

← Older revision	Revision as of 10:11, 8 June 2023
(No difference)

@@ Line 17: / Line 17: @@
 == Синтаксис ==
 <code>
-{{Grey|Form.}}'''UpdateProgress'''(''<Текущий прогресс выполнения (INT)>''{{Optional|,<Максимальный прогресс выполнения (STRING)>,<Текущий текст выполнения (STRING)>}})
+{{Grey|Form.}}'''UpdateProgress'''(''<Текущий прогресс выполнения (INT)>''{{Optional|,<Максимальный прогресс выполнения (INT)>,<Текущий текст выполнения (STRING)>}})
 </code>
 ==== Аргументы ====
 * <code>''<Текущий прогресс выполнения (INT)>''</code> - Задает число -- текущий прогресс, число должно быть меньше или равно максимальному значению прогресса. Если число равно -1, текущий прогресс не определен, иначе он будет выведен в виде процента и индикатора выполнения.
-* <code>''<Максимальный прогресс выполнения (STRING)>''</code> - {{Optional}} Задает число -- максимальный прогресс. Аргумент должен быть задан при каждом вызове функции, если максимальный прогресс необходим.
+* <code>''<Максимальный прогресс выполнения (INT)>''</code> - {{Optional}} Задает число -- максимальный прогресс. Аргумент должен быть задан при каждом вызове функции, если максимальный прогресс необходим.
 * <code>''<Текущий текст выполнения (STRING)>''</code> - {{Optional}} Задает дополнительный текст, который выводится в подсказке совместно с индикатором выполнения.

← Older revision	Revision as of 06:50, 7 February 2021
(No difference)