Поделиться через

ContextMenu контроль

  • Статья

Элемент управления, используемый для ввода команд.

Заметка

Полная документация и исходный код находятся в разделе Репозиторий компонентов кода на GitHub.

Элемент управления ContextMenu.

Description

Контекстное меню (ContextMenu) — это список команд, зависящих от контекста выбора, наведения курсора мыши или фокуса клавиатуры. Это одна из самых эффективных и часто используемых поверхностей для команд, которую можно использовать в различных местах.

Этот компонент кода обеспечивает оболочку вокруг элемента управления Fluent UI ContextualMenu, привязанную к кнопке, для использования в приложениях на основе холста и на пользовательских страницах.

Свойства

Ключевые свойства

Свойство Description
Items Элементы действия для визуализации. Первый элемент считается корневым.

Items Характеристики

Имя. Description
ItemDisplayName Отображаемое имя пункта меню.
ItemKey Клавиша, которая используется для указания того, какой элемент выбран, и при добавлении подэлементов. Клавиши должны быть уникальными.
ItemEnabled Установите значение false, если параметр отключен.
ItemVisible Установите значение false, если параметр не виден.
ItemChecked Установите значение true, если этот параметр отмечен.
ItemIconName Значок Fluent UI для использования (см. Значки Fluent UI)
ItemIconColor Цвет для отображения значка (например, именованный, rgb или шестнадцатеричное значение).
ItemIconOnly Не показывать текстовую метку — только значок.
ItemHeader Отобразить элемент как заголовок раздела. Если есть элементы, для ItemParentKey которых установлен на ключ этого элемента, то они добавляются как семантически сгруппированные элементы в этом разделе.
ItemTopDivider Отображать разграничительную линию над разделом.
ItemDivider Отображать элемент как разделитель разделов — или, если элемент является заголовком (ItemHeader = true), то определяет, отображать ли разделитель в нижней части раздела.
ItemParentKey Отображать этот параметр как дочерний элемент другого параметра.

Заметка

  • ItemIconColor переопределит значение темы компонента и проигнорирует другие цвета состояния (например, отключено).
  • ItemHeader и ItemDivider должен быть установлен в значение true для отображения в качестве разделителя. Если установлено значение false, он ожидает другие значения и будет отображаться пустым.
  • Добавление свойства ItemChecked и поведения элементов подменю предотвратит закрытие подменю по щелчку.

Пример

Пример формулы Power Fx для Items:

  Table(
      {
          ItemKey: "File",
          ItemIconName: "save",
          ItemDisplayName: "Save",
          ItemOverflow:true
      },
       {
          ItemKey: "Delete",
          ItemIconName: "Delete",
          ItemDisplayName: "Delete",
          ItemOverflow:true
      }
  )

Свойства стиля

Свойство Description
Theme Принимает строку JSON, сгенерированную с помощью Конструктора тем Fluent UI (windows.net). Если оставить это поле пустым, будет использоваться тема по умолчанию, определенная Power Apps. Если оставить это поле пустым, будет использоваться тема по умолчанию, определенная Power Apps. Сведения о порядке настройки см. в разделе темы.
Chevron Показать или скрыть шеврон вниз на корневой кнопке
IconColor Необязательно. цвет значка на кнопке контекстного меню.
HoverIconColor Необязательно. цвет значка при наведении указателя мыши на кнопку контекстного меню.
IconSize Необязательно. В пикселях, размер значка на кнопке контекстного меню.
FontSize Необязательно. В пикселях, размер текста на кнопке контекстного меню.
FontColor Необязательно. цвет текста на кнопке контекстного меню.
HoverFontColor Необязательно. цвет текста при наведении указателя мыши на кнопку контекстного меню.
FillColor Необязательно. цвет фона кнопки контекстного меню.
HoverFillColor Необязательно. цвет фона при наведении указателя мыши на кнопку контекстного меню.
TextAlignment Выравнивание текста кнопки. Возможные значения: По центру, Слева или Справа
AccessibilityLabel Подпись Aria для программы чтения с экрана

Свойства событий

Свойство Description
InputEvent Событие, которое требуется отправить элементу управления. Например, SetFocus. См. ниже.

Поведение

Поддерживает SetFocus как InputEvent.

Настройка поведения «При выборе»

Используйте формулу Switch() в свойстве OnSelect компонента, чтобы настроить определенные действия для каждого элемента, ссылаясь на выбранный ключ ItemKey элемента управления в качестве значения переключателя.

Замените значения false на соответствующие выражения на языке Power Fx.

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 1 */
    "File", false,
    
    /* Action for ItemKey 2 */
    "Delete", false,
  
    /* Default action */
        false
  )

Настройка фокуса на элементе управления

Когда отображается новое диалоговое окно, а фокус по умолчанию должен быть на элементе управления, потребуется явная установка фокуса.

Чтобы совершать вызовы входного события, вы можете установить переменную контекста, связанную со свойством входного события, в строку, начинающуюся с SetFocus, за которым следует случайный элемент, чтобы приложение распознало его как изменение.

Например

UpdateContext({ctxResizableTextareaEvent:"SetFocus" & Text(Rand())}));

Контекстная переменная ctxResizableTextareaEvent затем может быть привязана к свойству Input Event.

Ограничения

Этот компонент кода можно использовать только в приложениях на основе холста и настраиваемых страницах.