Ovládací prvek ContextMenu

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.

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.

Vlastnosti Items

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).
• Hodnoty ItemHeader a ItemDivider musí být nastaveny jako true, aby se vykreslily jako oddělovače. 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.