Implementación del patrón de control MultipleView de UI Automation
Nota
Esta documentación está dirigida a los desarrolladores de .NET Framework que quieran usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para ver la información más reciente acerca de la automatización de la interfaz de usuario, consulte Windows Automation API: automatización de la interfaz de usuario.
En este tema se presentan las directrices y convenciones para implementar IMultipleViewProvider, incluida la información sobre eventos y propiedades. Al final del tema se ofrecen vínculos a referencias adicionales.
El patrón de control MultipleViewPattern se usa para admitir controles que ofrecen y pueden cambiar entre varias representaciones del mismo conjunto de información o controles secundarios.
Entre los ejemplos de controles que pueden presentar varias vistas se incluyen la vista de lista, (que puede mostrar su contenido como miniaturas, mosaicos, iconos o detalles), los gráficos de Microsoft Excel, (circulares, de líneas, de barras, valor de celda con una fórmula), los documentos de Microsoft Word, (normal, diseño web, diseño de impresión, diseño de lectura, esquema), el calendario de Microsoft Outlook, (año, mes, semana, día) y las máscaras de Microsoft Windows Media Player. Las vistas admitidas las determina el desarrollador del control y son específicas de cada control.
Directrices y convenciones de implementación
Al implementar el patrón de control Multiple View, tenga en cuenta las siguientes directrices y convenciones:
IMultipleViewProvider también se debe implementar en un contenedor que administre la vista actual si es diferente de un control que ofrece la vista actual. Por ejemplo, el Explorador de Windows contiene un control de lista para el contenido de la carpeta actual, mientras que la vista del control se administra desde la aplicación del Explorador de Windows.
No se considera que un control que puede ordenar su contenido admita varias vistas.
La colección de vistas debe ser idéntica en todas las instancias.
Los nombres de vista deben ser adecuados para su usarlo en texto a voz, Braille y otras aplicaciones de lenguaje natural.
Miembros requeridos para IMultipleViewProvider
Para implementar IMultipleViewProvider, se requieren las siguientes propiedades y métodos.
| Miembros requeridos | Tipo de miembro | Notas |
|---|---|---|
| CurrentView | Propiedad | None |
| GetSupportedViews | Método | None |
| GetViewName | Método | None |
| SetCurrentView | Método | None |
No hay ningún evento asociado a este patrón de control.
Excepciones
Los proveedores debe generar las siguientes excepciones.
| Tipo de excepción | Condición |
|---|---|
| ArgumentException | Cuando se llama a SetCurrentView o GetViewName con un parámetro que no es miembro de la colección de vistas compatible. |