Controllo Interruttore in Power Apps
Controllo che l'utente può abilitare o disabilitare spostando il relativo punto di controllo.
Descrizione
Il controllo toggle fa parte delle nuove interfacce utente grafiche ma si comporta esattamente come una casella di controllo.
Proprietà chiave
Default: valore iniziale di un controllo prima della modifica da parte dell'utente.
Value: valore di un controllo di input.
Proprietà aggiuntive
AccessibleLabel: etichetta per le utilità per la lettura dello schermo.
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.
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.
FalseFill: colore di riempimento del controllo toggle quando il controllo è disattivato.
FalseHoverFill: colore di riempimento al passaggio del mouse del controllo toggle quando il controllo è disattivato.
FalseText: testo visualizzato quando il controllo toggle è disattivato.
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.
HandleFill: colore di riempimento del quadratino di attivazione/disattivazione.
Height: distanza tra i bordi superiore e inferiore del controllo.
HoverBorderColor: colore del bordo di un controllo quando l'utente posiziona il puntatore del mouse su di esso.
OnChange: azioni da eseguire quando l'utente modifica il valore di un controllo, ad esempio usando un dispositivo di scorrimento.
OnCheck: azioni da eseguire quando il valore di una casella di controllo o di un interruttore viene modificato in true.
OnSelect: azioni da eseguire quando l'utente tocca o fa clic su un controllo.
OnUncheck: azioni da eseguire quando il valore di una casella di controllo o di un interruttore viene modificato in false.
PressedBorderColor: colore del bordo di un controllo quando l'utente tocca o fa clic su tale controllo.
RailFill: colore di sfondo del rettangolo in un controllo di alternanza quando il relativo valore è false oppure il colore della riga a destra del quadratino in un controllo di scorrimento.
RailHoverFill: quando passi il mouse su un controllo di alternanza o un dispositivo di scorrimento, il colore di sfondo del rettangolo in un controllo di alternanza quando il relativo valore è false oppure il colore della riga a destra del quadratino in un controllo di scorrimento.
Reset: indica se viene ripristinato il valore predefinito di un controllo.
ShowLabel: indica se viene visualizzata l'etichetta di testo accanto al controllo Interruttore.
TabIndex: ordine di spostamento tramite tastiera in relazione ad altri controlli.
TextPosition: indica se l'etichetta è posizionata a sinistra o a destra del controllo Interruttore.
Tooltip: testo descrittivo visualizzato quando l'utente posiziona il mouse su un controllo.
TrueFill: colore di riempimento del controllo toggle quando il controllo è attivato.
TrueHoverFill: colore di riempimento al passaggio del mouse del controllo toggle quando il controllo è attivato.
TrueText: testo visualizzato quando il controllo toggle è attivato.
ValueFill: colore di sfondo del rettangolo in un controllo di alternanza quando il relativo valore è true oppure il colore della riga a sinistra del quadratino in un controllo di scorrimento.
ValueHoverFill: quando mantieni il puntatore del mouse su un controllo di alternanza o un dispositivo di scorrimento, il colore di sfondo del rettangolo in un controllo di alternanza quando il relativo valore è true oppure il colore della riga a sinistra del quadratino in un controllo di scorrimento.
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.
Funzioni correlate
Esempio
Aggiungi un controllo toggle e denominalo MemberDiscount.
Non sai come aggiungere un controllo, assegnargli un nome e configurarlo?
Aggiungi un'etichetta e impostane la proprietà Text sulla formula seguente:
If(MemberDiscount.Value = true, "Price: $75", "Price: $100")Sono necessarie altre informazioni sulla funzione If o su altre funzioni?
Premi F5 e modifica il valore di MemberDiscount.
L'etichetta mostra un prezzo diverso a seconda che MemberDiscount sia abilitato o disabilitato.
Per tornare all'area di lavoro predefinita, premi ESC.
Linee guida per l'accessibilità
Contrasto dei colori
È necessario un contrasto dei colori adeguato tra:
- HandleFill e FalseFill
- HandleFill e FalseHoverFill
- HandleFill e TrueFill
- HandleFill e TrueHoverFill
- FalseFill e il colore all'esterno del controllo
- FalseHoverFill e il colore all'esterno del controllo
- TrueFill e il colore all'esterno del controllo
- TrueHoverFill e il colore all'esterno del controllo
Sono requisiti aggiuntivi a quelli relativi al contrasto dei colori standard.
Supporto lettore schermo
- AccessibleLabel deve essere presente.
- FalseText deve essere presente.
- TrueText deve essere presente.
Supporto per ipovisione
- È consigliabile impostare ShowLabel su true in modo che gli utenti possano determinare rapidamente il valore di attivazione/disattivazione.
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).