Dalintis per


ContextMenu kontrolė

Valdiklis, naudojamas įvesties komandoms.

Pastaba.

Visą instrukciją ir šaltinio kodą galima rasti „GitHub“ kodo komponentų saugykloje.

Aprašą

Kontekstinis meniu (ContextMenu) – tai komandų, pagrįstų pasirinkimo, pelės žymeklio užvedimo vietos arba klaviatūros veikimo vietos kontekstu, sąrašas. Tai vienas iš efektyviausių ir itin naudojamų komandų paviršių, kuriuos galima naudoti įvairiose vietose.

Šis kodo komponentas apdengia „Fluent UI ContextualMenu” valdiklio jungtį su mygtuku, apribotu naudoti drobės programose ir pasirinktiniuose puslapiuose.

Ypatybės

Pagrindinės ypatybės

Ypatybė Aprašą
Items Atvaizduotini veiksmo elementai. Pirmasis elementas laikomas šakniniu elementu.

Items Apgyvendinimo įstaigos

Pavadinimą Aprašą
ItemDisplayName Rodomas meniu elemento pavadinimas.
ItemKey Raktas, naudojamas norint nurodyti, kuris elementas pasirinktas, ir įtraukiant antrinius elementus. Raktai turi būti unikalūs.
ItemEnabled Jei parinktis išjungta, nustatoma kaip Klaidinga.
ItemVisible Jei parinktis nematoma, nustatoma kaip Klaidinga.
ItemChecked Jei parinktis pažymėta, nustatykite kaip teisinga.
ItemIconName Naudotina „Fluent UI“ piktograma (žr. „Fluent UI“ piktogramos)
ItemIconColor Spalva, kuria atvaizduotina piktograma (pvz., pavadinta, rgb ar hex reikšmė).
ItemIconOnly Nerodyti teksto žymos – tik piktograma.
ItemHeader Atvaizduoti elementą kaip skyriaus antraštę. Jei yra elementų, kurių ItemParentKey nustatytas šio elemento raktui, jie įtraukiami į šį skyrių kaip semantiškai sugrupuoti elementai.
ItemTopDivider Atvaizduoti skyriklį šio skyriaus viršuje.
ItemDivider Rodyti elementą kaip skyriaus skyriklį arba, jei elementas yra antraštė (ItemHeader = teisinga), tada valdyti, ar skyriaus apačioje turi būti rodomas skyriklis.
ItemParentKey Parinkties atvaizdavimas kaip antrinio kitos parinkties elemento.

Pastaba.

  • ItemIconColor perrašys komponento temos reikšmę ir nepaisys kitų būsenos spalvų (pvz., išjungta).
  • ItemHeader ir ItemDivider turi būti nustatytas kaip teisingas, kad būtų pateiktas kaip daliklis. Jei nustatyta kaip klaidinga, bus tikimasi kitų reikšmių ir bus atvaizduojama kaip tuščia.
  • Pridėjus ItemChecked submeniu elementų ypatybę ir elgesį, submeniu nebus uždarytas spustelėjus.

Pavyzdžiui

„Power Fx” formulės pavyzdys Items:

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

Stiliaus ypatybės

Ypatybė Aprašą
Theme Priima JSON eilutę, sugeneruotą naudojant „Fluent UI“ temų dizaino įrankį (windows.net). Palikus tuščią, bus naudojama numatytoji tema, apibrėžta „Power Apps“. Palikus tuščią, bus naudojama numatytoji tema, apibrėžta „Power Apps“. Norėdami gauti pagalbos, kaip tai sukonfigūruoti, žr. temos
Chevron Rodyti arba slėpti šakninio mygtuko Ševrono rodyklę žemyn
IconColor Pasirenkama. kontekstinio meniu mygtuko piktogramos spalva.
HoverIconColor Pasirenkama. kontekstinio meniu mygtuko piktogramos spalva, kai virš jo užvestas pelės žymeklis.
IconSize Pasirenkama. Pikseliais, kontekstinio meniu mygtuko piktogramos dydis.
FontSize Pasirenkama. Pikseliais, kontekstinio meniu mygtuko teksto dydis.
FontColor Pasirenkama. kontekstinio meniu mygtuko teksto spalva.
HoverFontColor Pasirenkama. kontekstinio meniu mygtuko teksto spalva, kai virš jo užvestas pelės žymeklis.
FillColor Pasirenkama. kontekstinio meniu mygtuko fono spalva.
HoverFillColor Pasirenkama. kontekstinio meniu mygtuko fono spalva, kai virš jo užvestas pelės žymeklis.
TextAlignment Mygtuko teksto lygiuotė Galimos reikšmės: centras, kairė arba dešinė
AccessibilityLabel Ekrano skaitytuvo „aria“ žyma

Renginio ypatybės

Ypatybė Aprašą
InputEvent Įvykis, kuris bus siunčiamas į valdiklį. Pvz., SetFocus. Žr. toliau.

Elgsena

Palaiko SetFocus kaip InputEvent.

„On Select“ veikimo konfigūravimas

Naudokite Switch() formulę komponento OnSelect ypatybėje, kad sukonfigūruotumėte konkrečius kiekvieno elemento veiksmus naudodami valdiklio pasirinktą ItemKey kaip perjungimo reikšmę.

Pakeiskite false reikšmes atitinkamomis Power Fx kalbos išraiškomis.

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

Valdiklio fokusavimo nustatymas

Kai rodomas naujas dialogo langas ir numatytoji įvesties vieta turi būti valdiklis, reikės aiškiai nustatyti įvesties vietą.

Norėdami iškviesti įvesties įvykį, galite nustatyti konteksto kintamąjį, kuris susijęs su įvesties įvykio ypatybe, eilutėje, kuri prasideda SetFocus ir po kurios eina atsitiktinis elementas, norint užtikrinti, kad programa tai aptiks kaip pakeitimą.

Pvz.,

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

Konteksto kintamasis ctxResizableTextareaEvent tada bus susietas su ypatybės Input Event ypatybėmis.

Apribojimai

Šį kodo komponentą galima naudoti tik drobės programose ir pasirinktiniuose puslapiuose.