Compartir a través de

Patrón de control de selección

  • Artículo

Describe instrucciones y convenciones para implementar ISelectionProvider, incluida información sobre propiedades, métodos y eventos. El patrón de control Selection se usa para admitir controles que actúan como contenedores para una colección de elementos secundarios seleccionables. Los elementos secundarios de este elemento deben implementar ISelectionItemProvider.

Para obtener ejemplos de controles que implementan este patrón de control, vea tipos de control y sus patrones de control admitidos.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación

Al implementar el patrón de control Selección de, tenga en cuenta las siguientes directrices y convenciones:

  • Los controles que implementan ISelectionProvider permiten seleccionar uno o varios elementos secundarios. Por ejemplo, los cuadros de lista, las vistas de lista y las vistas de árbol admiten varias selecciones, mientras que los cuadros combinados, los controles deslizantes y los grupos de botones de radio admiten una selección única.

  • Los controles que tienen un intervalo mínimo, máximo y continuo, como el control deslizante Volume de un reproductor multimedia, deben implementar IRangeValueProvider en lugar de ISelectionProvider.

  • Controles de selección única que administran controles secundarios que implementan cuadro de diálogo IRawElementProviderFragmentRoot, como el control deslizante de resolución de pantalla de en el cuadro de diálogo Mostrar propiedades para Windows, o el control de selección selector de colores de Microsoft Word (vea la imagen siguiente), debe implementar ISelectionProvider; sus elementos secundarios deben implementar IRawElementProviderFragment y ISelectionItemProvider.

    imagen que muestra un ejemplo de asignación de cadenas de muestra de color

  • Los menús no admiten el patrón de control Selección de. Si está trabajando con elementos de menú que incluyen tanto gráficos como texto (por ejemplo, el panel de vista previa de elementos del menú Ver en Microsoft Outlook) y necesita transmitir el estado, debe implementar IToggleProvider.

Miembros necesarios para ISelectionProvider

Se requieren las siguientes propiedades, métodos y eventos para implementar la interfazISelectionProvider.

Miembros necesarios Tipo de miembro Notas
CanSelectMultiple Propiedad Ninguno
IsSelectionRequired Propiedad Ninguno
GetSelection Método Ninguno
UIA_Selection_InvalidatedEventId Evento Genere este evento cuando una selección de un contenedor haya cambiado significativamente.

 

Las propiedades ISelectionProvider::IsSelectionRequired y canSelectMultiple pueden ser dinámicas. Por ejemplo, el estado inicial de un control podría no tener ningún elemento seleccionado de forma predeterminada, lo que indica que IsSelectionRequired es false. Sin embargo, después de seleccionar un elemento, el control siempre debe tener al menos un elemento seleccionado. De forma similar, en raras ocasiones, un control puede permitir que se seleccionen varios elementos en la inicialización, pero posteriormente solo se permitan realizar selecciones únicas.

tipos de control y sus patrones de control admitidos

patrón de control SelectionItem

Introducción a los patrones de control de automatización de la interfaz de usuario de

Información general del árbol de automatización de la interfaz de usuario de