Kortti-ohjausobjekti Power Appsissa

Käsittää näytön ja muokkauksen Näytä lomake- tai Muokkaa lomaketta -ohjausobjektin yhdessä kentässä.

Kuvaus

Näytä lomake- ja Muokkaa lomaketta -ohjausobjektit toimivat säilöinä kokonaisten tietueiden näyttöä ja tarkastelua varten. Jokaiseen säilöön mahtuu joukko Kortti-ohjausobjekteja, jotka näyttävät yksittäisiä kenttiä tai tarjoavat tavan päivittää kyseiset kentät. Jokaisessa kortissa on DataField-ominaisuus, joka määrittää, mihin tietueen kenttään se vaikuttaa.

Ennalta määritetyt kortit on määritetty eri tietotyyppejä ja käyttäjäkokemuksia varten. Käytettävissä saattaa olla esimerkiksi kortti, joka muokkaa numerokenttää käyttäen Tekstisyöte-ohjausobjektia. Tämä sopii hyvin käytettäväksi näppäimistön avulla. Toinen kortti saattaa sen sijaan tukea numeron muokkaamista Liukusäädin-ohjausobjektin avulla. Kun lomakkeen ohjausobjekti on valittuna, voit helposti valita kortin oikeanpuoleisessa ruudussa kentän perusteella.

Itse kortit sisältävät ohjausobjekteja. Kortin ohjausobjektit määrittävät yhden kentän näyttöön ja muokkaamiseen liittyvän käyttökokemuksen. Esimerkiksi numerokortti voi koostua Selite-ohjausobjektista, jolla määritetään kentän näyttönimi ja Tekstisyöte-ohjausobjektista, joka tarjoaa editorin kentän arvon muokkaamista varten. Kortissa voi olla myös Selite-ohjausobjekti, joka näyttää mahdolliset validointivirheet, sekä Selite-ohjausobjekti tavalliselle tähdelle, joka ilmaisee, että kentän täyttämistä vaaditaan.

Voit mukauttaa ennalta määritetyn kortin ohjausobjekteja muuttamalla sen kokoa, siirtämällä sitä, piilottamalla sen, lisäämällä siihen ohjausobjekteja ja tekemällä muita muutoksia. Voit myös aloittaa täysin tyhjällä kortilla, ”mukautettavalla kortilla”, johon lisäät ohjausobjekteja alusta alkaen.

Ennalta määritetyt kortit on oletusarvoisesti lukittu. Voit muokata vain lukitun kortin tiettyjä ominaisuuksia tai ohjausobjekteja, etkä voi poistaa lukittua korttia. Voit nähdä, onko kortti lukittu, ja poistaa lukituksen käytöstä Lisäasetukset-näkymän Näkymä-välilehdessä. Jos ominaisuus on lukittu eikä sitä voi muokata, sen nimen vieressä näkyy lukkokuvake. Kortin lukituksen poistaminen on kehittynyt toimenpide ja sitä tulee käyttää varoen, koska kortin automaattinen kaavan muodostus ei enää toimi etkä voi lukita korttia uudelleen.

Lomakkeen säilössä on käytettävissä ThisItem-tietue, joka sisältää kaikki tietueen kentät. Esimerkiksi kortin Default-ominaisuuden arvoksi asetetaan usein ThisItem.FieldName.

Voit käyttää Parent viittausta määrittämään ohjausobjektin viittaamaan kortin ominaisuuksiin. Ohjausobjektin tulisi esimerkiksi käyttää Parent.Default-arvoa kentän alkuperäisen tilan lukemiseen tietolähteestä. Jos käytät Parent sen sijaan, että käyttäisit tietoa suoraan, kortti on tiiviimpi ja voit muuttaa sen eri kenttään rikkomatta sisäisiä kaavoja.

Katso kohdasta Tutustu tietokortteihin esimerkkejä korttien mukauttamisesta, lukituksen poistamisesta ja korttien luomisesta.

Tärkeimmät ominaisuudet

DataField – Ilmaisee sen tietueessa olevan kentän nimen, jonka tämä kortti näyttää ja jota se muokkaa.

• Määritä nimi staattisena merkkijonona, joka on kirjoitettu lainausmerkkeihin (esimerkiksi "Name"), ei kaavaa.
• Poista kortin sidonta määrittämällä sen DataField-ominaisuus tyhjäksi. Sitomattoman kortin ominaisuudet Valid ja Update ohitetaan.

Default – Ilmaisee ohjausobjektin alkuarvon ennen käyttäjän siihen tekemiä muutoksia.

