Диалоги объектов БД

Функция UniDialog

UniDialog (
 [DBFLD, D, Dn, ... ,]
 [DBINF, Number,Seria,...,]
 [VFLD, rA, "A", rB, "B", ... ,]
 [BFLD, bKey1, "Ключ1", bKey2, "Ключ2",... ,]
 [RADIO, rKey1, "Вариант1", "Вариант2", ... ,]
 [VIDS, strDesignName, "Design1","Design2", ... ,]
 [TVIDS, lVidType, {"F", "T", "R", "L", "All"},]
 [VIEW, {"Vids", "Hdr", "None"}]
)

Функция вызывает диалог редактирования стандартного объекта базы данных. Функция возвращает IDOK, если была нажата кнопка "OK" и IDCANCEL, если была нажата кнопка "Cancel".

[] - блок необязательных параметров

DBFLD - ключевое слово, после которого перечисляются табличные параметры

D,Dn, ... - имена табличных параметров.

VFLD- ключевое слово, после которого перечисляются параметры объекта, объявленные в секции Public или Protected.

rA,rB, ... - имена параметров с комментариями.

BFLD - ключевое слово, после которого перечисляются переключатели - переменные, принимающие только значения 1 (ВКЛ) и 0 (ВЫКЛ).

bKey1, "Ключ1",bKey2, "Ключ2" - имена переменных с названиями переключателей.

Блок параметров, начинающихся с ключевого слова BFLD, представляет собой объявление компонентов диалога, являющихся стандартными CheckBox(-ами) и имеющих два состояния: ВКЛЮЧЕНО (Checked) и ВЫКЛЮЧЕНО (Unchecked). Параметр-переменная, следующая за BFLD, в зависимости от состояния переключателя принимает значение 1 для ВКЛЮЧЕНО и 0 для ВЫКЛЮЧЕНО. В приложении такие переключатели широко используются для описания свойств стандартных объектов.

RADIO - ключевое слово, после которого перечисляются групповые переключатели - переменные, принимающие дискретные целые значения.

rKey1, "Вариант 1", "Вариант 2", ... - имена переменных групповых переключателей с названиями вариантов выбора.

Блок параметров, начинающихся с ключевого слова RADIO, представляет собой объявление компонентов диалога, являющихся стандартными выпадающими списками с постоянным числом неизменяемых строк. Параметр-переменная, следующая за RADIO, принимает значение индекса выбранной в ComboBox строки. Самая верхняя строка имеет индекс 0, последняя строка равна числу строк минус 1. В приложении такие переключатели обычно используются для выбора материала стандартных объектов.

Для описанного ниже примера параметр bCommon принимает целочисленные значения 0 или 1, а параметр rd1 принимает значения 0, 1 или 2.

Параметры для BFLD и RADIO можно описывать и в секции Public и Protected. Перед вызовом диалога такие параметры должны быть проинициализированы (обычно в OnInitialization).

VIDS- ключевое слово, после которого перечисляются исполнения объекта

strDesignName, "Design1", "Design2" - имя переменной, хранящей название исполнения объекта с доступными названиями исполнений.

TVIDS- ключевое слово, после которого перечисляются виды объекта

lViewType- переменная, хранящая название вида объекта и принимающая значения только из множества {VFRONT, VRIGHT, VLEFT, VTOP, VBOTTOM,VBACK}.

"F" - обозначение вида «Фронтальный».

"R" - обозначение вида «Справа».

"L" - обозначение вида «Слева».

"T" - обозначение вида «Сверху».

"B" - обозначение вида «Снизу».

"All" - обозначение всех видов.

VIEW - ключевое слово, после которого следует тип слайдов из множества {"Vids", "Hdr", "None"}.

"Vids" - слайды исполнений объекта

"Hdr" - слайд заголовка объекта (Header)

"None" - нет слайдов

Примеры:

LoadInCache(dr);
UniDialog (
 DBFLD, dr,
 VFLD,
 Lthread, "Длина нарезанной части",
 Lhole, "Длина отверстия",
 d_hole, "Диаметр свободной части",
 VIDS, strDesignName, "All",
 TVIDS, lViewType,"All",
 VIEW, "Vids"
);
LoadInCache(Dn);
UniDialog (
 DBFLD, Dn,
 BFLD, bCommon, "Общего применения",
 RADIO, rd1, "Алюминиевый сплав", "Сталь 45", "Бронза",
 VIDS, strDesignName, "All",
 TVIDS, lViewType, "All",
 VIEW, "Vids"
);

Пользовательские формы

ShowForm("FormName");

Вызывает пользовательскую форму объекта с именем "FormName".

Функция записывается в метод "OnDialog" вместо функции "UniDialog".

Функция MessageBox

MessageBox(StrMessage[,mb_Buttons = MB_OK, mb_Icons]);

Функция вызывает стандартное всплывающее сообщение Windows.

StrMessage - строка сообщения

mb_Buttons - параметр, определяющий кнопки в MessageBox.

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

MB_OK - только кнопка ОК

MB_OKCANCEL - кнопки ОК\Отмена

MB_YESNO - Кнопки Да\Нет

mb_Icons - параметр, определяющий иконки в MessageBox.

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

MB_ICONWARNING - предупреждение

MB_ICONINFORMATION - информационное сообщение

MB_ICONERROR - ошибка

MB_ICONQUESTION - вопрос

В зависимости от нажатой клавиши функция возвращает следующие значения:

IDOK - была нажата кнопка ОК

IDCANCEL - была нажата кнопка Отмена

IDYES - была нажата кнопка Да

IDNO - была нажата кнопка Нет

Пример:

MessageBox("Ошибка при подключении!", MB_OK, MB_ICONERROR);

Сообщение в нотификатор

ShowMessage("Text"[, npIcon, objectID]); 

Выводит нотификационное сообщение с указанным текстом Text

npIcon может принимать значения:

npSimple == -1, // без иконки

npUsual == 0, // "страница"

npWarning == 1, // "восклицательный знак"

npCure == 2, // "крест"

npHint == 3, // "лампа"

npError == 4 //Ошибка

В случае указания objectID сообщение будет с кнопкой редактирования объекта обозначенного objectID

ПРИМЕЧАНИЕ

Сообщения с objectID нельзя посылать в процессе вставки или вызова диалога.

На сообщения с ключом npError не действует настройка «Показывать всплывающие сообщения».

Функция ShowValue

ShowValue(StrMessage,Value);

Функция выводит значение переданного в качестве аргумента параметра (value), сопровождая его строкой strMessage, в окно специализированного отладчика InDebMon.exe. В качестве value может выступать любой параметр или переменная.

Пример:

ShowValue("pntOrigin", pntOrigin);
ShowValue("vecDirection", vecDirection);
ShowValue("WorkPlane WP1", WP1);
ShowValue("Dn", Dn);
ShowValue("*****************", 1);
ShowValue("OnConnect Start", 1);