ContextMenu kontrol

Et kontrolelement, der bruges til at angive kommandoer.

Bemærk

Fuld dokumentation og kildekode fundet i GitHub-kodekomponenters lager.

Beskrivelse

En kontekstafhængig menu (ContextMenu) er en liste over kommandoer, der er baseret på konteksten af markering, pegning med musen eller tastaturfokus. Det er en af de mest effektive og meget brugte kommandoflader og kan bruges forskellige steder.

Denne kodekomponent tilføjer en ombryder rundt om kontrolelementet på Fluent UI ContextualMenu, der er bundet til en knap til brug i lærredapps og på brugerdefinerede sider.

Egenskaber

Nøgleegenskaber

Egenskab	Beskrivelse
Items	De handlingspunkter, der skal gengives. Det første element opfattes som rodelementet.

Items Egenskaber

Navn	Beskrivelse
ItemDisplayName	Vist navn på menuelementet.
ItemKey	Den tast, der skal bruges til at angive, hvilket element der er valgt, og når der tilføjes underelementer. Tasterne skal være entydige.
ItemEnabled	Angiv til false, hvis indstillingen er deaktiveret.
ItemVisible	Angiv til false, hvis indstillingen ikke er synlig.
ItemChecked	Angiv til true, hvis indstillingen er markeret.
ItemIconName	Det ikon på Fluent-brugergrænsefladen, der skal bruges (se Ikoner på Fluent-brugergrænsefladen)
ItemIconColor	Den farve, ikonet skal gengives som (f.eks. navngivet, rgb eller hexadecimal værdi).
ItemIconOnly	Vis ikke tekstetiketten – kun ikonet.
ItemHeader	Gense elementet som en sektionsoverskrift. Hvis der er elementer, hvor deres ItemParentKey er angivet til nøglen til dette element, tilføjes de som semantisk grupperede elementer under denne sektion.
ItemTopDivider	Gengive en skillelinje øverst i sektionen.
ItemDivider	Gense elementet som en sektionsdeler – eller hvis elementet er en overskrift (ItemHeader = true), og kontroller derefter, om der skal gengives en opdeling nederst i sektionen.
ItemParentKey	Gengiv indstillingen som underordnet element til en anden indstilling.

Bemærk

• ItemIconColor tilsidesætter komponentens temaværdi og ignorerer andre tilstandsfarver (f.eks. deaktiveret).
• ItemHeader og ItemDivider skal indstilles til sand for at gengive som en skillelinje. Hvis de angives til false, forventer den andre værdier og gengiver dem tomme.
• Hvis du tilføjer ItemChecked-egenskaben og funktionsmåden for undermenuelementer, kan undermenuen ikke lukkes med et klik.

Eksempel

Eksempel Power Fx-formel for Items:

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

Egenskaber for typografi

Property	Beskrivelse
Theme	Accepterer en JSON-streng, der oprettes ved hjælp af Fluent UI Theme-designer (windows.net). Hvis du lader dette være tomt, vises standardtemaet, defineret af Power Apps. Hvis du lader dette være tomt, vises standardtemaet, defineret af Power Apps. Se tema for, hvordan du konfigurerer.
Chevron	Få vist eller skjule den nedadvendte pil på rodknappen
IconColor	Valgfrit. farven på det ikon, der vises på menuknappen i konteksten.
HoverIconColor	Valgfrit. farven på det ikon, når der bevæges hen over menuknappen i konteksten.
IconSize	Valgfrit. I pixel er størrelsen på ikonet på menuknappen i konteksten.
FontSize	Valgfrit. I pixel er størrelsen på teksten på menuknappen i konteksten.
FontColor	Valgfrit. farven på teksten, der vises på menuknappen i konteksten.
HoverFontColor	Valgfrit. farven på teksten, når der bevæges hen over menuknappen i konteksten.
FillColor	Valgfrit. farven på baggrunden, der vises på menuknappen i konteksten.
HoverFillColor	Valgfrit. farven på baggrunden, når der bevæges hen over menuknappen i konteksten.
TextAlignment	Teksten til justeringsknappen. Mulige værdier: Center, Venstre eller Højre
AccessibilityLabel	Aria-label til skærmlæsere

Egenskaber for hændelse

Egenskab	Beskrivelse
InputEvent	En hændelse, der skal sendes til kontrolelementet. F.eks. SetFocus. Se nedenfor.

Adfærd

Understøtter SetFocus som en InputEvent.

Konfigurere funktionsmåden "Ved valg"

Brug formlen Switch() i komponentens egenskab OnSelect til at konfigurere specifikke handlinger for hvert element ved at henvise til kontrolelementets valgte ItemKey som parameterværdi.

Erstat false-værdierne med de relevante udtryk på Power Fx-sproget.

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

Angivelse af fokus på kontrolelementet

Når der vises en ny dialogboks, og standardfokus bør være på kontrolelementet, skal der være eksplicit fokus på det indstillede objekt.

Hvis du vil foretage opkald til inputhændelsen, kan du angive en kontekstvariabel, der er bundet til egenskaben Inputhændelse SetFocus, til en streng, der starter med og efterfølges af et tilfældigt element for at sikre, at appen registrerer den som en ændring.

F.eks.

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

Kontekstvariablen ctxResizableTextareaEvent er herefter bundet til egenskaben Input Event.

Begrænsninger

Denne kodekomponent kan kun bruges i lærredapps og brugerdefinerede sider.