Controllo Casella combinata in Power Apps
Controllo che consente agli utenti di effettuare selezioni tra le scelte proposte. Supporta la ricerca e le selezioni multiple.
Descrizione
Un controllo Casella combinata ti consente di cercare gli elementi che verranno selezionati. Poiché questa ricerca viene eseguita lato server sulla proprietà SearchField, le prestazioni non vengono interessate da origini dati di dimensioni estese.
Tramite la proprietà SelectMultiple viene configurata la selezione singola o multipla.
Quando si cercano gli elementi da selezionare, per ogni elemento puoi scegliere di visualizzare un solo valore di dati, due valori o un'immagine e due valori (Persona) modificando l'impostazione Layout nel riquadro Dati.
Durante la visualizzazione su schermi piccoli, il riquadro a comparsa dell'elenco degli elementi diventa un controllo a schermo intero per una migliore usabilità.
Nota
Se vuoi cercare elementi con numeri, converti i numeri in testo con la funzione Text(). Ad esempio, Text(12345).
Limiti
Il controllo Casella combinata presenta le seguenti limitazioni:
- Quando usi un controllo Casella combinata in una raccolta, le selezioni ad esso relative non vengono mantenute quando l'utente scorre la raccolta. Ciò non è un problema se usi un controllo Casella combinata in una raccolta che non scorre. Attualmente non è disponibile alcuna soluzione alternativa.
Selezione persone
Per usare Combo box come selettore degli utenti, scegli il modello Persona dalle impostazioni del layout nel riquadro Dati e configura le proprietà dei dati correlati in modo che vengano mostrati per la persona indicata di seguito.
Proprietà chiave
Items: origine dei dati da cui è possibile eseguire le selezioni.
DefaultSelectedItems: uno o più elementi iniziali selezionati prima che l'utente interagisca con il controllo.
Nota
La proprietà Default è deprecata, usa DefaultSelectedItems.
SelectedItems: elenco di elementi selezionati risultanti dall'interazione dell'utente.
SelectMultiple: indica se l'utente può selezionare un solo elemento o più elementi.
IsSearchable: indica se l'utente può cercare gli elementi prima di selezionarli.
Nota
IsSearchable può essere abilitato solo su un origine dati che contiene almeno un campo di testo. L'espressione Items deve essere delegabile affinché le query vengano delegate con la ricerca. Ossia, le istruzioni If all'interno dell'espressione Items non sono supportate.
SearchFields: campi dati dell'origine dati in cui viene eseguita la ricerca quando l'utente immette del testo.
Nota
Per cercare in più campi, impostare la proprietà SearchFields con questo formato: ["MyFirstColumn", "MySecondColumn"]. Sono supportati solo i campi di testo.
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.
DisplayFields: elenco di campi visualizzati per ogni elemento restituito dalla ricerca. La configurazione tramite il riquadro Dati nella scheda delle opzioni Proprietà è molto semplice.
Nota
Per aggiornare più campi di visualizzazione in un determinato modello, impostare la proprietà DisplayFields con questo formato: ["MyFirstColumn", "MySecondColumn"].
DisplayMode: indica se il controllo consente l'input dell'utente (Edit), visualizza solo i dati (View) o è disabilitato (Disabled).
FocusedBorderColor: colore del bordo di un controllo quando è evidenziato.
FocusedBorderThickness: spessore del bordo di un controllo quando è evidenziato.
Height: distanza tra i bordi superiore e inferiore del controllo.
InputTextPlaceholder: testo di istruzioni visualizzato dagli utenti finali quando non sono selezionati elementi.
OnChange: azioni da eseguire quando l'utente modifica una selezione.
OnNavigate: azioni da eseguire quando l'utente seleziona un elemento.
OnSelect: azioni da eseguire quando l'utente tocca o seleziona un controllo.
TabIndex: ordine di spostamento tramite tastiera in relazione ad altri controlli.
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.
Nota
Le proprietà del bordo del riquadro a comparsa sono controllate da Border.
Esempi
Casella combinata di base
I passaggi in questo esempio si applicano a qualsiasi origine dati che fornisce tabelle, ma per seguire esattamente questi passaggi usa un ambiente con Microsoft Dataverse database che contiene dati di esempio.
Seleziona Inserisci > Input > Combo box e chiamala "Combobox1".
Nel riquadro a destra Proprietà sul lato destro dello schermo, apri l'elenco Seleziona un'origine dati (accanto a Items), quindi aggiungi o seleziona un origine dati come la tabella Account.
Nello stesso riquadro, seleziona Modifica (accanto a Campi).
Nel riquadro Dati, apri l'elenco Testi principale e quindi seleziona la colonna Nome primario visualizzata nel controllo Casella combinata.
Tenendo premuto il tasto ALT, seleziona la freccia GIÙ per aprire il controllo Casella combinata.
Il controllo mostra i dati dal nome primario specificato nell'origine dati indicata.
(Facoltativo) Mostra il primo record per impostazione predefinita
Imposta la proprietà DefaultSelectedItems su questa espressione, sostituendo DataSource con il nome dell'origine dati:
First(DataSource)
(Facoltativo) Visualizza il valore del nome account selezionato in un'etichetta
Seleziona Inserisci > Etichetta di testo e quindi Etichetta.
Imposta la proprietà Text su questa espressione, sostituendo Text con la formula seguente:
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")Nota
L'istruzione If controllerà come possono esistere gli elementi selezionati e li visualizzerà in un'etichetta delimitata da virgole o in un messaggio "NESSUN ELEMENTO SELEZIONATO" quando vuota.
Simula un semplice comportamento di un elenco a discesa
Se si impostano IsSearchable e SelectMultiple su false, puoi ottenere la stessa funzionalità di un menu a discesa.
Seleziona Inserisci > Input e quindi Combo box.
Nel riquadro a destra Proprietà sul lato destro dello schermo, apri l'elenco Seleziona un'origine dati (accanto a Items), quindi aggiungi o seleziona un origine dati.
Nello stesso riquadro, seleziona Modifica (accanto a Campi).
Nel riquadro Dati, apri l'elenco Testo principale, quindi seleziona la colonna che vuoi visualizzare nel controllo Casella combinata.
Imposta la proprietà IsSearchable su false.
Imposta la proprietà SelectMultiple su false.
Tenendo premuto il tasto ALT, seleziona la freccia GIÙ per aprire il controllo Casella combinata.
Il controllo mostra i dati dalla colonna che hai specificato nell'origine dati indicata.
Nota
Il testo "Find items" non è più visualizzato e potrai selezionare solo un singolo elemento.
Linee guida per l'accessibilità
Contrasto dei colori
È necessario un contrasto dei colori adeguato tra:
- ChevronFill e ChevronBackground
- ChevronHoverFill e ChevronHoverBackground
- SelectionColor e SelectionFill
- SelectionFill e Fill
- SelectionTagColor e SelectionTagFill
Sono requisiti aggiuntivi a quelli relativi al contrasto dei colori standard.
Supporto lettore schermo
AccessibleLabel deve essere presente.
Nota
Nei dispositivi touchscreen, gli utenti dell'utilità per la lettura dello schermo possono esplorare il contenuto della casella combinata in modo sequenziale. La casella combinata agisce come un pulsante che visualizza o nasconde il proprio contenuto se selezionato.
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
Il tasto TAB consente di passare alla casella combinata o a un altro controllo. I tasti di direzione consentono di esplorare il contenuto della casella combinata. Il tasto ESC chiude il menu a discesa se è aperto.
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).