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.

If( Condition, Result )

Esempio

  1. Aggiungi un controllo toggle e denominalo MemberDiscount.

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

  2. 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?

  3. Premi F5 e modifica il valore di MemberDiscount.

    L'etichetta mostra un prezzo diverso a seconda che MemberDiscount sia abilitato o disabilitato.

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