Megosztás a következőn keresztül:

ContextMenu vezérlő

  • Cikk

Parancsok bevitelére használt vezérlő.

Feljegyzés

A teljes dokumentáció és a forráskód a(z) GitHub kódösszetevő-adattárban található.

ContextMenu vezérlő.

Description

A környezeti menü (ContextMenu) olyan parancsok listája, amelyek a kiválasztás, az egérrel való rámutatás vagy a billentyűzetfókusz környezetén alapulnak. Ez az egyik leghatékonyabb és leggyakrabban használt parancsfelület, amely különböző helyeken is használható.

Ez a kódösszetevő egy burkolót biztosít a Fluent UI ContextualMenu vezérlő körül, amely egy gombhoz van rendelve a vászonalapú alkalmazásokban és egyéni oldalakon való használatra.

Tulajdonságok

Fő tulajdonságok

Tulajdonság Description
Items A renderelendő műveleti elemek. Az első elem a gyökérszintű elem.

Items Tulajdonságok

Name Description
ItemDisplayName A menüelem megjelenítendő neve.
ItemKey A kijelölt elem jelzésére és alelemek hozzáadásakor használt kulcs. A kulcsnak egyedinek kell lennie.
ItemEnabled Állítsa hamis értékre, ha a beállítás nem elérhető.
ItemVisible Állítsa hamis értékre, ha a beállítás nem látható.
ItemChecked Állítsa igaz értékre, ha a beállítás be van jelölve.
ItemIconName A használandó Fluent UI ikonja (lásd: Fluent UI ikonok)
ItemIconColor Az ikon rendereléséhez használt szín (pl. a név, vagy az rgb vagy hexadecimális érték).
ItemIconOnly Ne jelenjen meg a szöveges címke – csak az ikon.
ItemHeader Az elem megjelenítése szakaszfejlécként. Ha vannak olyan elemek, amelyek ItemParentKey eleme az adott elem kulcsának vannak beállítva, akkor szemantikusan csoportosított elemként lesznek hozzáadva ezek a szakaszhoz.
ItemTopDivider Elválasztó megjelenítése a szakasz tetején.
ItemDivider Az elem megjelenítése szakaszelválasztóként – ha az elem fejléc (ItemHeader = igaz), akkor azt szabályozza, hogy az elválasztót a rendszer a szakasz alján jelenítse-e meg.
ItemParentKey A lehetőség megjelenítése másik lehetőség gyermekelemeként.

Feljegyzés

  • A ItemIconColor felülbírálja az összetevő Téma értékét, és figyelmen kívül hagyja az egyéb állapotszíneket (pl. le van tiltva).
  • ItemHeaderItemDivider értéke igaz kell legyen elválasztóként való megjelenítéshez. Ha a beállítás hamis, más értékekre számít, és üresen jelenik meg.
  • Az almenüelemek tulajdonságának és viselkedésének hozzáadása ItemChecked megakadályozza az almenü bezárását kattintáskor.

Példa

Példa Power Fx-képlet (ehhez: Items):

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

Stílus tulajdonságai

Tulajdonság Description
Theme A Fluent UI tématervező (windows.net) segítségével létrehozott JSON-sztringet fogad el. Ha üresen hagyja az adott témát, a Power Apps által alapértelmezett téma jelenik meg. Ha üresen hagyja az adott témát, a Power Apps által alapértelmezett téma jelenik meg. Lásd a téma témakört, ha tudni szeretné, hogyan lehet ezt beállítani.
Chevron Lefelé mutató sávnyíl megjelenítése vagy elrejtése a gyökérgombon
IconColor Opcionális. a helyi menü gombjához tartozó ikon színe.
HoverIconColor Opcionális. a helyi menü gombjához tartozó ikon színe, amikor az egérmutató fölé viszik.
IconSize Opcionális. A helyi menü gombjához tartozó ikon mérete képpontban.
FontSize Opcionális. A helyi menü gombjához tartozó szöveg mérete képpontban.
FontColor Opcionális. a helyi menü gombjához tartozó szöveg színe.
HoverFontColor Opcionális. a helyi menü gombjához tartozó szöveg színe, amikor az egérmutató fölé viszik.
FillColor Opcionális. a helyi menü gombjának háttérszíne.
HoverFillColor Opcionális. a helyi menü gombjának háttérszíne, amikor az egérmutató fölé viszik.
TextAlignment A gomb feliratának igazítása. Lehetséges értékek: Közép, Bal vagy Jobb
AccessibilityLabel Képernyőolvasói területcímke

Esemény tulajdonságai

Tulajdonság Description
InputEvent A vezérlőnek küldendő esemény. Például SetFocus. Lásd alább.

Viselkedésmód

Támogatja a SetFocus-t mint InputEvent.

Konfigurálja a „Kiválasztáskor” viselkedést

A Switch() képlettel az összetevő OnSelect tulajdonságában úgy konfigurálhat egyéni műveleteket az egyes elemekhez, hogy a vezérlő kiválasztott ItemKey értékére hivatkozik a váltási érték tekintetében.

Cserélje le a false értékeket a megfelelő kifejezésekkel a Power Fx nyelven.

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

Fókusz beállítása a vezérlőre

Amikor új párbeszéd jelenik meg, és az alapértelmezett fókusznak a vezérlőelemen kell lennie, kifejezett beállításra van szükség.

A bemeneti esemény hívásához beállíthat egy kontextusváltozót, amely az Input Event tulajdonsághoz van kötve egy sztringre, amely SetFocus elemmel kezdődik, majd egy véletlenszerű elem következik, hogy az alkalmazás változásként észlelje azt.

Például.

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

A környezeti ctxResizableTextareaEvent változó ezután hozzáfűzhető az Input Event tulajdonsághoz.

Korlátozások

Ez a kódösszetevő csak vászonalapú alkalmazásokban és egyéni oldalakon használható.