Dela via

ContextMenu kontroll

  • Artikel

En kontroll som används för att mata in kommandon.

Kommentar

Fullständig dokumentation och källkod finns i lagringsplatsen för GitHub-kodkomponenter.

ContextMenu-kontroll.

Description

En sammanhangsbaserad meny (ContextMenu) är en lista med kommandon som baseras på sammanhanget för markering, muspekarhovring eller tangentbordsfokus. De är en av de effektivaste och mest använda kommandoytorna, och kan användas på olika platser.

Den här kodkomponenten fungerar som en adapter runt Fluent UI ContextualMenu-kontrollen som bundits till en knapp för användning i arbetsyteappar och på anpassade sidor.

Egenskaper

Nyckelegenskaper

Property Description
Items Åtgärdsobjekten som ska återges. Det första objektet betraktas som rotobjektet.

Items Egenskaper

Name Description
ItemDisplayName Visningsnamn för menyobjektet.
ItemKey Den tangent som ska användas för att ange vilket objekt som har markerats och när du lägger till underobjekt. Tangenterna måste vara unika.
ItemEnabled Ange som "falskt" om alternativet är inaktiverat.
ItemVisible Ange som "falskt" om alternativet inte visas.
ItemChecked Ställ in på sant om alternativet är markerat.
ItemIconName Ikonen Fluent UI som ska användas (se Fluent UI-ikoner)
ItemIconColor Den färg som ikonen ska renderas i (t.ex. namngiven, rgb eller hexadecimalt värde).
ItemIconOnly Visa inte textetiketten – bara ikonen.
ItemHeader Rendera objektet som en avsnittsrubrik. Om det finns objekt som har deras ItemParentKey angett som viktiga för objektet läggs de till som grupperade objekt enligt det här avsnittet.
ItemTopDivider Återge en avgränsare längst i avsnittet.
ItemDivider Återge objektet som en avsnittsavdelare – eller om objektet är en rubrik (ItemHeader = sant) kontrollerar du om en avgränsare ska återge längst ned i avsnittet.
ItemParentKey Återge alternativet som underobjekt för ett annat alternativ.

Kommentar

  • ItemIconColor åsidosätter komponentens Theme-värde och ignorerar andra lägesfärger (t.ex. inaktiverad).
  • ItemHeader och ItemDivider måste anges till true för att återges som en avdelare. Om värdet är falskt förväntar sig andra värden och renderar tomma.
  • Genom att lägga till ItemChecked egenskapen och funktionen för undermenyobjekt kan undermenyn inte stängas vid klickning.

Exempel

Exempel Power Fx formel för Items:

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

Stilegenskaper

Property Description
Theme Godkänner en JSON-sträng som genereras med Fluent UI temadesigner (windows.net). Om du lämnar detta tomt används standardstandarden som definieras av Power Apps. Om du lämnar detta tomt används standardstandarden som definieras av Power Apps. Se tema för vägledning om hur du konfigurerar.
Chevron Visa eller dölja nedpilen på rotknappen
IconColor Valfritt. färgen på ikonen på snabbmenyknappen.
HoverIconColor Valfritt. färgen på ikonen när du hovrar över snabbmenyknappen.
IconSize Valfritt. I bildpunkter visas ikonens storlek på snabbmenyknapp.
FontSize Valfritt. I bildpunkter visas text storlek på snabbmenyknapp.
FontColor Valfritt. färgen på text på snabbmenyknappen.
HoverFontColor Valfritt. färgen på text när du hovrar över snabbmenyknappen.
FillColor Valfritt. bakgrundsfärgen på snabbmenyknappen.
HoverFillColor Valfritt. bakgrundsfärgen när du hovrar över snabbmenyknappen.
TextAlignment Justeringen av knapptexten. Möjliga värden: Center, Vänster eller Höger
AccessibilityLabel Aria-etikett för skärmläsare

Händelseegenskaper

Property Description
InputEvent En händelse att skicka till kontrollen. t.ex. SetFocus. Se nedan.

Funktionssätt

Stödjer SetFocus som en InputEvent.

Konfigurera funktionen Vid val

Använd formeln Switch() i komponentens OnSelect egenskap om du vill konfigurera specifika åtgärder för respektive objekt genom att hänvisa till kontrollens markerade ItemKey som växelvärde.

Ersätt false-värdena med lämpliga uttryck i Power Fx-språket.

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

Ange fokus på kontrollen

När en ny dialog visas och standardfokus ska vara på kontrollen behövs en explicit uppsättning fokus.

För att göra anrop till indatahändelse kan du ställa in en kontextvariabel som är bunden till egenskapen Input Event till en sträng som börjar med SetFocus och följs av ett slumpmässigt element för att säkerställa att programmet upptäcker det som en förändring.

t. ex

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

Sammanhangsvariabeln ctxResizableTextareaEvent kan sedan vara bundna till Input Event egenskapen.

Begränsningar

Den här kodkomponenten kan endast användas i arbetsyteappar och anpassade sidor.