Всплывающие сообщения и вопросы
Существует множество различных функций, предназначенных для вывода на экран сообщений, вопросов, меню с вариантами или диалогов, в которых играющий может вводить число, строку, либо указать цвет или имя файла:
show_message(str)
Отображает диалоговое окно со строкой в виде сообщения.
show_message_ext(str,but1,but2,but3)
Отображает диалоговое окно со строкой в виде сообщения и до трёх кнопок. But1, but2 и but3 содержат текст кнопки. Пустая строка означает, что кнопка не отображается. Функция возвращает номер нажатой кнопки (0, если пользователь нажимает клавишу ).
show_question(str)
Отображает вопрос; возвращает истину, когда игрок выбирает Да, и ложь - при ином варианте.
get_integer(str,def)
Спрашивает у игрока номер в диалоговом окне. str - сообщение. def - отображаемый по умолчанию номер.
get_string(str,def)
Спрашивает у игрока строку в диалоговом окне. str - сообщение. def - отображаемое по умолчанию значение.
message_background(back)
Устанавливает фоновое изображение для всплывающего окна любой из функций приведённых выше. back - должен быть один из фонов, определённых в игре. Задняя сторона изображения сообщения может быть частично прозрачна (только для Windows 2000 или позже).
message_alpha(alpha)
Устанавливает прозрачность для управляющего окна любой из перечисленных выше функций. Значение alpha должно быть между 0 (полная подсветка снизу) и 1 (не подсвечивается снизу) (только для Windows 2000 или позже).
message_button(spr)
Устанавливает спрайт, используемый для кнопок во всплывающем окне. spr - должен быть спрайт, состоящий из трёх изображений, первое изображение содержит кнопку, когда та не нажата и мышь находится в стороне, второе содержит изображение, когда мышь находится поверх кнопки, но та ещё не нажата и третье изображение - когда нажата кнопка.
message_text_font(name,size,color,style)
Устанавливает шрифт для текста во всплывающем окне. (Это обычный шрифт Windows, не один из шрифтовых ресурсов в Вашей игре!) style - указывает стиль шрифта (0=обычный, 1=жирный, 2=курсив и 3=жирный-курсив).
message_button_font(name,size,color,style)
Устанавливает шрифт для кнопок во всплывающем окне. style - указывает стиль шрифта (0=обычный, 1=жирный, 2=курсив и 3=жирный-курсив).
message_input_font(name,size,color,style)
Устанавливает шрифт для поля ввода во всплывающем окне. style - указывает стиль шрифта (0=обычный, 1=жирный, 2=курсив и 3=жирный-курсив).
message_mouse_color(col)
Устанавливает цвет шрифта для кнопок во всплывающем окне, когда мышь оказывается над ними.
message_input_color(col)
Устанавливает цвет фона для поля ввода, во всплывающем окне.
message_caption(show,str)
Устанавливает заголовок для всплывающего окна. show - указывает, нужно ли отображать границу (1) или нет (0), и str - указывает заголовок, если граница отображается.
message_position(x,y)
Устанавливает позицию всплывающего окна на экране. Используйте -1, -1 позволяет центрировать окно.
message_size(w,h)
Устанавливает размер управляющего окна на экране. Если Вы выбираете -1 для ширины используемого изображения. Если Вы выбираете -1 для высоты, то высота будет вычислена находящимися линиями в сообщении.
show_menu(str,def)
Отображает всплывающее меню. str - указывает текст меню. Он состоит из различных пунктов меню с вертикальной областью между ними. Например, str = 'menu0|menu1|menu2'. Когда выбирается первый пункт, возвращает 0 и т.д. Когда игрок выбирает no item (не выбран ни один пункт), то возвращает значение по умолчанию def)
show_menu_pos(x,y,str,def)
Показывает всплывающее меню как в предшествующей функции, но в позиции x,y на экране.
get_color(defcol)
Запрашивает у игрока цвет. defcol - цвет по умолчанию. Если игрок нажимает Cancel, то возвращает значение -1.
get_open_filename(filter,fname)
Спрашивает у игрока имя файла для открытия с данным фильтром. Фильтр имеет форму 'name1|mask1|name2|mask2|...'. Маска содержит различные опции с точкой и запятой между ними. * - означает любую строку. Например: 'bitmaps|*.bmp;*.wmf'. Если игрок нажимает Cancel, то возвращает пустую строку.
get_save_filename(filter,fname)
Спрашивает имя файла для сохранения с заданным фильтром. Если игрок нажимает Cancel, то возвращает пустую строку.
get_directory(dname)
Запрашивает каталог. dname - название по умолчанию. Если игрок нажимает Cancel, то возвращает пустую строку.
get_directory_alt(capt,root)
Альтернативный способ запросить каталог. capt - название, которое будет отображено. root - корень дерева каталогов, который будет отображён. Используйте пустую строку, чтобы отобразить всё дерево. Если игрок нажимает Cancel, то возвращает пустую строку).
show_error(str,abort)
Отображает стандартное сообщение об ошибке (и/или записывает его в log файл). abort - указывает должна ли игра прерваться.