Yhdistelmäruutu-ohjausobjekti Power Appsissa

Ohjausobjekti, jonka avulla käyttäjät voivat tehdä valintoja annetuista vaihtoehdoista. Tukee hakua ja useita valintoja.

Kuvaus

Yhdistelmäruutu-ohjausobjektin avulla voit etsiä kohteita, jotka aiot valita. Haku suoritetaan palvelinpuolella käyttämällä SearchField-ominaisuutta, joten suuret tietolähteet eivät vaikuta suorituskykyyn.

Yksittäinen tai monivalintatila määritetään SelectMultiple-ominaisuudella.

Valittavia kohteita etsittäessä voit näyttää kullekin kohteelle yksittäisen tietoarvon, kaksi arvoa tai kuvan ja kaksi arvoa (henkilö) muokkaamalla tietoruudun asettelun asetuksia.

Pienessä näytössä katsottaessa nimikeluettelon pikaikkuna muuttuu koko näytön ohjausobjektiksi, mikä parantaa käytettävyyttä.

Huomautus

Jos haluat etsiä kohteita, joissa on numeroita, muunna numerot Tekstiksi Text()-toiminnolla. Kirjoita esimerkiksi Text(12345).

Rajoitukset

Yhdistelmäruutu-ohjausobjektilla on seuraavat rajoitukset:

  • Kun käytät yhdistelmäruudun ohjausobjektia valikoiman sisällä, sen valintoja ei säilytetä, kun käyttäjä selaa valikoimaa. Tämä ei ole ongelma, jos käytät yhdistelmäruudun ohjausobjektia sellaisen valikoiman sisällä, jota ei voi selata. Ratkaisua ei ole tällä hetkellä käytettävissä.

Henkilöiden valitsin

Voit käyttää Yhdistelmäruutu henkilöiden valintaan valitsemalla henkilö-mallin tietoruudun asettelun asetuksista ja määrittämällä toisiinsa liittyvät tieto-ominaisuudet näytettäväksi alla olevan henkilön osalta.

Tärkeimmät ominaisuudet

Items – Valintojen tekemisessä käytetyn tiedon lähde.

DefaultSelectedItems – Alkuperäiset valitut kohteet, ennen kuin käyttäjä on vuorovaikutuksessa ohjausobjektin kanssa.

Huomautus

Default-ominaisuus on vanhentunut, käytä sen sijaan ominaisuutta DefaultSelectedItems.

SelectedItems – Luettelo kohteista, jotka on valittu käyttäjän toiminnan perusteella.

SelectMultiple – Voiko käyttäjä valita yhden vai useita kohteita.

IsSearchable – Voiko käyttäjä etsiä kohteita ennen valitsemista.

Huomautus

IsSearchable voidaan ottaa käyttöön vain tietolähteessä, jossa on ainakin yksi tekstikenttä. Items-lauseke on voitava delegoida, jotta kysely voidaan delegoida haun aikana. Toisin sanoen Items-lausekkeissa olevia If-lausekkeita ei tueta.

SearchFields – Sen tietolähteen tietokentät, josta haetaan, kun käyttäjä syöttää tekstiä.

Huomautus

Jos haluat etsiä useista kentistä, määritä SearchFields-ominaisuus tässä muodossa: ["MyFirstColumn", "MySecondColumn"]. Vain tekstikenttiä tuetaan.

Lisäominaisuudet

AccessibleLabel – Näytönlukuohjelmien käyttämä selite.

BorderColor – Ohjausobjektin reunan väri.

BorderStyle – Onko ohjausobjektin reuna Yhtenäinen, Katkoviiva, Pisteviiva vai Ei mitään.

BorderThickness – Ohjausobjektin reunan paksuus.

DisplayFields – Luettelo kentistä, jotka näytetään jokaisesta haun palauttamasta kohteesta. Helpoin määrittää Ominaisuudet-välilehden tietoruudun kautta.

Huomautus

Jos haluat päivittää useita näyttökenttiä annetussa mallissa, määritä DisplayFields-ominaisuus tässä muodossa: ["MyFirstColumn", "MySecondColumn"].

DisplayMode – Salliiko ohjausobjekti käyttäjän syötettä (Muokkaa), vain tietojen tarkastelun (Näytä) vai onko se poissa käytöstä (Poistettu käytöstä).

FocusedBorderColor – Ohjausobjektin reunan väri, kun ohjausobjekti on kohdistettu.

FocusedBorderThickness – Ohjausobjektin reunan paksuus, kun ohjausobjekti on kohdistettu.

Height – Ohjausobjektin ylä- ja alareunan välinen etäisyys.

InputTextPlaceholder – Loppukäyttäjälle näytettävä ohjeteksti, jos kohteita ei ole valittu.

OnChange – Toiminnot, jotka tehdään, kun käyttäjä muuttaa valintaa.

OnNavigate – Toiminnot, jotka suoritettavat, kun käyttäjä valitsee kohteen.

OnSelect – Toiminnot, jotka suoritetaan, kun käyttäjä napauttaa tai valitsee ohjausobjektin.

TabIndex – Näppäimistön siirtymisjärjestys suhteessa muihin ohjausobjekteihin.

Visible – Onko ohjausobjekti näkyvissä vai piilossa.

Width – Ohjausobjektin vasemman ja oikean reunan välinen etäisyys.

