Control de caixa de combinación en Power Apps

Un control que permite aos usuarios facer seleccións entre as opcións fornecidas. Admite a busca e seleccións múltiples.

Descripción

Control de Caixa de combinación que permite buscar elementos que seleccionará. A busca realízase no servidor na propiedade SearchField polo que o rendemento non se ve afectado por orixes de datos grandes.

O modo de selección individual ou configúrase mediante a propiedade SelectMultiple.

Ao buscar elementos que seleccionar, para cada elemento pode optar por amosar un único valor de datos, dous valores ou unha imaxe e dous valores (persoa) modificando a configuración de deseño no panel de datos.

Cando se visualiza en pequenas pantallas, o control flotante da lista de elementos converterase nun control de pantalla completa para conseguir unha mellor usabilidade.

Nota

Se quere buscar elementos con números, converta os números en texto coa función Texto(). Por exemplo, Texto(12345).

Limitacións

O control da caixa combinada ten estas limitacións:

• Cando usas un control de caixa combinada dentro dunha galería, as súas seleccións non se manteñen cando o usuario se despraza pola galería. Isto non é un problema se usas un control de caixa combinada dentro dunha galería que non se despraza. Actualmente non está dispoñible unha solución.

Selector de persoas

Para usar Caixa de combinación como selector de persoas, escolla o modelo Persoa da configuración de deseño no panel de datos e configure as propiedades de datos relacionadas que se amosarán para a persoa que se atopa a continuación.

Propiedades clave

Elementos - A orixe de datos a partir da cal se poden realizar seleccións.

DefaultSelectedItems - Os elementos iniciais seleccionados antes de que o usuario interactúe co control.

Nota

A propiedade Por defecto está obsoleta, use DefaultSelectedItems no seu lugar.

SelectedItems - Lista de elementos seleccionados resultantes da interacción do usuario.

SelectMultiple - Se o usuario pode seleccionar un único elemento ou varios elementos.

IsSearchable - Se o usuario pode buscar elementos antes de seleccionar.

Nota

IsSearchable só se pode activar nunha orixe de datos que conteña polo menos un campo de texto. A expresión Elementos debe ser delegable para que as consultas se deleguen coa busca. É dicir, as declaracións Se dentro da expresión Elementos non se admiten.

SearchFields - Os campos de datos da orixe de datos buscados cando o usuario está a introducir texto.

Nota

Para buscar en varios campos, configure a propiedade SearchFields neste formato: ["MyFirstColumn", "MySecondColumn"]. Só se admiten campos de texto.

Propiedades adicionais

AccessibleLabel: etiqueta para lectores de pantalla.

BorderColor: cor do bordo dun control.

BorderStyle: se un bordo dun control é Sólido, A trazos, Punteado ou Ningún.

BorderThickness: grosor do bordo dun control.

DisplayFields - Lista de campos mostrados para cada elemento devolto pola busca. O máis sinxelo de configurar a través do panel de datos no separador Opción de propiedades.

Nota

Para actualizar varios campos de visualización nun modelo determinado, configure a propiedade DisplayFields neste formato: ["MyFirstColumn", "MySecondColumn"].

DisplayMode: se o control permite a entrada do usuario (Editar), só mostra datos (Ver) ou está desactivado (Desactivado).

FocusedBorderColor: a cor do bordo dun control cando o control está enfocado.

FocusedBorderThickness: o grosor do bordo dun control cando o control está enfocado.

Altura: distancia entre os bordos superior e inferior dun control.

InputTextPlaceholder - Texto instrutivo mostrado aos usuarios finais cando non se seleccionan elementos.

OnChange - Accións a realizar cando o usuario cambia unha selección.

OnNavigate - Accións a realizar cando o usuario selecciona un elemento.

OnSelect - Accións a realizar cando o usuario toca ou selecciona un control.

TabIndex - Orde de navegación do teclado en relación con outros controis.

Visible: se aparece un control ou está oculto.

Largura: distancia entre os bordos esquerdo e dereito dun control.

X: A distancia entre o bordo esquerdo dun control e o bordo esquerdo do seu contedor principal (pantalla, se non hai ningún contedor principal).

