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.
Valitse Lisää > Syöte > Yhdistelmäruutu ja nimeä se "Combobox1".
Avaa näytön oikeanpuoleisessa Ominaisuudet-ruudussa Valitse tietolähde -luettelo (Items-kohdan vieressä) ja lisää tai valitse sitten tietolähde, kuten Tilit-taulukko.
Valitse samassa ruudussa Muokkaa (Kentät-kohdan vieressä).
Avaa Tieto-ruudussa Ensisijainen teksti -luettelo ja valitse sitten Ensisijainen nimi -sarake, joka näkyy Yhdistelmäruutu-ohjausobjektissa.
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
Määritä DefaultSelectedItems-ominaisuuden arvoksi tämä lauseke ja korvaa DataSource tietolähteesi nimellä:
First(DataSource)
(Valinnainen) Näytä valittu Tilin nimi -arvo selitteessä
Valitse Lisää > Tekstiselite ja valitse sitten Selite.
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.
Valitse Lisää > Syöte ja valitse sitten Yhdistelmäruutu.
Avaa näytön oikeanpuoleisessa Ominaisuudet-ruudussa Valitse tietolähde -luettelo (Items-kohdan vieressä) ja lisää tai valitse sitten tietolähde.
Valitse samassa ruudussa Muokkaa (Kentät-kohdan vieressä).
Avaa Tiedot-ruudussa Ensisijainen teksti -luettelo ja valitse sitten sarake, jonka haluat näkyvän Yhdistelmäruutu-ohjausobjektissa.
Määritä IsSearchable-ominaisuuden arvoksi epätosi.
Määritä SelectMultiple-ominaisuuden arvoksi epätosi.
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).