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

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.

  1. Seleziona Inserisci > Input > Combo box e chiamala "Combobox1".

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

  3. Nello stesso riquadro, seleziona Modifica (accanto a Campi).

  4. Nel riquadro Dati, apri l'elenco Testi principale e quindi seleziona la colonna Nome primario visualizzata nel controllo Casella combinata.

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

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

  1. Seleziona Inserisci > Etichetta di testo e quindi Etichetta.

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

  1. Seleziona Inserisci > Input e quindi Combo box.

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

  3. Nello stesso riquadro, seleziona Modifica (accanto a Campi).

  4. Nel riquadro Dati, apri l'elenco Testo principale, quindi seleziona la colonna che vuoi visualizzare nel controllo Casella combinata.

  5. Imposta la proprietà IsSearchable su false.

  6. Imposta la proprietà SelectMultiple su false.

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