MenuButton — C# API

Кнопка открытия меню команд без постоянного выбранного пункта.

class MenuButtonReckfellSharpНаследует Button

MenuButton показывает принадлежащий ему PopupMenu. Получите его через GetPopup, заполните командами и подключите IdPressed самого меню для выполнения команды по ID. Pressed кнопки означает активацию открытия/закрытия, а не выбор команды. Для сохраняемого выбора используйте OptionButton.

Конструктор задаёт Flat = true, ToggleMode = true, ActionMode = Press, FocusMode = Accessibility. Для обычного Tab задайте FocusMode = All. Toggle-состояние связано с видимостью меню; не используйте ButtonPressed как значение прикладной настройки. ItemCount изменяет число строк PopupMenu, но не заполняет их полезным текстом или действиями.

AboutToPopup испускается перед ShowPopup: здесь можно обновить доступность и содержимое команд. ShowPopup требует Viewport и открывает меню напрямую; он не проходит проверку Disabled из Press. Вызывайте его для активного элемента внутри дерева. GetPopup возвращает общий внутренний объект — не освобождайте и не переносите его.

SwitchOnHover по умолчанию false. Если включить его у связанных MenuButton до открытия, уже открытое меню может переключиться на другую подходящую кнопку при наведении. Это не открытие первого меню от любого наведения. SetDisableShortcuts отключает локальную обработку сочетаний этой кнопки и меню, а не действия InputMap во всём приложении.

Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.

Конструкторы1

MenuButtonКонструктор

# MenuButton

C#
public MenuButton();

Создаёт плоскую toggle-кнопку с ActionMode = Press, FocusMode = Accessibility и скрытым внутренним PopupMenu. SwitchOnHover = false.

Свойства2

ItemCountСвойство

# ItemCount

C#
public int ItemCount { get; set; }

Число строк внутреннего PopupMenu. Неотрицательный setter добавляет пустые строки или удаляет хвост. Метки, ID и действия заполняются отдельно через GetPopup.

SwitchOnHoverСвойство

# SwitchOnHover

C#
public bool SwitchOnHover { get; set; }

Разрешает переключение уже открытых связанных MenuButton при наведении, false по умолчанию. Задайте до открытия меню; не открывает первое меню от обычного наведения.

Методы7

GetItemCountint

# GetItemCount

C#
public int GetItemCount();

Возвращает int

Число всех строк, включая разделители.

GetPopupPopupMenu

# GetPopup

C#
public PopupMenu GetPopup();

Возвращает принадлежащий кнопке внутренний PopupMenu. Команды и их IdPressed обрабатываются на нём. Не освобождайте и не переносите отдельно.

Возвращает PopupMenu

Общий внутренний PopupMenu, которым владеет кнопка.

IsSwitchOnHoverbool

# IsSwitchOnHover

C#
public bool IsSwitchOnHover();

Возвращает bool

true, если настроено переключение открытых меню наведением.

SetDisableShortcutsvoid

# SetDisableShortcuts

C#
public void SetDisableShortcuts(bool disabled);

Отключает локальную обработку сочетаний списка и унаследованной кнопки. Не меняет InputMap приложения и не отключает обычные Select/методы списка.

Параметры
Имя	Тип	По умолчанию
`disabled`	`bool`	—

disabled

SetItemCountvoid

# SetItemCount

C#
public void SetItemCount(int count);

Параметры
Имя	Тип	По умолчанию
`count`	`int`	—

count

SetSwitchOnHovervoid

# SetSwitchOnHover

C#
public void SetSwitchOnHover(bool enable);

Параметры
Имя	Тип	По умолчанию
`enable`	`bool`	—

enable

ShowPopupvoid

# ShowPopup

C#
public void ShowPopup();

Напрямую открывает PopupMenu при наличии Viewport, предварительно испуская AboutToPopup. Не проверяет Disabled как Press; используйте для активного элемента внутри дерева.

Сигналы и события1

AboutToPopupСобытие

# AboutToPopup

public event Action AboutToPopup;

Испускается перед открытием через ShowPopup. Подходит для обновления доступности/содержимого команд; не сообщает выбор команды.