Руководство разработчика

Функция ОКНО_СООБ

Функция ОКНО_СООБ позволяет показывать на экране окна сообщений (message box) с поддержкой практически всех возможностей соответствующей функции Windows. Функция перекрывает возможности оператора СООБЩЕНИЕ и функции ВОПРОС

ФУНКЦИЯ ТИП_СТРОКА: ОКНО_СООБ(ТИП_СТРОКА: текст, заголовок, кнопки,
	опции)

Параметры

текст
Текст сообщения. При необходимости передачи длинной строки (длина которой превышает 255 символов) следует использовать объект типа список.
заголовок
Заголовок окна сообщения. Если задана пустая строка, то выводится стандартный заголовок "Ошибка".
кнопки
Список кнопок. Список кнопок задается перечислением их идентификаторов через запятую. Поддерживаются следующие идентификаторы:
  • OK – Ок;
  • CANCEL – Отмена;
  • YES – Да;
  • NO – Нет;
  • RETRY – Повторить;
  • IGNORE – Пропустить;
  • ABORT – Прервать.
Также возможно указание номера кнопки по умолчанию. Для этого в списке кнопок через запятую необходимо указать ее номер. Порядок перечисления кнопок не важен, но не любые комбинации поддерживаются. Список поддерживаемых комбинаций:
  • "OK";
  • "OK, CANCEL";
  • "YES, NO";
  • "RETRY, CANCEL";
  • "YES, NO, CANCEL";
  • "ABORT, RETRY, IGNORE".

По умолчанию и при неверной комбинации в окне присутствует только кнопка "ОК".

опции
Прочие параметры окна. Параметры указываются через запятую, порядок и регистр символов не важен. Здесь может задаваться идентификатор иконки:
  • "INFO" – информация;
  • "WARNING" – предупреждение;
  • "QUESTION" – вопрос;
  • "ERROR" – ошибка;
  • "TOPMOST" – окно сообщения располагается над всеми другими окнами даже при переключении задач;
  • "RIGHT" – многострочный текст выравнивается вправо (по умолчанию влево).

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

Функция возвращает строку, идентификатор нажатой кнопки. Кнопка "Закрыть" системного меню ("крестик") эквивалентна кнопке CANCEL.

Пример использования

рез=ОКНО_СООБ("Пример использования новой функции" + СИМВ(13) +
    "Для положительного ответа нажмите кнопку Да" + СИМВ(13) +
    "Для отрицательного ответа нажмите кнопку Нет",
    "Наименование окна сообщения", "YES,NO,2",
    "INFO, TOPMOST")                    // кнопка по умолчанию "Нет"

См. также: