ContextMenu hallinta

Ohjausobjektilla syötetään komentoja.

Muistiinpano

Täydellinen dokumentaatio ja lähdekoodi löytyvät koodikomponenttien GitHub-säilöstä.

Description

Tilannevalikko (ContextMenu) luettelo komentoja, ja nämä komennot määräytyvät valintakontekstin, hiiren osoittimen kohteen päällä pitämisen tai näppäimistön kohdistuksen perusteella. Ne ovat yksi tehokkaimmista ja eniten käytetyistä komentopinnoista, ja niitä voi käyttää eri paikoissa.

Tämä koodikomponentti paketoi Fluent UI ContextualMenu -ohjausobjektin, joka on sidottu pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla käytettävään painikkeeseen.

Ominaisuudet

Tärkeimmät ominaisuudet

Ominaisuus	Description
Items	Hahmonnevat toimintokohteet. Ensimmäinstä kohdetta kutsutaan juurinimikkeeksi.

Items Majoituspaikkaa

Name	Description
ItemDisplayName	Valikkokohteen näyttönimi.
ItemKey	Avaimen avulla ilmaistaan, mikä kohde valitaan ja milloin lisätään alikohteita. Avaimien on oltava yksilöiviä.
ItemEnabled	Epätodeksi määrittäminen poistaa vaihtoehdon käytöstä.
ItemVisible	Määritä arvoksi false, jos vaihtoehto ei ole näkyvissä.
ItemChecked	Määritä arvoksi tosi, jos vaihtoehto on valittu.
ItemIconName	Käytettävä Fluent UI -kuvake (lisätietoja on kohdassa Fluent UI -kuvakkeet)
ItemIconColor	Kuvakkeen hahmonnettava väri (esim. nimetty väri tai RGB- tai heksadesimaaliarvo).
ItemIconOnly	Älä näytä tekstiotsikkoa – vain kuvake.
ItemHeader	Hahmonna kohde osion otsikkona. Jos sinulla on kohteita, joiden ItemParentKey on määritetty tämän kohteen avaimeksi, ne lisätään tähän osioon semanttisesti ryhmiteltyinä kohteina.
ItemTopDivider	Hahmonna osion ylälaidassa oleva jakaja.
ItemDivider	Hahmonna kohde osioiden jakajaksi – tai jos kohde on otsikko (ItemHeader = true), määrittää, hahmonnetaanko osion alalaidassa oleva jakaja.
ItemParentKey	Hahmonna vaihtoehto toisen vaihtoehdon alikohteeksi.

Muistiinpano

• ItemIconColor ohittaa komponentin Teema-arvon ja ohittaa muut tilavärit (esim. pois käytöstä).
• ItemHeader ja ItemDivider se on asetettava tosiksi, jotta se voidaan esittää jakajana. Jos arvoksi on määritetty epätosi, se odottaa muita arvoja ja hahmonnetaan tyhjänä.
• ItemChecked-ominaisuuden ja alivalikon toimintatapojen lisääminen estää alivalikkoa sulkeutumasta napsautuksesta.

Esimerkki:

Esimerkki Power Fx -kaavasta Items-kohteille:

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

Tyylin ominaisuudet

Ominaisuus	Description
Theme	Hyväksyy Fluent UI Theme Designer (windows.net) -sovelluksella luodun JSON-merkkijonon. Tämän kentän jättäminen tyhjäksi käyttää Power Appsin määrittämää oletusteemaa. Tämän kentän jättäminen tyhjäksi käyttää Power Appsin määrittämää oletusteemaa. Katso määritysohjeet kohdasta Teemat.
Chevron	Näytä tai piilota juuripainikken alaspäin osoittava nuoli
IconColor	Valinnainen. pikavalikon painikkeen kuvakkeen väri.
HoverIconColor	Valinnainen. pikavalikon painikkeen kuvakkeen väri, kun kohdistin on painikkeen päällä.
IconSize	Valinnainen. Pikavalikon painikkeen kuvakkeen koko pikseleinä.
FontSize	Valinnainen. Pikavalikon painikkeen tekstin koko pikseleinä.
FontColor	Valinnainen. pikavalikon painikkeen tekstin väri.
HoverFontColor	Valinnainen. pikavalikon painikkeen tekstin väri, kun kohdistin on painikkeen päällä.
FillColor	Valinnainen. pikavalikon painikkeen taustaväri.
HoverFillColor	Valinnainen. pikavalikon painikkeen taustaväri, kun kohdistin on painikkeen päällä.
TextAlignment	Painikkeen tekstin tasaus. Sallitut arvot: Center, Left tai Right
AccessibilityLabel	Näytönlukuohjelman aria-otsikko

Tapahtuman ominaisuudet

Ominaisuus	Description
InputEvent	Ohjausobjektiin lähetettävä tapahtuma. Esimerkiksi SetFocus. Lisätietoja alla.

Toiminta

Tukee SetFocus-tapahtumaa InputEvent-tapahtumana.

Muutoksen yhteydessä -toiminnan määrittäminen

Switch()-kaavan käyttäminen komponentin OnSelect-ominaisuudessa määrittää kunkin kohteen toiminnot viittaamalla ohjausobjektin valittuun ItemKey-ominaisuuteen kytkimen arvona.

Korvaa false-arvot sopivilla Power Fx -kielen lausekkeilla.

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

Kohdistuksen asettaminen ohjausobjektiin

Kun uusi valintaikkuna tulee näkyviin ja kohdistuksen tulisi olla oletusarvoisesti ohjausobjektissa, kohdistus täytyy määrittää erikseen.

Jos haluat tehdä kutsuja syötetapahtumaan, voit asettaa Input Event -ominaisuuteen sidotun kontekstimuuttujan merkkijonoksi, joka alkaa SetFocus ja jatkuu satunnaisella elementillä, jotta sovellus havaitsee sen varmasti muutoksena.

Onko

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

Tämän jälkeen kontekstimuuttuja ctxResizableTextareaEvent sidottaisiin ominaisuuteen Input Event.

Rajoitukset

Tätä koodikomponenttia voidaan käyttää vain pohjaan perustuvissa sovelluksissa ja mukautetuilla sivuilla.