Y: A distancia entre o bordo superior dun control e o bordo superior do contedor principal (pantalla, se non hai ningún contedor principal).

Nota

As propiedades do bordo do control flotante están controladas polas propiedades de Bordo.

Exemplos

Caixa de combinación básica

Os pasos deste exemplo aplícanse a calquera orixe de datos que fornece táboas, pero para seguir estes pasos exactamente, use un ambiente coa base de datos de Microsoft Dataverse con datos de mostra.

1. Seleccione Inserir > Entrada > Caixa combinada e asígnelle o nome "Combobox1".

2. No panel Propiedades da parte dereita da pantalla, abra a lista Seleccionar unha orixe de datos (xunto a Elementos) e, a continuación, engada ou seleccione unha orixe de datos como a táboa de contas.

3. No mesmo panel, seleccione Editar (xunto a Campos).

4. No panel Datos abra a lista Texto primario e, a continuación, seleccione a columna Nome principal que se amosará no control Caixa combinada.

5. Mentres mantén premida a tecla Alt, seleccione a frecha cara abaixo para abrir o control Caixa de combinación.

   O control mostra os datos do nome primario que especificou na orixe de datos que especificou.

(Opcional) Amosar o primeiro rexistro por defecto

1. Configure a propiedade DefaultSelectedItems nesta expresión, substituíndo DataSource co nome da súa orixe de datos:

   First(DataSource)
   

(Opcional) Mostrar o valor do nome da conta seleccionado nunha etiqueta

1. Seleccione Inserir > Etiqueta de texto e, a continuación, seleccione Etiqueta.

2. Configure a propiedade Text nesta expresión, substituíndo Texto pola seguinte fórmula:

   If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
   

   Nota

   A instrución If comprobará como poden existir os elementos seleccionados e amosalos nunha etiqueta delimitada por comas ou nunha mensaxe "SEN ARTIGO SELECCIONADO" cando está baleira.

Simula un comportamento despregable simple

Configurando IsSearchable en false e SelectMultiple en false, pode acadar a mesma funcionalidade dun menú despregable.

1. Seleccione Inserir > Entrada e, a continuación, seleccione Caixa combinada.

2. No panel Propiedades da parte dereita da pantalla, abra a lista Seleccionar unha orixe de datos (xunto a Elementos) e, a continuación, engada ou seleccione unha orixe de datos.

3. No mesmo panel, seleccione Editar (xunto a Campos).

4. No panel Datos, abra a lista Texto principal e logo seleccione a columna que desexa mostrar no control Caixa de combinación.

5. Configure a propiedade IsSearchable en false.

6. Configure a propiedade SelectMultiple en false.

7. Mentres mantén premida a tecla Alt, seleccione a frecha cara abaixo para abrir o control Caixa de combinación.

   O control mostra os datos da columna que especificou na orixe de datos que especificou.

   Nota

   O texto "Buscar elementos" desapareceu e só poderá seleccionar un único elemento.

Directrices de accesibilidade

Contraste de cor

Debe haber un contraste de cor adecuado entre:

• ChevronFill e ChevronBackground
• ChevronHoverFill e ChevronHoverBackground
• SelectionColor e SelectionFill
• SelectionFill e Fill
• SelectionTagColor e SelectionTagFill

Isto é ademais dos Requisitos estándar de contraste de cores.

Soporte do lector de pantalla

• AccessibleLabel debe estar presente.

  Nota

  Nas pantallas táctiles, os usuarios do lector de pantalla poden navegar polo contido da caixa de combinación de xeito secuencial. A caixa de combinación actúa como un botón que mostra ou esconde o seu contido cando está seleccionado.

Compatibilidade do teclado

• TabIndex debe equivaler a cero ou ser superior para que os usuarios do teclado poidan navegar ata el.

• Os indicadores de enfoque deben ser claramente visibles. Use FocusedBorderColor e FocusedBorderThickness para conseguilo.

  Nota

  A tecla do separador permite saír ou acceder á caixa de combinación. As teclas de frecha permiten navegar polos contidos da caixa de combinación. A tecla de escape pecha o menú despregable cando se abre.

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).