Функция КОМАНДА_ИНДИКАТОРА
Функция КОМАНДА_ИНДИКАТОРА позволяет управлять пользовательскими индикаторами.
ФУНКЦИЯ КОМАНДА_ИНДИКАТОРА(ТИП_СТРОКА: команда, имя [; ТИП_СПИСОК: парам ])
Параметры
- команда
- Определяет действие с индикатором. Допускаются следующие команды:
- "CREATE" – создание индикатора;
- "UPDATE" – обновление существующего индикатора;
- "DESTROY" – удаление существующего индикатора.
- имя
- Имя индикатора.
- парам
- Список параметров в формате "имя = значение". Для команд "CREATE" и "UPDATE" описание параметров приведено в таблице ниже. Для команды "DESTROY" параметры не используются.
Типы индикаторов
Программа поддерживает 3 пользовательских индикатора: 2 в строке состояния и 1 в панели инструментов. Т.к. индикаторы в строке состояния и в панели инструментов имеют весьма различную реализацию, то набор параметров, отвечающих за внешний вид, также различается. Для указания типа при создании индикатора используется параметр "kind", который может принимать следующие значения:
- ToolBar – индикатор в панели инструментов;
- StatusBar1 – первый индикатор в строке состояния;
- StatusBar2 – второй индикатор в строке состояния.
Поддерживаемые параметры
| Имя | Описание | Панель инструментов |
Строка состояния |
Комментарий |
|---|---|---|---|---|
| kind | Тип индикатора | Да | Да | Определяет тип индикатора. Обязательный параметр при создании индикатора. |
| period | Период обновления | Да | Да | Задает период обновления индикатора в миллисекундах. С указанным периодом генерируется событие "Обновление индикатора". Если указан 0 (по умолчанию), то обновление по таймеру не выполняется. |
| width | Ширина | Нет | Да | Задает ширину индикатора в строке состояния в символах. При указании параметра "stretch" интерпретируется как минимальная ширина. |
| stretch | Растягивание | Нет | Да | Ширина индикатора в строке состояния определяется длиной текста, но не менее, чем указано в параметре "width". |
| alignment | Выравнивание | Да | Нет | Определяет выравнивание текста для индикатора в панели инструментов: "Left" - по левому краю, "Center" - по центру, "Right" - по правому краю. |
| text | Текст | Да | Да | Текст, отображаемый в индикаторе. |
| color | Цвет текста | Да | Нет | Определяет цвет текста для индикатора в панели инструментов. По умолчанию цвет - черный. Цвет задается в формате "R,G,B". Например, "255,0,0" для ярко-красного цвета. |
| font | Шрифт | Да | Нет | Определяет шрифт текста для индикатора в панели инструментов. По умолчанию используется шрифт, настроенный для строки состояния. Шрифт задается в формате "Имя, Размер, Стили, Кодировка". Любой из параметров может быть пропущен. Например, ",12,,204" задает размер 12 и русскую кодировку (204), но оставляет имя шрифта и стили по умолчанию. В стилях может указываться жирный шрифт "Ж" и наклонный шрифт "Н". Стиль "ЖН" обозначает жирный наклонный шрифт. Пример 1: "Arial, 12, ЖН, 204". Пример 2: "Times New Roman, 14". |
Пример создания индикатора
СОЗДАТЬ(сп, ТИП_СПИСОК)
сп.ДОБАВИТЬ("kind=ToolBar")
сп.ДОБАВИТЬ("period=1000")
сп.ДОБАВИТЬ("alignment=Right")
сп.ДОБАВИТЬ("color=255,0,0")
сп.ДОБАВИТЬ("font=Times New Roman, 14")
КОМАНДА_ИНДИКАТОРА("CREATE", "Часы", сп)
Пример обновления индикатора
СОЗДАТЬ(сп, ТИП_СПИСОК)
сп.ДОБАВИТЬ("text=" + СТР(ВРЕМЯ_ТЕК))
КОМАНДА_ИНДИКАТОРА("UPDATE", "Часы", сп)
Пример удаления индикатора
КОМАНДА_ИНДИКАТОРА("DESTROY", "Часы")