Dialog.ComboBox

string Dialog.ComboBox (

string Title,
string Prompt,
table Items,
string DefaultItem,
boolean SortItems = false,
boolean Editable = false,
number Icon = MB_ICONQUESTION )

Примеры

Описание

Представляет диалоговое окно с выпадающим списком в нем.

Параметры

Title

(строка) Текст, отображаемый в заголовке диалогового окна.

Prompt

(строка) Текст, что будет показан выше выпадающего списка.

Items

(таблица) Численно индексированная таблица, содержащая список пунктов, который будут доступны в поле со списком (combo box).

DefaultItem

(строка) Пункт по умолчанию, который будет выбран в выпадающем списке. Если не должно быть ничего выбрано, используйте пустую строку ("").

SortItems

(логический) Должен ли быть отсортированы пункты в выпадающем списке или нет:

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Сортировать пункты в выпадающем списке.
false	Не сортировать пункты. (По умолчанию)

Editable

(логический) Будет ли текст выпадающего списка редактироваться или пользователь будет выбирать пункт из списка:

ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
true	Текст выпадающего списка будет редактироваться.
false	Пользователь должен выбрать пункт из списка. (По умолчанию)

Icon

(число) Иконка, отображаемая в диалоговом окне:

КОНСТАНТА CONSTANT	ЗНАЧЕНИЕ VALUE	ОПИСАНИЕ DESCRIPTION
MB_ICONNONE	0	Нет.
MB_ICONSTOP	16	Стоп.
MB_ICONQUESTION	32	Вопрос. (По умолчанию)
MB_ICONEXCLAMATION	48	Восклицание.
MB_ICONINFORMATION	64	Информация.

Возврат

ResultVariable

(строка) Пункт, который был выбран из выпадающего списка, или текст, который был введен, если поле ввода редактируемое, при нажатой кнопке OK. Если нажата кнопка Cancel, будет возвращено "CANCEL". Если происходит ошибка, будет возвращена пустая строка "". Можно использовать Application.GetLastError для определения случился ли отказ в работе этого действия и почему.

Смотрите также: Связанные действия

Примеры

Пример 1

-- The combo box items table.
-- Таблица пунктов выпадающего списка.
tbItems = {"Apple", "Orange", "Pear"};

-- Show the dialog combo box.
-- Показываем диалоговое окно с выпадающим списком.
strSelected = Dialog.ComboBox("Select Lunch", "Please select the desired fruit:", tbItems, "Apple", false, false, MB_ICONQUESTION);

if ((strSelected ~= "") and (strSelected ~= "CANCEL")) then
    Dialog.Message("Result", "The chosen fruit is " .. strSelected);
end

Пользователю предлагается выбрать фрукт в выпадающем списке в диалоговом окне и после клика по кнопке OK показывается результат в диалоговом окне сообщения.

Смотрите также: Связанные действия