Sdílet prostřednictvím

ContextMenu řízení

  • Článek

Ovládací prvek používaný k zadávání příkazů.

Poznámka:

Úplná dokumentace a zdrojový kód jsou k dispozici v úložišti komponent kódu GitHubu.

Ovládací prvek ContextMenu.

Description

Kontextová nabídka (ContextMenu) je seznam příkazů, které jsou založeny na kontextu výběru, najetí myší nebo fokusu klávesnice. Je jedním z nejúčinnějších a nejpoužívanějších příkazových prostředí a lze ji použít na různých místech.

Tato komponenta kódu poskytuje obálku kolem ovládacího prvku Fluent UI ContextualMenu vázaného k tlačítku pro použití v aplikacích plátna a vlastních stránkách.

Vlastnosti

Hlavní vlastnosti

Vlastnost Description
Items Akční položky k vykreslení. První položka je považována za kořenovou položku.

Items Vlastnosti

Name Description
ItemDisplayName Zobrazovaný název položky nabídky.
ItemKey Klíč používaný k označení vybrané položky a při přidávání dílčích položek. Klíče musí být jedinečné.
ItemEnabled Pokud je tato možnost zakázána, nastavte ji na hodnotu false.
ItemVisible Pokud tato možnost není vidět, nastavte na hodnotu false.
ItemChecked Nastaveno na hodnotu true, pokud je možnost zaškrtnutá.
ItemIconName Ikona Fluent UI, kterou chcete použít (viz Ikony uživatelského rozhraní Fluent)
ItemIconColor Barva, jakou se má ikona vykreslit (například pojmenovaná, RGB nebo hexadecimální hodnota).
ItemIconOnly Nezobrazovat textový popisek – pouze ikonu.
ItemHeader Vykreslit položku jako záhlaví oddílu. Pokud existují položky, které mají ItemParentKey nastavené na klíč této položky, pak jsou přidány jako sémanticky seskupené položky v této sekci.
ItemTopDivider Vykreslit oddělovač v horní části sekce.
ItemDivider Vykreslit položku jako oddělovač oddílu – nebo pokud je položka záhlaví (ItemHeader = true), pak určuje, zda se má vykreslit oddělovač ve spodní části sekce.
ItemParentKey Vykreslit možnost jako podřízenou položku jiné možnosti.

Poznámka:

  • ItemIconColor přepíše hodnotu motivu komponenty a ignoruje ostatní barvy stavu (např. vypnuto).
  • ItemHeader a ItemDivider musí být nastaveno na true, aby se vykreslilo jako oddělovač. Jsou-li nastaveny na hodnotu false, očekávají se jiné hodnoty a vykreslí se prázdné.
  • Přidání vlastnosti ItemChecked a chování položek podnabídky zabrání zavření podnabídky po kliknutí.

Příklad

Příklad vzorce Power Fx pro Items:

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

Vlastnosti stylu

Vlastnost Description
Theme Přijímá řetězec JSON, který je generován pomocí návrháře motivů Fluent UI (windows.net). Ponecháte-li toto prázdné, použije se výchozí motiv definovaný Power Apps. Ponecháte-li toto prázdné, použije se výchozí motiv definovaný Power Apps. Nápovědu ke konfiguraci naleznete v části motivy.
Chevron Zobrazit nebo skrýt šipku dolů na kořenovém tlačítku
IconColor Nepovinné. barva ikony, která se zobrazí v tlačítku kontextové nabídky.
HoverIconColor Nepovinné. barva ikony, která se zobrazí v tlačítku kontextové nabídky při přejetí myší.
IconSize Nepovinné. Velikost ikony na tlačítku kontextové nabídky v pixelech.
FontSize Nepovinné. Velikost textu na tlačítku kontextové nabídky v pixelech.
FontColor Nepovinné. barva textu, která se zobrazí v tlačítku kontextové nabídky.
HoverFontColor Nepovinné. barva textu, která se zobrazí v tlačítku kontextové nabídky při přejetí myší.
FillColor Nepovinné. barva pozadí, která se zobrazí v tlačítku kontextové nabídky.
HoverFillColor Nepovinné. barva pozadí, která se zobrazí v tlačítku kontextové nabídky při přejetí myší.
TextAlignment Zarovnání textu na tlačítku. Možné hodnoty: Doprostřed, Vlevo nebo Vpravo
AccessibilityLabel Popisek Aria pro čtečky obrazovky

Vlastnosti události

Vlastnost Description
InputEvent Událost, která se má odeslat do ovládacího prvku. Např. SetFocus. Viz níže.

Chování

Podporuje SetFocus jako InputEvent.

Konfigurace chování při události 'On Select'

Použijte vzorec Switch() ve vlastnosti OnSelect komponenty pro konfiguraci konkrétních akcí spouštěných každou položkou, a to odkazem na vybraný ovládací prvek ItemKey jako hodnotu přepínače.

Hodnoty false nahraďte příslušnými výrazy v jazyce Power Fx.

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

Nastavení zaměření na ovládací prvek

Když se zobrazí nové dialogové okno a výchozí fokus by měl být na ovládacím prvku, bude potřeba explicitně nastavit fokus.

Chcete-li volat vstupní událost, můžete nastavit kontextovou proměnnou, která je vázána na vlastnost Input Event na řetězec začínající řetězcem SetFocus a následuje náhodný prvek, který zajistí, že to aplikace detekuje jako změnu.

Např.

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

Kontextová proměnná ctxResizableTextareaEvent pak může být vázána na vlastnost Input Event.

Omezení

Tuto komponentu kódu lze použít pouze v aplikacích plátna a vlastních stránkách.