Menu.Item.Add

From SunFlurry wiki
Revision as of 08:42, 27 November 2023 by Admin (talk | contribs) (1 revision imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
  Add (Работа с меню)
Объект:Меню
Статус разработки: Реализована
Тип:Функция
Обращение к БД:Нет
Исключения:Невозможно превратить в строку, число, неверный индекс
Визуальность:Да

Функция добавляет или вставляет новый пункт меню в массив пунктов, подчиненных текущему. Функцию можно применять как непосредственно к интерфейсу меню (в этом случае, пункт будет добавлен, как верхний пункт текущего меню), так и к пункту меню (в этом случае, будут пункт будет добавлен, как подпункт меню этого пункта).

Синтаксис

Menu.Item.Add(<Индекс вставки пункта меню (INT)>,<Идентификатор пункта меню (STRING)>,<Текст пункта меню (STRING)>,<Программа для исполнения при выборе пункта меню (STRING)>,<Иконка пункта меню (INT)>,<Режим автоматической установки галочки на пункте меню (INT)>):<Новый пункт меню (MENUITEM)>

Аргументы

  • <Индекс вставки пункта меню (INT)> - (необязательный аргумент) Задает индекс пункта меню, после которого будет вставлен новый. Если аргумент пропущен, новый пункт вставляется после всех пунктов меню.
  • <Идентификатор пункта меню (STRING)> - (необязательный аргумент) Задает идентификатор пункта, по которому его в дальнейшем можно найти и адресовать.
  • <Текст пункта меню (STRING)> - Задает заголовок добавляемого пункта меню. Если аргумент равен "-", будет добавлен разделитель меню.
  • <Программа для исполнения при выборе пункта меню (STRING)> - (необязательный аргумент) Задает текст программы, которая будет исполнена, когда пользователь выберет этот пункт меню.
  • <Иконка пункта меню (INT)> - (необязательный аргумент) Задает номер иконку текущего пункта меню. 0 (по умолчанию) означает отсутствие иконки. Номера иконок можно посмотреть в библиотеке иконок в Студии.
  • <Режим автоматической установки галочки на пункте меню (INT)> - (необязательный аргумент) Задает режим, когда галочка ставится или снимается автоматически при выборе пользователем текущего пункта меню.

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

Возвращает объект типа пункт меню.

Примеры

//Добавить второй подпункт в пункт меню с идентификатором "menuExternalReports"
аПункт:=Menu.Item("menuExternalReports");
аПункт.Add(2,,"Вывести на экран слово ""привет""","Message(""Привет!"");",1);