NativeMenu
Интерфейс сервера OS местные меню.
Интерфейс сервера OS местные меню.
NativeMenu :: обеспечивает доступ к низкоуровневому OS - местные глобальные меню и всплывающие меню.
Примечание: Это низкоуровневая API, подумайте об использовании MenuBar при этом MenuBar.PreferGlobalMenu установлен в true, и PopupMenu при этом PopupMenu.PreferNativeMenu установлен в true.
Чтобы создать меню, используйте NativeMenu.CreateMenu, добавить меню add_*_item Для удаления меню используйте NativeMenu.FreeMenu.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Свойства1
SingletonСвойство
public static NativeMenuInstance Singleton { get; }Методы71
AddCheckItemint
public static int AddCheckItem(Rid rid, string label, Callable callback = default, Callable keyCallback = default, Variant tag = default, Key accelerator = Key.None, int index = -1);Добавляет новый отмечаемый элемент с текстом label в глобальное меню rid.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Дополнительно можно определить accelerator, который представляет собой сочетание клавиш, которое можно нажать для вызова кнопки меню, даже если оно в данный момент не открыто. accelerator обычно представляет собой комбинацию KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: Вызываемые callback и key_callback должны принимать ровно один параметр Variant, параметр, переданный в вызываемые, будет значением, переданным в tag.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: В Windows accelerator и key_callback игнорируются.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
label | string | — |
callback | Callable | default |
keyCallback | Callable | default |
tag | Variant | default |
accelerator | Key | Key.None |
index | int | -1 |
intAddIconCheckItemint
public static int AddIconCheckItem(Rid rid, Texture2D icon, string label, Callable callback = default, Callable keyCallback = default, Variant tag = default, Key accelerator = Key.None, int index = -1);Добавляет новый отмечаемый элемент с текстом label и значком icon в глобальное меню rid.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Дополнительно можно определить accelerator, который представляет собой сочетание клавиш, которое можно нажать для вызова кнопки меню, даже если оно в данный момент не открыто. accelerator обычно представляет собой комбинацию KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: Вызываемые callback и key_callback должны принимать ровно один параметр Variant, параметр, переданный в вызываемые, будет значением, переданным в tag.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: В Windows accelerator и key_callback игнорируются.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
icon | Texture2D | — |
label | string | — |
callback | Callable | default |
keyCallback | Callable | default |
tag | Variant | default |
accelerator | Key | Key.None |
index | int | -1 |
intAddIconItemint
public static int AddIconItem(Rid rid, Texture2D icon, string label, Callable callback = default, Callable keyCallback = default, Variant tag = default, Key accelerator = Key.None, int index = -1);Добавляет новый элемент с текстом label и значком icon в глобальное меню rid.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Дополнительно можно определить accelerator, который представляет собой сочетание клавиш, которое можно нажать для вызова кнопки меню, даже если оно в данный момент не открыто. accelerator обычно представляет собой комбинацию KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: Вызываемые callback и key_callback должны принимать ровно один параметр Variant, параметр, переданный в вызываемые, будет значением, переданным в tag.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: В Windows accelerator и key_callback игнорируются.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
icon | Texture2D | — |
label | string | — |
callback | Callable | default |
keyCallback | Callable | default |
tag | Variant | default |
accelerator | Key | Key.None |
index | int | -1 |
intAddIconRadioCheckItemint
public static int AddIconRadioCheckItem(Rid rid, Texture2D icon, string label, Callable callback = default, Callable keyCallback = default, Variant tag = default, Key accelerator = Key.None, int index = -1);Добавляет новый элемент с возможностью радио-отметки с текстом label и значком icon в глобальное меню rid.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Дополнительно можно определить accelerator, который представляет собой сочетание клавиш, которое можно нажать для вызова кнопки меню, даже если оно в данный момент не открыто. accelerator обычно представляет собой комбинацию KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: Элементы с возможностью радио-отметки просто отображают галочку, но не имеют встроенного поведения проверки и должны быть отмечены/сняты вручную. См. NativeMenu.SetItemChecked для получения дополнительной информации о том, как управлять этим.
Примечание: Вызываемые объекты callback и key_callback должны принимать ровно один параметр Variant, параметр, переданный в вызываемые объекты, будет значением, переданным в tag.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: В Windows accelerator и key_callback игнорируются.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
icon | Texture2D | — |
label | string | — |
callback | Callable | default |
keyCallback | Callable | default |
tag | Variant | default |
accelerator | Key | Key.None |
index | int | -1 |
intAddItemint
public static int AddItem(Rid rid, string label, Callable callback = default, Callable keyCallback = default, Variant tag = default, Key accelerator = Key.None, int index = -1);Добавляет новый элемент с текстом label в глобальное меню rid.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Дополнительно можно определить accelerator, который представляет собой сочетание клавиш, которое можно нажать для вызова кнопки меню, даже если оно в данный момент не открыто. accelerator обычно представляет собой комбинацию KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: Вызываемые callback и key_callback должны принимать ровно один параметр Variant, параметр, переданный в вызываемые, будет значением, переданным в tag.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: В Windows accelerator и key_callback игнорируются.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
label | string | — |
callback | Callable | default |
keyCallback | Callable | default |
tag | Variant | default |
accelerator | Key | Key.None |
index | int | -1 |
intAddMultistateItemint
public static int AddMultistateItem(Rid rid, string label, int maxStates, int defaultState, Callable callback = default, Callable keyCallback = default, Variant tag = default, Key accelerator = Key.None, int index = -1);Добавляет новый элемент с текстом label в глобальное меню rid.
В отличие от обычных двоичных элементов, элементы с несколькими состояниями могут иметь более двух состояний, как определено max_states. Каждое нажатие или активация элемента увеличит состояние на единицу. Значение по умолчанию определяется default_state.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Необязательно может быть определен accelerator, представляющий собой сочетание клавиш, которое можно нажать для вызова кнопки меню, даже если оно в данный момент не открыто. accelerator обычно представляет собой комбинацию KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: По умолчанию нет указания на текущее состояние элемента, его следует изменить вручную.
Примечание: Вызываемые объекты callback и key_callback должны принимать ровно один параметр Variant, параметр, переданный в вызываемые объекты, будет значением, переданным в tag.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: В Windows accelerator и key_callback игнорируются.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
label | string | — |
maxStates | int | — |
defaultState | int | — |
callback | Callable | default |
keyCallback | Callable | default |
tag | Variant | default |
accelerator | Key | Key.None |
index | int | -1 |
intAddRadioCheckItemint
public static int AddRadioCheckItem(Rid rid, string label, Callable callback = default, Callable keyCallback = default, Variant tag = default, Key accelerator = Key.None, int index = -1);Добавляет новый элемент с возможностью радио-отметки с текстом label в глобальное меню rid.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Дополнительно можно определить accelerator, который представляет собой сочетание клавиш, которое можно нажать для вызова кнопки меню, даже если оно в данный момент не открыто. accelerator обычно представляет собой комбинацию KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: Элементы с возможностью радио-отметки просто отображают галочку, но не имеют встроенного поведения проверки и должны быть отмечены/сняты вручную. См. NativeMenu.SetItemChecked для получения дополнительной информации о том, как управлять этим.
Примечание: Вызываемые объекты callback и key_callback должны принимать ровно один параметр Variant, параметр, переданный в вызываемые объекты, будет значением, переданным в tag.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: В Windows accelerator и key_callback игнорируются.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
label | string | — |
callback | Callable | default |
keyCallback | Callable | default |
tag | Variant | default |
accelerator | Key | Key.None |
index | int | -1 |
intAddSeparatorint
public static int AddSeparator(Rid rid, int index = -1);Добавляет разделитель между элементами в глобальное меню rid. Разделители также занимают индекс.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
index | int | -1 |
intAddSubmenuItemint
public static int AddSubmenuItem(Rid rid, string label, Rid submenuRid, Variant tag = default, int index = -1);Добавляет элемент, который будет действовать как подменю глобального меню rid. Аргумент submenu_rid — это RID глобального меню, которое будет показано при щелчке по элементу.
Возвращает индекс вставленного элемента, он не обязательно будет таким же, как значение index.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
label | string | — |
submenuRid | Rid | — |
tag | Variant | default |
index | int | -1 |
intClearvoid
public static void Clear(Rid rid);Удаляет все элементы из глобального меню rid.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
CreateMenuRid
public static Rid CreateMenu();Создает новый глобальный объект меню. Примечание: Этот метод реализован в macOS и Windows.
RidFindItemIndexWithSubmenuint
public static int FindItemIndexWithSubmenu(Rid rid, Rid submenuRid);Возвращает индекс элемента с подменю, указанным в submenu_rid. Индексы автоматически присваиваются каждому элементу движком.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
submenuRid | Rid | — |
intFindItemIndexWithTagint
public static int FindItemIndexWithTag(Rid rid, Variant tag);Возвращает индекс элемента с указанным tag. Индексы автоматически присваиваются каждому элементу движком.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
tag | Variant | — |
intFindItemIndexWithTextint
public static int FindItemIndexWithText(Rid rid, string text);Возвращает индекс элемента с указанным text. Индексы автоматически присваиваются каждому элементу движком.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
text | string | — |
intFreeMenuvoid
public static void FreeMenu(Rid rid);Освобождает глобальный объект меню, созданный этим NativeMenu.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
GetItemAcceleratorKey
public static Key GetItemAccelerator(Rid rid, int idx);Возвращает ускоритель элемента по индексу idx. Ускорители — это специальные комбинации клавиш, которые активируют элемент, независимо от того, какой элемент управления находится в фокусе.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
KeyGetItemCallbackCallable
public static Callable GetItemCallback(Rid rid, int idx);Возвращает обратный вызов элемента с индексом idx.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
CallableGetItemCountint
public static int GetItemCount(Rid rid);Возвращает количество пунктов в глобальном меню rid.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
intGetItemIconTexture2D
public static Texture2D GetItemIcon(Rid rid, int idx);Возвращает значок элемента по индексу idx.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
Texture2DGetItemIndentationLevelint
public static int GetItemIndentationLevel(Rid rid, int idx);Возвращает горизонтальное смещение элемента по указанному idx.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
intGetItemKeyCallbackCallable
public static Callable GetItemKeyCallback(Rid rid, int idx);Возвращает обратный вызов ускорителя элемента по индексу idx.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
CallableGetItemMaxStatesint
public static int GetItemMaxStates(Rid rid, int idx);Возвращает количество состояний элемента с несколькими состояниями. Подробности см. в NativeMenu.AddMultistateItem.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
intGetItemStateint
public static int GetItemState(Rid rid, int idx);Возвращает состояние элемента с несколькими состояниями. Подробности см. в NativeMenu.AddMultistateItem.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
intGetItemSubmenuRid
public static Rid GetItemSubmenu(Rid rid, int idx);Возвращает идентификатор подменю элемента с индексом idx. Подробнее о том, как добавить подменю, см. в NativeMenu.AddSubmenuItem.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
RidGetItemTagVariant
public static Variant GetItemTag(Rid rid, int idx);Возвращает метаданные указанного элемента, которые могут быть любого типа. Вы можете задать их с помощью NativeMenu.SetItemTag, который обеспечивает простой способ назначения контекстных данных элементам.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
VariantGetItemTextstring
public static string GetItemText(Rid rid, int idx);Возвращает текст элемента по индексу idx.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
stringGetItemTooltipstring
public static string GetItemTooltip(Rid rid, int idx);Возвращает подсказку, связанную с указанным индексом idx.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
stringGetMinimumWidthfloat
public static float GetMinimumWidth(Rid rid);Возвращает минимальную ширину глобального меню. Примечание: Этот метод реализован только на macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
floatGetPopupCloseCallbackCallable
public static Callable GetPopupCloseCallback(Rid rid);Возвращает глобальный обратный вызов закрытия меню. Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
CallableGetPopupOpenCallbackCallable
public static Callable GetPopupOpenCallback(Rid rid);Возвращает глобальный обратный вызов открытия меню. Примечание: Этот метод реализован только на macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
CallableGetSizeVector2
public static Vector2 GetSize(Rid rid);Возвращает глобальный размер меню. Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
Vector2GetSystemMenuRid
public static Rid GetSystemMenu(NativeMenu.SystemMenus menuId);Возвращает RID специального системного меню. Примечание: Этот метод реализован только на macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
menuId | NativeMenu.SystemMenus | — |
RidGetSystemMenuNamestring
public static string GetSystemMenuName(NativeMenu.SystemMenus menuId);Возвращает читаемое имя специального системного меню. Примечание: Этот метод реализован только на macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
menuId | NativeMenu.SystemMenus | — |
stringGetSystemMenuTextstring
public static string GetSystemMenuText(NativeMenu.SystemMenus menuId);Возвращает текст пункта системного меню. Примечание: Этот метод реализован в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
menuId | NativeMenu.SystemMenus | — |
stringHasFeaturebool
public static bool HasFeature(NativeMenu.Feature feature);Возвращает true, если указанная feature поддерживается текущим NativeMenu, false в противном случае.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
feature | NativeMenu.Feature | — |
boolHasMenubool
public static bool HasMenu(Rid rid);Возвращает true, если rid является допустимым глобальным меню.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
boolHasSystemMenubool
public static bool HasSystemMenu(NativeMenu.SystemMenus menuId);Возвращает true, если поддерживается специальное системное меню.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
menuId | NativeMenu.SystemMenus | — |
boolIsItemCheckablebool
public static bool IsItemCheckable(Rid rid, int idx);Возвращает true, если элемент с индексом idx можно отметить каким-либо образом, например, если у него есть флажок или переключатель.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
boolIsItemCheckedbool
public static bool IsItemChecked(Rid rid, int idx);Возвращает true, если элемент с индексом idx можно отметить каким-либо образом, например, если у него есть флажок или переключатель.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
boolIsItemDisabledbool
public static bool IsItemDisabled(Rid rid, int idx);Возвращает true, если элемент с индексом idx отключен. Когда он отключен, его нельзя выбрать или вызвать его действие.
См. NativeMenu.SetItemDisabled для получения дополнительной информации о том, как отключить элемент.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
boolpublic static bool IsItemHidden(Rid rid, int idx);Возвращает true, если элемент с индексом idx скрыт.
См. NativeMenu.SetItemHidden для получения дополнительной информации о том, как скрыть элемент.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
boolIsItemIndeterminatebool
public static bool IsItemIndeterminate(Rid rid, int idx);Returns (Возврат) true если позиция по индексу idx это неопределённо.
Смотрите. NativeMenu.SetItemIndeterminate чтобы получить больше информации о том, как установить предмет.
Примечание: Данный метод применяется только в случае MacOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
boolIsItemRadioCheckablebool
public static bool IsItemRadioCheckable(Rid rid, int idx);Возвращает true, если элемент с индексом idx имеет возможность отмечать в стиле радиокнопки.
Примечание: Это чисто косметическое действие; необходимо добавить логику для отметки/снятия отметки элементов в группах радиокнопок.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
boolIsOpenedbool
public static bool IsOpened(Rid rid);Возвращает true, если меню в данный момент открыто.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
boolIsSystemMenubool
public static bool IsSystemMenu(Rid rid);Возврат true — глобальное меню — это специальное системное меню.
Примечание: Этот метод реализован только на macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
boolPopupvoid
public static void Popup(Rid rid, Vector2I position);Показывает глобальное меню в position в экранных координатах.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
position | Vector2I | — |
RemoveItemvoid
public static void RemoveItem(Rid rid, int idx);Удаляет элемент с индексом idx из глобального меню rid.
Примечание: Индексы элементов после удаленного элемента будут смещены на единицу.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
SetInterfaceDirectionvoid
public static void SetInterfaceDirection(Rid rid, bool isRtl);Устанавливает направление макета текста меню справа налево, если is_rtl равен true.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
isRtl | bool | — |
SetItemAcceleratorvoid
public static void SetItemAccelerator(Rid rid, int idx, Key keycode);Устанавливает акселератор элемента с индексом idx. keycode может быть одним Key или комбинацией KeyModifierMask и Key с использованием побитового ИЛИ, например KEY_MASK_CTRL | KEY_A ([kbd]Ctrl + A[/kbd]).
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
keycode | Key | — |
SetItemCallbackvoid
public static void SetItemCallback(Rid rid, int idx, Callable callback);Устанавливает обратный звонок по позиции индекс idx. При нажатии на элемент издается сигнал вызова.
Примечание: :: callback Callable нужно принять точно одну Variant параметр, параметр передан на Callable будет значение, перенесенное на tag параметр при создании пункта меню.
Примечание: Данный метод применяется на MacOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
callback | Callable | — |
SetItemCheckablevoid
public static void SetItemCheckable(Rid rid, int idx, bool checkable);Устанавливает, есть ли у элемента с индексом idx флажок. Если false, задает тип элемента как обычный текст.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
checkable | bool | — |
SetItemCheckedvoid
public static void SetItemChecked(Rid rid, int idx, bool @checked);Устанавливает статус checkstate (контрольное состояние) элемента по индексу idx.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
checked | bool | — |
SetItemDisabledvoid
public static void SetItemDisabled(Rid rid, int idx, bool disabled);Включает/отключает элемент с индексом idx. Когда он отключен, его нельзя выбрать и его действие нельзя вызвать.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
disabled | bool | — |
public static void SetItemHidden(Rid rid, int idx, bool hidden);Скрывает/показывает элемент с индексом idx. Когда он скрыт, элемент не отображается в меню и его действие не может быть вызвано.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
hidden | bool | — |
SetItemHoverCallbacksvoid
public static void SetItemHoverCallbacks(Rid rid, int idx, Callable callback);Устанавливает обратный звонок по позиции индекс idx. Обратный звонок излучается, когда какой-либо предмет зависает.
Примечание: :: callback Callable нужно принять точно одну Variant параметр, параметр передан на Callable будет значение, перенесенное на tag параметр при создании пункта меню.
Примечание: Данный метод применяется только в случае MacOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
callback | Callable | — |
SetItemIconvoid
public static void SetItemIcon(Rid rid, int idx, Texture2D icon);Заменяет значок Texture2D указанного idx.
Примечание: Этот метод реализован в macOS и Windows.
Примечание: Этот метод не поддерживается элементами меню Стеклянные доски.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
icon | Texture2D | — |
SetItemIndentationLevelvoid
public static void SetItemIndentationLevel(Rid rid, int idx, int level);Устанавливает горизонтальное смещение элемента по указанному idx.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
level | int | — |
SetItemIndeterminatevoid
public static void SetItemIndeterminate(Rid rid, int idx, bool indeterminate);Устанавливает неопределенный статус позиции в индексе idx.
Примечание: Данный метод применяется только в случае MacOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
indeterminate | bool | — |
SetItemIndexint
public static int SetItemIndex(Rid rid, int idx, int targetIdx);Изменяет индекс элемента с индексом idx на индекс target_idx. Это можно использовать для перемещения элемента выше других элементов.
Возвращает новый индекс перемещенного элемента, не гарантируется, что он будет совпадать с target_idx.
Примечание: Индексы любых элементов между индексом idx и индексом target_idx будут сдвинуты на единицу.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
targetIdx | int | — |
intSetItemKeyCallbackvoid
public static void SetItemKeyCallback(Rid rid, int idx, Callable keyCallback);Устанавливает обратный звонок по позиции индекс idx. При активации акселератора излучается сигнал вызова.
Примечание: :: key_callback Callable нужно принять точно одну Variant параметр, параметр передан на Callable будет значение, перенесенное на tag параметр при создании пункта меню.
Примечание: Данный метод применяется только в случае MacOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
keyCallback | Callable | — |
SetItemMaxStatesvoid
public static void SetItemMaxStates(Rid rid, int idx, int maxStates);Устанавливает номер состояния элемента с несколькими состояниями. Подробности см. в NativeMenu.AddMultistateItem.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
maxStates | int | — |
SetItemRadioCheckablevoid
public static void SetItemRadioCheckable(Rid rid, int idx, bool checkable);Устанавливает тип элемента с указанным индексом idx на радиокнопку. Если false, устанавливает тип элемента на обычный текст.
Примечание: Это чисто косметическое действие; необходимо добавить логику для установки/снятия отметок элементов в группах радиокнопок.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
checkable | bool | — |
SetItemStatevoid
public static void SetItemState(Rid rid, int idx, int state);Устанавливает состояние элемента с несколькими состояниями. Подробности см. в NativeMenu.AddMultistateItem.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
state | int | — |
SetItemSubmenuvoid
public static void SetItemSubmenu(Rid rid, int idx, Rid submenuRid);Устанавливает RID подменю элемента с индексом idx. Подменю — это глобальное меню, которое будет показано при щелчке по элементу.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
submenuRid | Rid | — |
SetItemTagvoid
public static void SetItemTag(Rid rid, int idx, Variant tag);Устанавливает метаданные элемента, которые могут быть любого типа. Позже вы можете получить их с помощью NativeMenu.GetItemTag, который предоставляет простой способ назначения контекстных данных элементам.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
tag | Variant | — |
SetItemTextvoid
public static void SetItemText(Rid rid, int idx, string text);Устанавливает текст элемента по индексу idx.
Примечание: Этот метод реализован в macOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
text | string | — |
SetItemTooltipvoid
public static void SetItemTooltip(Rid rid, int idx, string tooltip);Устанавливает подсказку string элемента по указанному индексу idx.
Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
idx | int | — |
tooltip | string | — |
SetMinimumWidthvoid
public static void SetMinimumWidth(Rid rid, float width);Устанавливает минимальную ширину глобального меню. Примечание: Этот метод реализован только на macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
width | float | — |
SetPopupCloseCallbackvoid
public static void SetPopupCloseCallback(Rid rid, Callable callback);Регистры, которые можно выпустить, когда меню вот-вот появится.
Примечание: :: OS может имитировать открытие меню для отслеживания изменений в меню и глобальных коротких точек, и в этом случае соответствующая прямая обратная связь не активирована. NativeMenu.IsOpened чтобы проверить, открыто ли меню в настоящее время.
Примечание: Данный метод применяется на MacOS и Windows.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
callback | Callable | — |
SetPopupOpenCallbackvoid
public static void SetPopupOpenCallback(Rid rid, Callable callback);Регистры, которые можно вызвать для испускания после закрытия меню. Примечание: Этот метод реализован только в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
rid | Rid | — |
callback | Callable | — |
SetSystemMenuTextvoid
public static void SetSystemMenuText(NativeMenu.SystemMenus menuId, string name);Устанавливает текст пункта системного меню. Примечание: Этот метод реализован в macOS.
| Имя | Тип | По умолчанию |
|---|---|---|
menuId | NativeMenu.SystemMenus | — |
name | string | — |
NativeMenu.Feature
| Значение | Описание |
|---|---|
GlobalMenu = 0 |
|
HoverCallback = 3 |
|
KeyCallback = 4 |
|
OpenCloseCallback = 2 |
|
PopupMenu = 1 |
|
NativeMenu.SystemMenus
| Значение | Описание |
|---|---|
ApplicationMenuId = 2 | Идентификатор меню приложения (первое меню после меню «Apple» в macOS). |
DockMenuId = 5 | Идентификатор контекстного меню значка Dock (в macOS это меню включает стандартные элементы управления приложениями и список открытых окон). |
HelpMenuId = 4 | Идентификатор меню «Справка» (в macOS это меню включает панель поиска справки). |
InvalidMenuId = 0 | Неверный идентификатор специального системного меню. |
MainMenuId = 1 | Глобальный идентификатор главного меню. |
WindowMenuId = 3 | Идентификатор меню «Window» (в macOS это меню включает стандартные элементы управления окнами и список открытых окон). |