Controllo Input di testo in Power Apps

  • Articolo

Casella in cui l'utente può digitare testo, numeri e altri dati.

Descrizione

L'utente può specificare i dati digitandoli in un controllo input di testo. A seconda della configurazione dell'app, i dati possono essere aggiunti a un'origine dati, usati per calcolare un valore temporaneo o incorporati in altro modo.

Proprietà chiave

Default: valore iniziale di un controllo prima della modifica da parte dell'utente.

Text: testo visualizzato in un controllo o che l'utente digita in un controllo.

Proprietà aggiuntive

AccessibleLabel: etichetta per le utilità per la lettura dello schermo.

Align: posizione del testo in relazione al centro orizzontale del relativo controllo.

BorderColor: colore del bordo di un controllo.

BorderStyle: indica se il bordo di un controllo è Solid (Tinta unita), Dashed (Tratteggiato), Dotted (Punteggiato) o None (Nessuno).

BorderThickness: spessore del bordo di un controllo.

Clear: indica se un controllo input di testo mostra una "X" che l'utente può selezionare o toccare per eliminare i contenuti del controllo stesso. Funziona solo in modalità SingleLine.

Color: colore del testo di un controllo.

DelayOutput: se questa proprietà è impostata su true, l'input dell'utente viene registrato con mezzo secondo di ritardo. Utile per ritardare le operazioni dispendiose finché l'utente non ha completato l'input di testo, ad esempio nel caso del filtro se l'input viene usato in altre formule.

DisplayMode: indica se il controllo consente l'input dell'utente (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).

DisabledBorderColor: colore del bordo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

DisabledColor: colore del testo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

DisabledFill: colore dello sfondo di un controllo se la relativa proprietà DisplayMode è impostata su Disabled.

EnableSpellCheck: indica se un controllo text-input deve utilizzare la funzione di controllo ortografico del browser. Power Apps per Windows non supporta questa proprietà.

Fill: colore dello sfondo di un controllo.

FocusedBorderColor: colore del bordo di un controllo quando è evidenziato.

FocusedBorderThickness: spessore del bordo di un controllo quando è evidenziato.

Font: nome della famiglia di caratteri in cui viene visualizzato il testo.

FontWeight: spessore del testo di un controllo. Può essere Bold (Grassetto), Semibold (Semibold), Normal (Normale) o Lighter (Sottile).

Format : indica se l'input dell'utente è limitato solo ai numeri o può essere qualsiasi testo. Se impostato su Numero, puoi inserire solo cifre e determinati simboli numerici. I simboli e i formati supportati dipendono dalla lingua del browser e non possono essere impostati sui singoli controlli.

Height: distanza tra i bordi superiore e inferiore del controllo.

HintText: testo grigio chiaro visualizzato in un controllo input di testo se questo è vuoto.

HoverBorderColor: colore del bordo di un controllo quando l'utente posiziona il puntatore del mouse su di esso.

HoverColor: colore del testo di un controllo quando l'utente posiziona il puntatore del mouse su tale controllo.

HoverFill: colore dello sfondo di un controllo quando l'utente posiziona il puntatore del mouse su di esso.

Italic: indica se il testo di un controllo è in corsivo.

LineHeight: distanza, ad esempio, tra le righe di testo o le voci di un elenco.

MaxLength: numero di caratteri digitabili dall'utente in un controllo input di testo.

Mode: il controllo è in modalità SingleLine, MultiLine o Password.

OnChange: azioni da eseguire quando l'utente modifica il valore di un controllo, ad esempio usando un dispositivo di scorrimento.

OnSelect: azioni da eseguire quando l'utente tocca o fa clic su un controllo.

PaddingBottom: distanza tra il testo in un controllo e il bordo inferiore del controllo.

PaddingLeft: distanza tra il testo in un controllo e il bordo sinistro del controllo.

PaddingRight: distanza tra il testo in un controllo e il bordo destro del controllo.

PaddingTop: distanza tra il testo in un controllo e il bordo superiore del controllo.

PressedBorderColor: colore del bordo di un controllo quando l'utente tocca o fa clic su tale controllo.

PressedColor: colore del testo di un controllo quando l'utente tocca o fa clic su tale controllo.

PressedFill: colore dello sfondo di un controllo quando l'utente tocca o fa clic su tale controllo.

