Tekstisyöte-ohjausobjekti Power Appsissa

Tile, johon käyttäjä voi kirjoittaa tekstiä, numeroita ja muuta tietoa.

Kuvaus

Käyttäjä voi määrittää tietoa kirjoittamalla tekstisyötteen ohjausobjektiin. Riippuen siitä, miten määrität sovelluksen, tietoja voidaan lisätä tietolähteeseen, niitä voidaan käyttää väliaikaisen arvon laskemiseen tai jollakin muulla tavalla.

Tärkeimmät ominaisuudet

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

Text – Teksti, joka näytetään ohjausobjektissa tai jonka käyttäjä kirjoittaa ohjausobjektiin.

Lisäominaisuudet

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

Align – Tekstin asettelu suhteessa ohjausobjektin vaakasuoraan keskikohtaan.

BorderColor – Ohjausobjektin reunan väri.

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

BorderThickness – Ohjausobjektin reunan paksuus.

Clear – Näyttääkö tekstisyötteen ohjausobjekti merkin X, jota käyttäjä voi napauttaa tai napsauttaa tyhjentääkseen kyseisen ohjausobjektin sisällön. Toimii ainoastaan SingleLine-tilassa.

Color – Ohjausobjektin Tekstin väri.

DelayOutput – Kun tämän arvo on tosi, käyttäjän syöte rekisteröidään puolen sekunnin viiveellä. Toiminnosta on hyötyä, jos halutaan viivyttää kalliita toimintoja, kunnes käyttäjä on syöttänyt Tekstin (esimerkiksi suodatus kun syötettä käytetään muissa kaavoissa).

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

DisabledBorderColor – Ohjausobjektin reunan väri, jos sen DisplayMode-asetuksena on Poistettu käytöstä.

DisabledColor – Ohjausobjektin Tekstin väri, jos sen DisplayMode -asetuksen arvoksi on asetettu Ei käytössä.

DisabledFill – Ohjausobjektin taustaväri, jos sen DisplayMode-ominaisuudeksi on määritetty Ei käytössä.

EnableSpellCheck – Ilmaisee, käytetäänkö tekstisyötteen ohjausobjektissa selaimen oikeinkirjoituksen tarkistusta. Power Apps for Windows ei tue tätä ominaisuutta.

Fill – Ohjausobjektin taustaväri.

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

FocusedBorderThickness – Ohjausobjektin reunan paksuus, kun ohjausobjekti on kohdistettu.

Font – tekstissä käytetyn fonttiperheen nimi.

FontWeight – Ohjausobjektin Tekstin paksuus: lihavoitu, puolilihavoitu, normaali tai ohuempi.

Format – Onko käyttäjän syöte rajoitettu vain numeroihin vai voiko se olla mitä tahansa tekstiä. Kun valittuna on numero, on mahdollista syöttää vain numeroita ja tiettyjä numeerisia symboleja. Tuetut symbolit ja muodot määräytyvät selaimen kielen mukaan, eikä niitä voi määrittää yksittäisille ohjausobjekteille.

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

HintText – Vaaleanharmaa Teksti, joka näkyy tekstisyötteen ohjausobjektissa, jos se on tyhjä.

HoverBorderColor – Ohjausobjektin reunan väri, kun käyttäjä pitää hiiren osoitinta kyseisen ohjausobjektin päällä.

HoverColor – Ohjausobjektin Tekstin väri, kun hiiren kohdistin on sen päällä.

HoverFill – Ohjausobjektin taustaväri, kun käyttäjä pitää hiiren osoitinta sen päällä.

Italic – Onko ohjausobjektin teksti kursivoitu.

LineHeight – Rivin korkeus eli esimerkiksi Tekstin tai luettelon rivien välinen etäisyys.

MaxLength – Ilmaisee, montako merkkiä käyttäjä voi kirjoittaa tekstisyötteen ohjausobjektiin.

Mode – Ohjausobjekti on SingleLine-, MultiLine- tai Password-tilassa.

OnChange – Toiminnot, jotka suoritetaan, kun käyttäjä muuttaa ohjausobjektin arvoa (esimerkiksi säätämällä liukusäädintä).

OnSelect – Toiminnot, jotka suoritetaan, kun käyttäjä napauttaa tai napsauttaa ohjausobjektia.

PaddingBottom – Ohjausobjektin Tekstin ja alareunan välinen etäisyys.

PaddingLeft – Ohjausobjektin Tekstin ja vasemman reunan välinen etäisyys.

PaddingRight – Ohjausobjektin Tekstin ja oikean reunan välinen etäisyys.

