Compartir a través de


Extensión de Excel de muestra: TechnologyManager (Clase)

Esta clase extiende la clase UITechnologyManager y es responsable de proporcionar los servicios principales para la extensión Microsoft Excel.Aunque la clase base tiene muchos métodos, en este ejemplo solo se usa un subconjunto de ellos.

Algunos métodos simplemente devuelven un valor de propiedad.Muchos de los métodos están pensados para permitir al desarrollador invalidar algoritmos predeterminados integrados en el motor de pruebas de IU codificadas.Estos métodos producen una excepción NotSupportedException o devuelven null, que indica al marco que debe usar el algoritmo predeterminado.

Dependiendo de la complejidad de la tecnología subyacente, el desarrollo del código del administrador de tecnología puede durar desde unas semanas hasta unos meses.Excel ofrece la posibilidad de crear un administrador de tecnología muy completo.Este ejemplo está limitado intencionadamente a hojas de cálculo y celdas de Excel, y usa formato limitado.

Cuando es posible, el código del administrador de tecnología usa el canal .NET Remoting abierto por la clase Communicator para extraer información del complemento que se ejecuta en el proceso de Excel.

Visibilidad COM

Tenga en cuenta que esta clase y cada una de las clases de elemento que extienden la clase UITechnologyElement tienen todas ComVisibleAttribute con un valor de true para asegurarse de que las clases son visibles para COM.

TechnologyName (propiedad)

Esta invalidación de la propiedad UITechnologyManager.TechnologyName debe proporcionar un nombre único y significativo que identifique la tecnología subyacente para todos los demás componentes de la extensión.Para esta extensión, el valor es "Excel".

Método GetControlSupportLevel

Esta invalidación del método UITechnologyManager.GetControlSupportLevel devuelve un número que indica el nivel de compatibilidad que el administrador de tecnología puede ofrecer para el control representado por el identificador proporcionado.Cuanto mayor sea el valor devuelto, mejor puede admitir el control el administrador de tecnología.En este caso, el método comprueba la ventana que contiene el control y, si es una hoja de cálculo de Excel, el método devuelve el valor máximo; de lo contrario, devuelve cero, lo que indica que no se proporciona ninguna compatibilidad.

Métodos para obtener un elemento

El marco de pruebas de IU codificadas emplea varios métodos importantes para obtener un elemento específico de la tecnología proporcionando un controlador, un punto de la pantalla o un elemento de una tecnología diferente.El código para estos métodos es autoexplicativo.Los métodos base son los siguientes:

ParseQueryId (método)

Cuando se crea una prueba de IU codificada, el usuario puede especificar valores de propiedad para algunos o todos los controles de la prueba.El marco de prueba usa estos valores de propiedad para crear pares de nombre y valor denominados propiedades de búsqueda que se emplean para encontrar determinados controles de la interfaz de usuario durante la prueba.Todas las propiedades de búsqueda representan conjuntamente el valor de la propiedad UITechnologyElement.QueryId de cada elemento de la tecnología, lo que incluye cada control.Puesto que quizás haya que buscar un control varias veces durante una prueba, este método ofrece al administrador de tecnología una manera de optimizar el análisis de las propiedades de búsqueda para el control determinado.Este método también devuelve una cookie que el marco puede usar para las búsquedas posteriores de ese control.Esta implementación del método usa el método AndCondition.Match para analizar las propiedades de búsqueda.

MatchElement (método)

Para que el administrador de tecnología busque un control, puede implementar el método UITechnologyManager.Search para devolver una matriz de posibles coincidencias u o producir la excepción NotSupportedException, que indica al marco que debe usar su propio algoritmo de búsqueda.En cualquier caso, debe implementar el método MatchElement donde esta implementación usa de nuevo el método AndCondition.Match.

Métodos de navegación

Estos métodos obtienen el elemento primario, los elementos secundarios o los elementos del mismo nivel del elemento proporcionado de la jerarquía de la interfaz de usuario.El código es sencillo y comentado claramente.

GetExcelElement (método interno)

Este método interno toma un identificador de ventana e información sobre un elemento de Excel y devuelve el elemento de Excel solicitado.

Vea también

Referencia

UITechnologyManager

NotSupportedException

UITechnologyElement

ComVisibleAttribute

QueryId

Conceptos

Extender las pruebas de IU codificadas y las grabaciones de acciones para la compatibilidad con Microsoft Excel