Jaa

ContextMenu hallinta

  • Artikkeli

Ohjausobjektilla syötetään komentoja.

Muistiinpano

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

ContextMenu-ohjausobjekti

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 muut tilavärit (esim. poistettu käytöstä).
  • ItemHeader ja ItemDivider sen arvo on määritettävä tosi, jotta se voidaan tehdä jakajaksi. 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.