X – Ohjausobjektin vasemman reunan ja pääsäilön (tai näytön, jos pääsäilöä ei ole) vasemman reunan välinen etäisyys.

Y – ohjausobjektin yläreunan ja pääsäilön yläreunan välinen etäisyys (tai näytön, jos ohjausobjektilla ei ole pääsäilöä).

Huomautus

Pikaikkunan reunaviivan ominaisuuksia hallitaan Border-ominaisuuksilla.

Esimerkkejä

Perusyhdistelmäruutu

Tämän esimerkin vaiheet koskevat kaikkia tietolähteitä, jotka tarjoavat taulukoita, mutta jos haluat tehdä nämä toimet tarkasti, käytä ympäristöä, jossa on Microsoft Dataverse -tietokanta, jossa on mallitiedot.

  1. Valitse Lisää > Syöte > Yhdistelmäruutu ja nimeä se "Combobox1".

  2. Avaa näytön oikeanpuoleisessa Ominaisuudet-ruudussa Valitse tietolähde -luettelo (Items-kohdan vieressä) ja lisää tai valitse sitten tietolähde, kuten Tilit-taulukko.

  3. Valitse samassa ruudussa Muokkaa (Kentät-kohdan vieressä).

  4. Avaa Tieto-ruudussa Ensisijainen teksti -luettelo ja valitse sitten Ensisijainen nimi -sarake, joka näkyy Yhdistelmäruutu-ohjausobjektissa.

  5. Pidä Alt-näppäintä painettuna ja avaa Yhdistelmäruutu-ohjausobjekti valitsemalla alanuoli.

    Ohjausobjekti näyttää määrittämäsi ensisijaisen nimen tiedot määrittämässäsi tietolähteen tiedoissa.

(Valinnainen) Näytä ensimmäinen tietue oletusarvoisesti

  1. Määritä DefaultSelectedItems-ominaisuuden arvoksi tämä lauseke ja korvaa DataSource tietolähteesi nimellä:

    First(DataSource)
    

(Valinnainen) Näytä valittu Tilin nimi -arvo selitteessä

  1. Valitse Lisää > Tekstiselite ja valitse sitten Selite.

  2. Määritä Text-ominaisuuden arvoksi tämä lauseke ja korvaa teksti seuraavalla kaavalla:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
    

    Huomautus

    Jos-lause tarkistaa, miten valitut kohteet voivat olla olemassa, ja näyttää ne pilkuilla erotutun selitteenä tai "EI VALITTUA KOHDETTA" -sanomassa, kun ne ovat tyhjiä.

Simuloi yksinkertaista avattavan valikon toimintaa

Määrittämällä IsSearchable-arvoksi epätosi ja SelectMultiple epätosi-asetukseksi voit saavuttaa saman avattavan valikon toiminnon.

  1. Valitse Lisää > Syöte ja valitse sitten Yhdistelmäruutu.

  2. Avaa näytön oikeanpuoleisessa Ominaisuudet-ruudussa Valitse tietolähde -luettelo (Items-kohdan vieressä) ja lisää tai valitse sitten tietolähde.

  3. Valitse samassa ruudussa Muokkaa (Kentät-kohdan vieressä).

  4. Avaa Tiedot-ruudussa Ensisijainen teksti -luettelo ja valitse sitten sarake, jonka haluat näkyvän Yhdistelmäruutu-ohjausobjektissa.

  5. Määritä IsSearchable-ominaisuuden arvoksi epätosi.

  6. Määritä SelectMultiple-ominaisuuden arvoksi epätosi.

  7. Pidä Alt-näppäintä painettuna ja avaa Yhdistelmäruutu-ohjausobjekti valitsemalla alanuoli.

    Ohjausobjekti näyttää tiedot määritetyn tietolähteen määritetystä sarakkeesta.

    Huomautus

    Etsi kohteita -teksti on kadonnut, ja voit valita vain yhden kohteen.

Helppokäyttötoimintojen ohjeet

Colorkontrasti

Seuraavien kohteiden välillä on oltava asianmukainen värikontrasti:

  • ChevronFill ja ChevronBackground
  • ChevronHoverFill ja ChevronHoverBackground
  • SelectionColor ja SelectionFill
  • SelectionFill ja Fill
  • SelectionTagColor ja SelectionTagFill

Tämä tulee värikontrastin vakiovaatimusten lisäksi.

Näytönlukuohjelman tuki

  • AccessibleLabel on oltava läsnä.

    Huomautus

    Kosketusnäytöissä näytönlukuohjelman käyttäjät voivat siirtyä yhdistelmäruudun sisällössä peräkkäisessä järjestyksessä. Yhdistelmäruutu toimii painikkeena, joka näyttää tai piilottaa sen sisällön, kun se on valittuna.

Näppäimistön tuki

  • TabIndex-kohteen on oltava nolla tai yli, jotta näppäimistön käyttäjät voivat siirtyä siihen.

  • Kohdistuksen ilmaisinten on oltava selvästi näkyvissä. Voit tehdä tämän kohteiden FocusedBorderColor ja FocusedBorderThickness avulla.

    Huomautus

    Voit sarkainnäppäimellä siirtyä yhdistelmäruutuun tai siitä pois. Voit nuolinäppäimillä siirtyä yhdistelmäruudun sisällössä. Voit Escape-näppäimellä sulkea avattavan valikon, kun se on avattuna.

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).