В данном разделе описываются функции (атрибуты), используемые для различных графических объектов. В таблице приведены все графические функции, значения которых могут быть заданы или считаны с помощью функций CONTROL.
Задаваемые параметры указываются меткой «s» в столбце «Установка/Считывание» , а считываемые параметры обозначаются меткой «g». Параметры, доступные для ссылок на па нели, обозначаются меткой «R». Поэтому, запись «s (R)» говорит о том, что функция может быть задана как для графического элемента, так и для ссылки на панель (панель-ссылка).
ВНИМАНИЕ
Не допускается устанавливать два графических атрибута, которые влияют друг на друга. При необходимости последовательно выполните две команды setValue().
В столбце «Тип данных» показаны типы данных параметров каждой функции в том порядке, в котором они должны указываться в команде setValue() или getValue(). .
ПРИМЕР
Чтобы установить функцию PRIMITIVE_TEXT1 (Простой текст) в значение «Example»:
| main() { setValue(«PRIMITIVE_TEXT1», «text», «Example»); } |
или
<>.<>
| main() { PRIMITIVE_TEXT1.text(«Example»); } |
Рисунок. Простой текст
ПРИМЕР
Запрос содержимого функции «PRIMITIVE_TEXT2».
Специальное исмя формы «this» используется для указания самого графического объекта, например this.text(«TEST»); (см. выше).
Такой метод всегда предпочтительнее из-за большей наглядности представления. Тем не менее он ограничен считыванием значений функций с одним параметром, поэтому используется наряду с командами getValue() и setValue(). Отдельные исключения могут указываться непосредственно в примерах использования функций.
В таблице приведены все графические функции, значения которых могут быть заданы или считаны с помощью функций CONTROL. Задаваемые параметры указываются меткой «s» в столбце «Установка/Считывание» , а считываемые параметры обозначаются меткой «g». Функции, доступные для использования в ссылках на панели, содержат метку (R). Поэтому, запись «s (R)» говорит о том, что функция может быть задана как для графического объекта, так и для ссылки на панель.
Таблица: Функции для графических элементов
| Атрибут | Установка/Считывание | Тип данных | Допустимые значения | Комментарий |
| name | s, g | string | Имя объекта | Имя графического элемента |
| type | s, g | string | Тип объекта | Тип графического элемента. Имя может быть указано для объекта графического редактора (GEDI). |
| foreCol | s, g | string | строка данных цвета | Цвет линии (основной цвет, цвет шрифта) |
| backCol | s, g | string | строка данных цвета | Цвет заливки |
| dashBackCol | s, g | string | строка данных цвета | Только для линий штриховки (осн. цвет) |
| color | s | string | строка данных цвета | Цвет линии и заливки |
| position | s, g | int, int | Координаты x, y | соответствующая точка на панели |
| rotation | s, g | float | Градусы | Угол поворота (выводит поворот в VISION по отношению к граф. редактору GEDI!) |
| scale | s, g | float, float | Коэффициент масштабирования x, y | Масштабирование в направлении «x «и «y». Так же см. примечание под данной таблицей. |
| enabled | s (R), g | bool | TRUE (ИСТИНА) = 1 или FALSE (ЛОЖЬ) = 0. | Элемент может быть активирован (включение действия по щелчку на элементе).В случае примитивных графических объектов (ломаная линия, граница, сектор, эллипс) и кнопок, при деактивации объекта будет автоматически выключено его растровое изображение. Примечание: WMF-формат не выключается даже при деактивации объекта. Для блокировки вмешательства пользователя можно деактивировать всю панель. Будет выводиться изображение «ожидающего курсора» («WaitCursor»). Используйте команду setValue() и функцию «enabled» следующим образом: setValue(myModuleName() + «.» +myPanelName()+»:», «enabled»,»FALSE»); |
| visible | s (R), g | bool | TRUE (ИСТИНА) = 1 или FALSE (ЛОЖЬ) = 0. | Элемент отображается на экране. |
| cursor | s, g | int | Тип курсора | Тип курсора(константы Control) Примечание:Тип курсора можно установить только для виджета (кнопка, часы и т.п.), но не для простых форм (таких как прямоугольник). |
| toolTipText | s, g | string | Текст всплывающей подсказки | Текст выводится в виде всплывающей подсказки. |
| imageToClipboard | s | Копирует изображение графического объекта в буфер обмена. | ||
| imageToFile | s | string | Имя файла, например «C://Images/Trend1». | Сохраняет изображение графического объекта (снимок экрана). Изображение сохраняется в виде файла PNG. |
| refName | g | string | Имя ссылки | Возвращает информацию ссылки для формы. Показывает ссылку, с которой связана форма. |
| selected | s, g | bool | TRUE (ИСТИНА) или FALSE (ЛОЖЬ) | Состояние выборки. Параметр можно изменить только если в программе предусмотрена возможность выбора формы. Это значит, что атрибут «selectable» (возможен выбор) установлен для формы в редакторе атрибутов. Так же см. Множественный выбор во время выполнения программы |
| size | g | int, int | Высота и ширина объекта | Возвращает значения высоты и ширины объекта |
| shapeType | g | string | «PRIMITIVE_TEXT», «LINE»,»RECTANGLE»,»ELLIPSE»,»ARC»,»POLYGON»,»PUSH_BUTTON»,»TEXT_FIELD»,»CLOCK»,»SELECTION_LIST»,»RADIO_BOX»,»CHECK_BOX»,»SPIN_BUTTON»,»COMBO_BOX»,»TREND»,»TABLE»,»CASCADE_BUTTON»,»BAR_TREND»,»TAB»,»ACTIVE_X»,»FRAME»,»PIPE»,»DP_TREE»,»TEXT_EDIT»,»SLIDER»,»THUMB_WHEEL»,»PROGRESS_BAR»,»TREE»,»DPTYPE»,»LCD»,»ZOOM_NAVIGATOR»,»EMBEDDED_MODULE» (встроенный модуль)»SCHEDULER_EWO» | Возвращает строку, соответствующую типу графического объекта. |
| Bordered | ||||
| border | s, g | string | Строка данных типа линии. | Тип линии, тип границы |
| dashBackCol | s, g | string | Color string | Цвет фона штриховой линии |
| Fillable | ||||
| fill | s, g | string | Строка с данными модели заливки | Модель заливки |
| PVSSWidget | ||||
| font | s, g | langString | Font string | Шрифт |
ПРИМЕЧАНИЕ (ФУНКЦИЯ МАСШТАБИРОВАНИЯ)
С помощью функции масштабирования «scale» можно правильно изменять только полностью видимые формы. При динамическом изменении размеров дочерних панелей необходимо соблюдать правильный порядок (сначала сделайте формы меньше, затем панели).