RadiusBottomLeft: grado di arrotondamento dell'angolo inferiore sinistro di un controllo.

RadiusBottomRight: grado di arrotondamento dell'angolo inferiore destro di un controllo.

RadiusTopLeft: grado di arrotondamento dell'angolo superiore sinistro di un controllo.

RadiusTopRight: grado di arrotondamento dell'angolo superiore destro di un controllo.

Reset: indica se viene ripristinato il valore predefinito di un controllo.

Size: dimensione del carattere del testo visualizzato in un controllo.

Strikethrough: indica se viene visualizzata una riga all'interno del testo di un controllo.

TabIndex: ordine di spostamento tramite tastiera in relazione ad altri controlli.

Tooltip: testo descrittivo visualizzato quando l'utente posiziona il mouse su un controllo.

Underline: indica se il testo visualizzato nel controllo è sottolineato.

VirtualKeyboardMode: tipo di tastiera virtuale, testo o numerico, che appare sul touchscreen di un utente dell'app. La proprietà Format determina il valore predefinito. Il supporto del dispositivo varia. I dispositivi che eseguono iOS devono avere almeno la versione 12.2. La versione consigliata di Android è 9.0 e le funzionalità delle tastiere numeriche variano per i dispositivi Android. Windows 10 non supporta questa proprietà.

Visible: indica se un controllo viene visualizzato o è nascosto.

Width: distanza tra i bordi sinistro e destro di un controllo.

X: distanza tra il bordo sinistro di un controllo e il bordo sinistro del contenitore padre o della schermata se non c'è un contenitore padre.

Y: distanza tra il bordo superiore di un controllo e il bordo superiore del contenitore padre o della schermata se non c'è un contenitore padre.

DateTimeValue( String )

Esempi

Raccogliere dati

  1. Aggiungi due controlli input di testo e denominali inputFirst e inputLast.

    Non sai come aggiungere un controllo, assegnargli un nome e configurarlo?

  2. Aggiungi un pulsante e impostane la proprietà Text su Add e la proprietà OnSelect su questa formula:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Sono necessarie altre informazioni sulla funzione Collect o su altre funzioni?

  3. Aggiungi una raccolta di testi con orientamento orizzontale o verticale e impostarne la proprietà Items su Names Impostare la proprietà Text di Sottotitolo1 su ThisItem.FirstName.

  4. (facoltativo) Nella raccolta di modelli elimina l'etichetta nella parte inferiore, denominata Body1 e imposta la proprietà TemplateSize della raccolta su 80.

  5. Premi F5, digitare una stringa di testo in inputFirst e in inputLast e quindi tocca o fai clic sul pulsante Aggiungi.

  6. (facoltativo) Aggiungi altri nomi alla raccolta e quindi premi ESC per tornare all'area di lavoro predefinita.

Richiedere una password

  1. Aggiungi un controllo input di testo, denominarlo inputPassword e impostane la proprietà Mode su Password.

  2. Aggiungi un'etichetta e impostane la proprietà Text sulla formula seguente:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    Sono necessarie altre informazioni sulla funzione If o su altre funzioni?

  3. Premi F5 e quindi digita P@ssw0rd in inputPassword.

    Dopo che la password è stata digitata, l'etichetta non visualizza più Accesso negato ma visualizza Accesso concesso.

  4. Per tornare all'area di lavoro predefinita, premi ESC.

  5. (facoltativo) Aggiungi un controllo, ad esempio una freccia, configuralo in modo che consenta di passare a un'altra schermata e visualizzalo solo quando l'utente ha digitato la password.

  6. (facoltativo) Aggiungi un pulsante, configurane la proprietà Text in modo da visualizzare Accedi, aggiungi un timer e disabilita il controllo input di testo per un determinato periodo di tempo se l'utente digita una password errata e quindi seleziona o tocca il pulsante Accedi.

Linee guida per l'accessibilità

Contrasto dei colori

Supporto lettore schermo

Supporto per la tastiera

  • Il valore di TabIndex deve essere uguale o superiore a zero, in modo che gli utenti della tastiera possano passare a questo controllo.
  • Gli indicatori di attivazione devono essere chiaramente visibili. A questo scopo, usa FocusedBorderColor e FocusedBorderThickness.

Nota

Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)

Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).