• Määritä tämän ominaisuuden arvoksi kortin kullekin ohjausobjektille Parent.Default viittaamaan tietolähteen mukaiseen kentän oletusarvoon. Voit esimerkiksi määrittää liukusäätimen Default-ominaisuuden arvoksi Parent.Default sen varmistamiseksi, että käyttäjä aloittaa käyttämällä kyseisen liukusäätimen yleistä arvoa.

DisplayMode – Arvo voi olla Muokkaa, Näytä tai Ei käytössä. Määrittää kortissa olevan ohjausobjektin näyttötilan: onko käyttäjällä oikeus muokata (Muokkaa) tai vain tarkastella tietoja (Näytä) vai onko ominaisuus kokonaan poissa käytöstä (Ei käytössä).

• Sallii yksittäisen kortin käyttämisen lomakkeiden muokkaamiseen ja tarkastelemiseen muokkaamalla tätä ominaisuutta, joka on sidottu oletusarvoisesti lomakkeen käyttäytymiseen.
• Näytä-tilassa alitason ohjausobjektit, kuten Tekstisyöte, Avattava ja Päivämäärävalitsin näyttävät vain tekstiarvon. Vuorovaikutteisia elementtejä tai muotoiluja ei esitetä.

DisplayName – Ilmaisee kentän kutsumanimen tietolähteessä.

• DataSourceInfo-funktio tarjoaa metatietoja tietolähteestä.
• Kortin ohjausobjekteille kannattaa käyttää arvoa Parent.DisplayName viittaamaan kentän nimeen.

Error – Käyttäjäystävällinen virhesanoma, joka näytetään, kun tämän kentän vahvistus epäonnistuu.

• Tämä ominaisuus määritetään, kun SubmitForm kutsutaan.
• Viestissä kuvaillaan vahvistusongelmia, jotka perustuvat tietolähteen metatietoihin ja kortin Required-ominaisuuden tarkistukseen.

Required – Ilmaisee, onko kortilla oltava arvo tietolähteen kenttää muokattaessa.

• DataSourceInfo-funktio tarjoaa tarvittavia metatietoja tietolähteestä.
• Kortin ohjausobjekteille tulisi käyttää arvoa Parent.Required sen määrittämiseksi, onko kortin kyseinen arvo pakollinen.

Update – Value, joka kirjoitetaan takaisin kentän tietolähteeseen.

• Käytä tämän ominaisuuden kaavaa noutaaksesi arvoja kortin muokkausohjausobjekteista takaisin tietolähteeseen kirjoittamista varten. Voit esimerkiksi määrittää kortin Update-ominaisuuden arvoksi Slider.Value, jolloin tietolähde päivitetään kyseisen kortin liukusäätimen arvolla.

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

WidthFit – kasvaako ohjausobjekti automaattisesti vaakasuunnassa täyttämään tyhjän tilan säilön ohjausobjektissa, kuten Muokkaa lomaketta -ohjausobjektissa. Jos monelle kortille on asetettu tämän ominaisuuden arvoksi tosi, tyhjä tila jaetaan niiden kesken. Lisätietoja on kohdassa Tutustu tietolomakkeiden asetteluun.

Lisäominaisuudet

BorderColor – Ohjausobjektin reunan väri.

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

BorderThickness – Ohjausobjektin reunan paksuus.

Fill – Ohjausobjektin taustaväri.

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

Valid – Sisältääkö Kortti- tai Muokkaa lomaketta -ohjausobjekti kelvollisia merkintöjä, jotka voidaan lähettää tietolähteeseen.

Visible – Onko ohjausobjekti näkyvissä vai piilossa.

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. Jos Kortti-ohjausobjekti on säilössä, jossa on useita sarakkeita, tämä ominaisuus määrittää sarakkeen, johon kortti tulee näkyviin.

Y – Ohjausobjektin yläreunan ja pääsäilön (tai näytön, jos pääsäilöä ei ole) yläreunan välinen etäisyys. Jos Kortti-ohjausobjekti on säilössä, jossa on useita rivejä, tämä ominaisuus määrittää rivin, johon kortti tulee näkyviin.

Esimerkit

Tutustu esimerkkeihin kohdissa Tutustu tietokortteihin ja Tutustu tietolomakkeiden asetteluun.

Helppokäyttötoimintojen ohjeet

Colorkontrasti

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

• Fill ja kaikki aliohjausobjektit. Jos kortti sisältää esimerkiksi Selite-ohjausobjektin, jonka täyttö on läpinäkyvä, kortin Fill toimii käytännössä selitteen taustavärinä. Näin ollen kortin Fill-objektin ja selitteen Color-objektin välisen kontrastin on oltava riittävä.

Näytönlukuohjelman tuki

• DisplayName on oltava olemassa.

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).