PaddingTop – Ohjausobjektin Tekstin ja yläreunan välinen etäisyys.

PressedBorderColor – Ohjausobjektin reunan väri, kun käyttäjä napauttaa tai napsauttaa kyseistä ohjausobjektia.

PressedColor – Ohjausobjektin Tekstin väri, kun käyttäjä napauttaa tai napsauttaa ohjausobjektia.

PressedFill – Ohjausobjektin taustaväri, kun käyttäjä napauttaa tai napsauttaa kyseistä ohjausobjektia.

RadiusBottomLeft – Vasemman alakulman pyöristysaste.

RadiusBottomRight – Oikean alakulman pyöristysaste.

RadiusTopLeft – Vasemman yläkulman pyöristysaste.

RadiusTopRight – Ohjausobjektin oikean yläkulman pyöristysaste.

Reset – Palautuuko ohjausobjekti oletusarvoonsa.

Size – Ohjausobjektissa näkyvän Tekstin fonttikoko.

Strikethrough – Onko ohjausobjektissa näkyvä Teksti yliviivattu.

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

Tooltip – OhjeTeksti, joka ilmestyy näkyviin osoittimen ollessa ohjausobjektin päällä.

Underline – Onko ohjausobjektissa näkyvä Teksti alleviivattu.

VirtualKeyboardMode – Sovelluksen käyttäjän kosketusnäytössä näkyvän virtuaalisen näppäimistön, Tekstin tai numerojoukon tyyppi. Format-ominaisuus määrittää oletusarvon. Laitetuki vaihtelee. iOS-laitteissa on oltava vähintään versio 12.2. Suositeltu Android-versio on 9.0, ja numeronäppäimistöjen ominaisuudet vaihtelevat Android-laitteen mukaan. Windows 10 ei tue tätä ominaisuutta.

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 (tai näytön, jos pääsäilöä ei ole) yläreunan välinen etäisyys.

Aiheeseen liittyvät funktiot

DateTimeValue( String )

Esimerkit

Tietojen kerääminen

1. Lisää kaksi tekstisyötteen ohjausobjektia ja anna niiden nimiksi inputFirst ja inputLast.

   Etkö tiedä, miten ohjausobjekti lisätään, nimetään ja määritetään?

2. Lisää painike, määritä sen Text-ominaisuus näyttämään Lisää ja määritä sen OnSelect-ominaisuudeksi tämä kaava:
   Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

   Haluatko lisätietoja Collect-funktiosta tai muista funktioista?

3. Lisää tekstivalikoima pysty- tai vaakasuunnassa, aseta sen Items-ominaisuus näyttämään Nimet ja aseta Subtitle1-kohdan Text-ominaisuudeksi ThisItem.FirstName.

4. (valinnainen) Poista mallivalikoiman alimmainen selite, jonka nimi on Body1, ja aseta valikoiman TemplateSize-ominaisuudeksi 80.

5. Paina F5-näppäintä, kirjoita tekstimerkkijono kenttiin inputFirst ja inputLast, ja napsauta tai napauta Lisää-painiketta.

6. (valinnainen) Lisää enemmän nimiä kokoelmaan ja palaa oletustyötilaan painamalla ESC-näppäintä.

Kysy salasana

1. Lisää tekstisyötteen ohjausobjekti, anna sen nimeksi inputPassword ja aseta sen Mode-ominaisuudeksi Salasana.

2. Lisää otsikko ja aseta sen Text-ominaisuudeksi tämä kaava:
   If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

   Haluatko lisätietoja If-funktiosta tai muista funktioista?

3. Paina F5-näppäintä ja kirjoita sitten P@ssw0rd kohtaan inputPassword.

   Kun olet kirjoittanut salasanan, selite ei enää näytä tekstiä Access denied, vaan siinä näkyy teksti Access granted.

4. Palaa oletustyötilaan painamalla ESC-näppäintä.

5. (valinnainen) Lisää ohjausobjekti, kuten nuoli, määritä se siirtymään toiseen näyttöön ja näytä se vasta, kun käyttäjä kirjoittaa salasanan.

6. (valinnainen) Lisää painike, määritä sen Text-ominaisuus näyttämään Kirjaudu sisään, lisää ajastin ja poista käytöstä tekstisyötteen ohjausobjekti tietyksi ajaksi, jos käyttäjä kirjoittaa väärän salasanan ja napsauttaa tai napauttaa sitten Kirjaudu sisään -painiketta.

Helppokäyttötoimintojen ohjeet

Colorkontrasti

• Tavalliset värikontrastivaatimukset pätevät.

Näytönlukuohjelman tuki

• AccessibleLabel on oltava läsnä.

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

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