Implementación del patrón de control SelectionItem de UI Automation

2011-08-10

Nota
Esta documentación está dirigida a desarrolladores de .NET Framework que desean usar las clases administradas de UI Automation definidas en el espacio de nombres System.Windows.Automation.Para obtener información actualizada sobre UI Automation, vea Windows Automation API: UI Automation.

Este tema presenta las directrices y convenciones de implementación de ISelectionItemProvider, incluida la información acerca de propiedades, métodos y eventos. Al final del tema se incluye una lista de vínculos a referencias adicionales.

El patrón de control SelectionItemPattern se usa para admitir controles que actúan como elementos secundarios seleccionables individuales de controles contenedores que implementan ISelectionProvider. Para obtener ejemplos de controles que implementan el patrón de control SelectionItem, consulte Asignación de patrones de controles para clientes de UI Automation.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación
Miembros necesarios para ISelectionItemProvider
Excepciones
Temas relacionados

Directrices y convenciones de implementación

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

Los controles de selección única que administran controles secundarios que implementan IRawElementProviderFragmentRoot, como el control deslizante Resolución de pantalla del cuadro de diálogo Propiedades de pantalla, deberían implementar ISelectionProvider y sus elementos secundarios deberían implementar tanto IRawElementProviderFragment como ISelectionItemProvider.

Miembros necesarios para ISelectionItemProvider

Las propiedades, métodos y eventos siguientes son necesarios para implementar ISelectionItemProvider.

Miembros necesarios	Tipo de miembro	Notas
CanSelectMultiple	Propiedad	Ninguno
IsSelectionRequired	Propiedad	Ninguno
GetSelection	Método	Ninguno
InvalidatedEvent	Evento	Se provoca cuando una selección en un contenedor ha cambiado de forma importante y necesita enviar más eventos ElementSelectedEvent y ElementRemovedFromSelectionEvent de los que permite la constante InvalidateLimit.

Si el resultado de Select, AddToSelection o RemoveFromSelection es un elemento de selección única, debería provocarse el evento ElementSelectedEvent; en caso contrario, se envía ElementAddedToSelectionEvent/ ElementRemovedFromSelectionEvent, según corresponda.

Excepciones

Los proveedores deben iniciar las excepciones siguientes.

Tipo de excepción	Condition
InvalidOperationException	Cuando se intenta alguna de las acciones siguientes: Se llama a RemoveFromSelection en un contenedor de selección única donde IsSelectionRequiredProperty = true y un elemento está ya seleccionado. Se llama a RemoveFromSelection en un contenedor de selección múltiple donde IsSelectionRequiredProperty = true y un solo elemento está seleccionado. Se llama a AddToSelection en un contenedor de selección única donde CanSelectMultipleProperty = false y otro elemento está ya seleccionado.

InvalidOperationException

Cuando se intenta alguna de las acciones siguientes:

Se llama a RemoveFromSelection en un contenedor de selección única donde IsSelectionRequiredProperty = true y un elemento está ya seleccionado.
Se llama a RemoveFromSelection en un contenedor de selección múltiple donde IsSelectionRequiredProperty = true y un solo elemento está seleccionado.
Se llama a AddToSelection en un contenedor de selección única donde CanSelectMultipleProperty = false y otro elemento está ya seleccionado.