Функция MessageWithHelp

Назначение

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

По клавише F1 или по кнопке [Справка] (если в параметре mode есть константа HelpButton) отображается страница справки, соответствующая идентификатору контекста helpID. Диалоговое окно в этом случае не закрывается и ждёт дальнейших действий от пользователя.-

Описание

function MessageWithHelp (aMessage : string, mode : word,
						helpID : string) : word;
function MessageWithHelp (aMessage : string, mode : word,
						helpID : word) : word;

Параметры

aMessage : string - текст сообщения. Для перехода на новую строку можно использовать Chr(13) или #13, например Message('Ошибка:'+Chr(13)+'Файл не найден', Error).

mode : word - описание кнопок и заголовка. Для вычисления mode можно использовать:

• константы видов кнопок, которые появятся в диалоговом окне: yesButton, noButton, cancelButton, okButton, HelpButton (добавляет кнопку Help), yesNo (yesButton + noButton), okCancel (okButton + cancelButton), mfYesNoCancel (yesButton + noButton + cancelButton);

• константы вариантов заголовков: Error (ошибка), Warning (предупреждение), Information (информация), Confirmation (подтверждение);

• константы модификации режима: mfSwapButtons (переключает кнопку по умолчанию), mfNotLogMessage (отключает запись сообщения в протокол), mfIgnoreBatch (отключает пакетный режим, жестко ждет ответа именно от пользователя).

Mode вычисляется как сумма необходимого заголовка, кнопок и модификаторов.

helpID : string /word - идентификатор раздела справки, который будет показан по кнопке [Справка]. Второй вариант (helpID : word) устарел и не рекомендован к использованию (оставлен для совместимости со старой версией идентификации контекстной подсказки и принимает последним параметром одну из определённых заранее констант hcXXX).

Возвращаемое значение

Команда, соответствующая нажатой кнопке, может быть cmOk, cmCancel, cmYes, cmNo.