Perfect High-capability Outstanding  Compact Universal SCADA


Конфигурируемое меню Phocus
HOME
 

 

Для конфигурации меню Phocus используется файл

/usr/Phocus/Dial/Phocus/UserMenu.dial

 

Файл состоит из секций, каждая из которых начинается со служебного слова

BUTTON и заканчивается служебным словом END_BUT, между которыми располагаются описания свойств кнопок меню. Описание свойств – служебное слово, после которого за знаком ‘=’ следует значение. После каждого такого описания должна следовать ‘;’ (точка с запятой).

 

Каждая кнопка может иметь текстовую строку и графическую пиктограмму. Для задания текстовой строки кнопки используется следующей конструкцией:

NAME=<текст>;

Существует несколько зарезервированных имен кнопок, о которых пойдет речь ниже, что накладывает ограничение на значение поля NAME, которые также будут описаны ниже.

 

Для задания графического файла пиктограммы используется конструкция

IMAGE=<полный_путь_к_графическому_файлу_пикторграммы>;

либо

IMAGE=<имя_графического_файла>;

Если графический файл располагается в директории

/usr/Phocus/Dial/Phocus/Images

Поддерживаются следующие форматы графических файлов: bmp, jpg, gif и pcx.

 

В случае, если требуется отображать и текст и изображение одновременно, можно указать взаимное расположение текста и изображения:

IMAGE_TEXT_POS=<значение>;

Где значение принимает одно из следующих значений:

Pt_BALLOON_INPLACE    - текст располагается над пиктограммой

Pt_BALLOON_LEFT           - текст располагается слева от пиктограммы

Pt_BALLOON_RIGHT         - текст располагается справа от пиктограммы

Pt_BALLOON_TOP             - текст располагается над пиктограммой

Pt_BALLOON_BOTTOM    - текст располагается под пиктограммой

В случае отсутствия служебного слова IMAGE_TEXT_POS значением по умолчанию является значение Pt_BALLOON_INPLACE

 

Кнопке можно сопоставить действие: при нажатии на кнопку либо будет открываться меню, либо будет вызываться определенная программа. Действие определяется ключевым словом FILE_DIALOG. В случае вызова диалога используется конструкция

FILE_DIALOG=DIALOG@”<имя_файла_диалога>”;

В случае вызова определенной программы надо использовать конструкцию:

FILE_DIALOG=”<имя_программы>”;

В случае определения в качестве действия диалога, файл диалога имеет стандартный формат файла диалога Phocus.

 

Можно задавать расположение кнопки на панели Phocus. X координата определяется служебным словом

X=<координата>;

координата может принимать целое неотрицательное значение или значение LEFT или RIGHT. Если указано целое неотрицательное значение, то x-координата кнопки примет это значение. Если служебное слово отсутствует или его значение равно LEFT, то кнопка расположится слева (с небольшим смещением) от предыдущей кнопки, Если указано служебное слово RIGHT, то кнопка будет добавлена в группу кнопок, которая (группа), в свою очередь, будет расположена с правого края на панели Phocus.

 

Ширина и высота кнопки, если требуется задать размер больший, чем требуется пиктограмме и/или тексту задается служебными словами

W=<ширина>;

H=<высота>;

Кнопка может быть исполнена в виде одного из двух классов виджета (т.е.  графического элемента управления): PtButton и PtLabel. Для явного задания класса виджета надо воспользоваться служебным словом

WIDGET_TYPE=<тип>;

где тип может принимать значения PtButton иди PtLabel. Если служебное слово WIDGET_TYPE отсутствует, то значением по умолчанию является PtButton.

 

Для задания флагов виджета можно использовать служебное слово

Pt_ARG_FLAGS=<значение_флагов>;

где значение_флагов – это суммарный флаг в шестнадцатеричном представлении.

 

Всплывающая подсказка, задается

BALLOON=<текст>;

 

Комментарии в файле:

Комментарий начинается с символов /* и заканчиваются символом */  .

 

В меню Phocus можно добавить следующие кнопки:

  1. Кнопка входа в систему и смены пользователя
  2. Кнопка установки даты и времена
  3. Кнопка вызова помощи

 

Для того чтобы добавить кнопку входа в систему и смены пользователя, надо создать кнопку с полем NAME, равным “_ACCESS_”.  WIDGET_TYPE для нее должен быть равным PtLabel.

Пример определения кнопки _ACCESS_:

BUTTON

NAME="_ACCESS_";

IMAGE=/usr/Phocus/Dial/Phocus/Images/Log_Off.jpg;

IMAGE_TEXT_POS=Pt_BALLOON_RIGHT;

FILE_DIALOG="Access";

WIDGET_TYPE=PtLabel;

X=RIGHT;

BALLOON="Login/Logout";

END_BUT

Жирным шрифтом выделены обязательные элементы определения.

 

Для создания кнопки установки даты и времени необходимо определить кнопку с полем NAME, равным “_SETDATETIME_”.  WIDGET_TYPE для нее должен быть равным PtLabel. Пример определения кнопки “_SETDATETIME_ ”:

BUTTON

NAME="_SETDATETIME_";

IMAGE=/usr/Phocus/Dial/Phocus/Images/calendar.jpg;

IMAGE_TEXT_POS=Pt_BALLOON_RIGHT;

FILE_DIALOG="SetDateTime";

WIDGET_TYPE=PtLabel;

X=RIGHT;

BALLOON="Date and Time";

END_BUT

Жирным шрифтом выделены обязательные элементы определения.

 

Для создания кнопки помощи необходимо определить кнопку с полем NAME, равным “_HELP_”.  WIDGET_TYPE для нее должен быть равным PtLabel. Пример определения кнопки “_HELP_ ”:

BUTTON

NAME="_HELP_";

FILE_DIALOG="Help";

IMAGE=Help.jpg;

X=RIGHT;

WIDGET_TYPE=PtLabel;

BALLOON="Help";

END_BUT

Жирным шрифтом выделены обязательные элементы определения.

 

Пример файла UserMenu.dial, с конфигурацией по-умолчанию: 

 

 

BUTTON

NAME="";

FILE_DIALOG=DIALOG@"SuperUser";

IMAGE=PhocusLogo.jpg;

IMAGE_TEXT_POS=Pt_BALLOON_RIGHT;

X=10;

END_BUT

 

BUTTON

NAME="_HELP_";

FILE_DIALOG="Help";

IMAGE=Help.jpg;

X=RIGHT;

WIDGET_TYPE=PtLabel;

BALLOON="Help";

END_BUT

 

BUTTON

NAME="_ACCESS_";

IMAGE=/usr/Phocus/Dial/Phocus/Images/Log_Off.jpg;

IMAGE_TEXT_POS=Pt_BALLOON_RIGHT;

FILE_DIALOG="Access";

WIDGET_TYPE=PtLabel;

X=RIGHT;

BALLOON="Login/Logout";

END_BUT

 

BUTTON

NAME="_SETDATETIME_";

IMAGE=/usr/Phocus/Dial/Phocus/Images/calendar.jpg;

IMAGE_TEXT_POS=Pt_BALLOON_RIGHT;

FILE_DIALOG="SetDateTime";

WIDGET_TYPE=PtLabel;

X=RIGHT;

BALLOON="Date and Time";

END_BUT


Вид стандартного пользовательского меню, соответствующий этому файлу, следующий:


English

© ООО Науцилус, 2006