Del via

ContextMenu kontroll

  • Artikkel

En kontroll som brukes til å angi kommandoer.

Merk

Full dokumentasjons- og kildekode funnet i GitHub-kodekomponentrepositoriet.

ContextMenu-kontroll.

Bekrivelse

En hurtigmeny (ContextMenu) er en liste over kommandoer som er basert på konteksten for merking, musepeker eller tastaturfokus. De er en av de mest effektive og svært brukte kommandoflatene og kan brukes på ulike steder.

Denne kodekomponenten gir en wrapper rundt Fluent UI ContextualMenu-kontrollen bundet til en knapp for bruk i lerretsapper og på egendefinerte sider.

Egenskaper

Nøkkelegenskaper

Egenskap Bekrivelse
Items Handlingselementene som skal gjengis. Det første elementet regnes som rotelementet.

Items Egenskaper

Name Bekrivelse
ItemDisplayName Visningsnavnet på menyelementet.
ItemKey Nøkkelen som skal brukes for å angi hvilket element som er valgt, og når du legger til underordnede elementer. Nøklene må være unikt.
ItemEnabled Sett til Usann hvis alternativet er deaktivert.
ItemVisible Sett til Usann hvis alternativet ikke er synlig.
ItemChecked Satt til Sann hvis det er merket av for alternativet.
ItemIconName Fluent UI-ikonet som skal brukes (se Fluent UI-ikoner)
ItemIconColor Fargen som ikonet skal gjengis som (for eksempel navngitt, RGB eller heksadesimalverdi).
ItemIconOnly Ikke vis tekstetiketten – bare ikonet.
ItemHeader Gjengi elementet som en deloverskrift. Hvis det finnes elementer der ItemParentKey er satt til nøkkelen for dette elementet, legges de til som semantisk grupperte elementer under denne delen.
ItemTopDivider Gjengi et skille øverst i delen.
ItemDivider Gjengi elementet som et delskilletegn, eller hvis elementet er en topptekst ( ItemHeader = sann), styrer deretter om det skal gjengis en skillelinje nederst i delen.
ItemParentKey Gjengi alternativet som underordnet element for et annet alternativ.

Merk

  • ItemIconColor vil overstyre komponentens temaverdi og ignorere andre tilstandsfarger (f.eks. deaktivert).
  • ItemHeader og ItemDivider må settes til sann for å gjengi som en skillevegg. Hvis verdien er false, forventer den andre verdier og gjengis som tom.
  • Hvis du legger til ItemChecked-egenskapen og atferden til undermenyelementer, forhindrer du at undermenyen lukker ved klikking.

Eksempel

Eksempel Power Fx-formel for Items:

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

Stilegenskaper

Egenskap Bekrivelse
Theme Godtar en JSON-streng som genereres ved hjelp av Fluent UI Theme Designer (windows.net). Hvis du lar dette stå tomt, bruker du standardtemaet definert av Power Apps. Hvis du lar dette stå tomt, bruker du standardtemaet definert av Power Apps. Se Bruk av tema for hjelp til å konfigurere.
Chevron Vise eller skjule vinkeltegnet som vender ned, på rotknappen
IconColor Valgfritt. fargen på ikonet på kontekstmenyknappen.
HoverIconColor Valgfritt. fargen på ikonet når pekeren beveger seg over kontekstmenyknappen.
IconSize Valgfritt. I piksler, størrelsen på ikonet på kontekstmenyknappen.
FontSize Valgfritt. I piksler, størrelsen på teksten på kontekstmenyknappen.
FontColor Valgfritt. fargen på teksten på kontekstmenyknappen.
HoverFontColor Valgfritt. fargen på teksten når pekeren beveger seg over kontekstmenyknappen.
FillColor Valgfritt. bakgrunnsfargen på kontekstmenyknappen.
HoverFillColor Valgfritt. bakgrunnsfargen når pekeren beveger seg over kontekstmenyknappen.
TextAlignment Justeringen for knappeteksten. Mulige verdier: Midtstilt, Venstre eller Høyre
AccessibilityLabel Skjermleser aria-etikett

Hendelsesegenskaper

Egenskap Bekrivelse
InputEvent En hendelse for å sende kontrollen. For eksempel SetFocus. Se nedenfor.

Virkemåte

Støtter SetFocus som en InputEvent.

Konfigurere virkemåten Ved valg

Bruk Switch()-formelen i komponentens OnSelect-egenskap til å konfigurere bestemte handlinger for hvert element ved å henvise til kontrollens valgte ItemKey som bryterverdi.

Bytt ut false-verdiene med riktige uttrykk i Power Fx-språket.

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

Angi fokus på kontrollen

Når en ny dialogboks vises og standardfokuset skal være på kontrollen, er det nødvendig med et eksplisitt angitt fokus.

Hvis du vil utføre kall til inndatahendelsen, kan du angi en kontekstvariabel som er bundet til egenskapen Inndatahendelse , til en streng som starter med SetFocus og etterfulgt av et vilkårlig element, for å sikre at appen registrerer den som en endring.

F.eks.

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

Kontekstvariabelen ctxResizableTextareaEvent kan deretter være bundet til Input Event-egenskapen.

Begrensninger

Denne kodekomponenten kan bare brukes i lerretsapper og egendefinerte sider.