Desencadenador de eventos de aplicación

UiPath.UIAutomationNext.Activities.NNativeEventTrigger

Descripción

Configura un desencadenador basado en un evento nativo de cualquier tipo de elemento (ventana de nivel superior o cualquier otro elemento de IU indicado). Puedes indicar el elemento de destino en la pantalla y luego elegir el evento nativo de la lista de eventos admitidos por ese elemento.

Esta actividad es compatible con el repositorio de objetos.

El desencadenador debe ser la primera actividad del flujo de trabajo y el flujo de trabajo se desencadena cuando se produce un evento de IU determinado. Solo se permite un desencadenador por flujo de trabajo. Para obtener más información, consulta Automatización Attended basada en desencadenador.

Nota:

Si utiliza una versión de Studio inferior a la 2023.4, debe colocar la actividad Desencadenador de eventos de aplicación dentro de una actividad de Ámbito de desencadenador. En este caso, la actividad Desencadenador de eventos de aplicación no muestra las propiedades Modo de programación y Habilitado , y la propiedad Modo de programación está disponible en la actividad Ámbito del desencadenador.

Compatibilidad de proyectos

Windows: heredado | Ventanas

Windows (heredado), configuración de Windows

Panel del Diseñador

• Haga clic en Indicar destino en pantalla para indicar el elemento de IU que se utilizará como destino.

  Después de indicar el destino, seleccione el menú para acceder a las siguientes opciones:

  • Indicar destino en pantalla: indica de nuevo el destino.
  • Editar objetivo : abre el modo de selección para configurar el objetivo.
  • Eliminar captura de pantalla informativa : elimina la captura de pantalla de la aplicación o página web de destino.
  • Añadir al repositorio de objetos : añade el elemento de IU actual a un proyecto de biblioteca, desde donde pueda reutilizarse en todo el proceso de automatización.

• Tipo de evento : la lista de tipos de eventos nativos específicos para el elemento indicado. Se debe establecer el tipo de evento. La lista de eventos expuestos depende del tipo de elemento de destino y de la tecnología de aplicación de destino. Por ejemplo, un elemento de IU web puede exponer una lista de eventos distinta a la de un elemento de IU de Java.

Panel de propiedades

Común

• Nombre paramostrar : el nombre que se muestra para la actividad en el panel Diseñador. Se genera automáticamente un nombre para mostrar cuando indica un destino.

Entrada

• Sincronización decoincidencias : indica si la coincidencia del selector de elementos de destino se realiza de forma síncrona o asíncrona. Solo se admite para eventos Java, excepto para Aparecidos y Desaparecidos. Este campo solo admite valores Boolean . El valor predeterminado es Falso.
• Selectores : colección opcional de selectores para supervisar el evento indicado; estos selectores se supervisan junto con el destino indicado. Los selectores deben ser selectores completos (no parciales).

• Destino : el elemento de destino: ventana de nivel superior o elemento de IU. Solo se admiten selectores estrictos, sin anclajes. Se debe establecer el elemento de destino. Antes de indicarlo en la pantalla, este campo se establece como (null). Una vez que se indica el destino, se muestran todas las propiedades relacionadas con el elemento que se indicó.
  • Selector estricto: el selector estricto generado para el elemento de la interfaz de usuario de destino. Está vacío para las ventanas de nivel superior.
  • Selector de ventana (instancia de aplicación): el selector de la ventana de la aplicación (aplicación / navegador).

Otros

• Habilitado : si se establece en Falso, el desencadenador se inicia pero no desencadena ningún evento. Se puede habilitar más tarde en Runtime, usando la actividad Habilitar desencadenador local . Esta propiedad está oculta cuando la actividad Desencadenador de eventos de aplicación se coloca dentro de un ámbitode desencadenador. Este campo solo admite valores Boolean . El valor predeterminado es Verdadero.
• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.

Opciones

• Incluir elementos secundarios: cuando se selecciona, también se supervisan los elementos secundarios del elemento de la IU especificado. Admite todos los tipos de eventos, excepto Aparecidos o Desaparecidos y cualquier elemento de IU, excepto las ventanas de nivel superior. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso.
• Modo de programación : especifica cómo ejecutar las Actions cuando se activa un desencadenador. Elija una de las cinco opciones del menú desplegable:
  • Secuencial: las acciones se ejecutan una tras otra.
  • Concurrente: la ejecución de las acciones puede solaparse.
  • OneTime : ejecuta una Actions y sale de la supervisión.
  • Contracción secuencial: ignora todos los eventos próximos, excepto el último, hasta que el evento actual finaliza la ejecución.
  • Despliegue secuencial: detiene la ejecución del evento anterior e inicia el siguiente evento.

  En los modos Secuencial y Concurrente , la supervisión continúa hasta que el usuario detiene la ejecución o se cumple una actividad de Interrupción.

Eventos nativos

Acerca de

El mecanismo de supervisión de eventos nativos se ha mejorado mediante la implementación de nuevos conjuntos de eventos compatibles con diferentes tipos de tecnologías de aplicación:

• Eventos nativos de WND
• Eventos nativos de CTRL
• Eventos nativos de JAVA
• Eventos nativos deWeBCTRL
• Eventos nativos HTML
• Eventos nativos de UIA

Eventos WND: ventana de nivel superior

Tipo de evento	Tipo de ArgumentosDeEventoDesencadenador	Descripción
Apareció	ArgsVacíos	Evento desencadenado cuando aparece el elemento de destino.
Desapareció	ArgsVacíos	Evento desencadenado cuando el elemento de destino desaparece.
Título cambiado	ArmasDeTextoCambiado	Evento desencadenado cuando cambia el título del elemento de destino. Nota: Este es el evento Texto cambiado , renombrado como Título cambiado para las ventanas de nivel superior, para mayor claridad.
Estado cambiado	ArmasDeEstadoCambiado	Evento desencadenado cuando cambia el estado del elemento de destino. Nota: Este evento se desencadena cuando algo se cambia en el estado de la ventana: habilitado, deshabilitado, marcado, no marcado, enfocable, enfocado, visible, etc. El nuevo valor del estado se expone en la variable de argumentos.
Ubicación cambiada	ArgosCambiados	Evento desencadenado cuando la ubicación del elemento del destino ha cambiado.
Primer plano cambiado	ArgumentosDeHwnd	Evento desencadenado cuando la ventana de elementos del destino se convierte en la ventana en primer plano.
Primer plano perdido	ArgumentosDeHwnd	Evento desencadenado cuando la ventana de elementos del destino ya no está en primer plano.
Minimizado	ArgumentosDeHwnd	Evento desencadenado cuando la ventana de elementos del destino está a punto de minimizarse.
restaurado	ArgumentosDeHwnd	Evento desencadenado cuando la ventana de elementos del destino está a punto de restaurarse.

Eventos CTRL o WND: elementos de la IU

Tipo de evento	Tipo de ArgumentosDeEventoDesencadenador	Descripción
Apareció	ArgsVacíos	Evento desencadenado cuando aparece el elemento de destino.
Desapareció	ArgsVacíos	Evento desencadenado cuando el elemento de destino desaparece.
Tecla pulsada	KeyPressArgs	Evento desencadenado cuando se pulsa una tecla mientras el foco está dentro del elemento de destino.
Clic	MouseClickedArgs	Evento desencadenado cuando se hace clic en el elemento de destino.
Texto cambiado	ArmasDeTextoCambiado	Evento desencadenado cuando cambia el texto del elemento de destino.
Enfoque alcanzado	ArgsVacíos	Evento desencadenado cuando el elemento de destino obtiene el foco.
Enfoque perdido	ArgsVacíos	Evento desencadenado cuando el elemento de destino pierde el enfoque.
Estado cambiado	ArmasDeEstadoCambiado	Evento desencadenado cuando cambia el estado del elemento de destino. Nota: Este evento se desencadena cuando algo se cambia en el estado de la ventana: habilitado, deshabilitado, marcado, no marcado, enfocable, enfocado, visible, etc. El nuevo valor del estado se expone en la variable de argumentos.
La selección ha cambiado	ArmasDeSelección	Evento desencadenado cuando el valor de selección del elemento de destino cambia.

Eventos de JAVA: elementos de la interfaz de usuario

Tipo de evento	Tipo de ArgumentosDeEventoDesencadenador	Descripción
Apareció	ArgsVacíos	Evento desencadenado cuando aparece el elemento de destino.
Desapareció	ArgsVacíos	Evento desencadenado cuando el elemento de destino desaparece.
Texto cambiado	ArmasDeTextoCambiado	Evento desencadenado cuando cambia el texto del elemento de destino.
Tecla pulsada	ArmasDePulsaciónDeClaveDeJava	Evento desencadenado cuando se pulsa una tecla mientras el foco está dentro del elemento de destino.
Clic	ArmasDeAcciónDeMouse	Evento desencadenado cuando se hace clic en el elemento de destino.
Movimiento del ratón	ArgsDeMovimientoDeJava	Evento desencadenado cuando el ratón se mueve sobre el elemento de destino.
Enfoque alcanzado	ArgsVacíos	Evento desencadenado cuando el elemento de destino obtiene el foco.
Enfoque perdido	ArgsVacíos	Evento desencadenado cuando el elemento de destino pierde el enfoque.
Habilitada	ArgsVacíos	Evento desencadenado cuando el elemento de destino está habilitado.
Deshabilitada	ArgsVacíos	Evento desencadenado cuando el elemento de destino está deshabilitado.
La selección ha cambiado	ArmasDeSelección	Evento desencadenado cuando el valor de selección del elemento de destino cambia.
El ratón accedió	ArgsDeMovimientoDeJava	Evento desencadenado cuando el ratón accede a la parte visible del elemento de destino.
El ratón salió	ArgsDeMovimientoDeJava	Evento desencadenado cuando el ratón sale de la parte visible del elemento de destino.
Celda seleccionada	ArgsDeCeldasDeJava	Evento desencadenado cuando el elemento de destino es una celda de tabla y se selecciona.
Valor de la celda modificado	ArgsDeValorDeCeldaDeJava	Evento desencadenado cuando el elemento de destino es una celda de tabla y se modifica su valor.
Ratón pulsado	ArmasDeAcciónDeMouse	Evento desencadenado cuando cualquier botón del ratón se pulsa sobre el elemento de destino.
Botón del ratón soltado	ArmasDeAcciónDeMouse	Evento desencadenado cuando cualquier botón del ratón se suelta sobre el elemento de destino.
Menú seleccionado	ArgsVacíos	Evento desencadenado cuando el elemento de destino es un menú y se selecciona.
Menú sin seleccionar	ArgsVacíos	Evento desencadenado cuando el elemento de destino es un menú y no se selecciona.
Menú cancelado	ArgsVacíos	Evento desencadenado cuando el elemento de destino es un menú y se cancela.
Menú emergente visible	ArgsVacíos	Evento desencadenado cuando el elemento de destino es un menú emergente y se vuelve visible.
Menú emergente invisible	ArgsVacíos	Evento desencadenado cuando el elemento de destino es un menú emergente y se vuelve invisible.
Menú emergente cancelado	ArgsVacíos	Evento desencadenado cuando el elemento de destino es un menú emergente y se cancela.

Eventos WebTRL: elementos de la interfaz de usuario

Nota:

A partir de UiPath.UIAutomation.Activities v23.10.3, hemos añadido soporte para:

• Eventos nativos basados en WEBCTRL en navegadores integrados nativos (como Slack, Discord, Electron).

Tipo de evento	Tipo de ArgumentosDeEventoDesencadenador	Descripción
Apareció	ArgsVacíos	Evento desencadenado cuando aparece el elemento de destino.
Desapareció	ArgsVacíos	Evento desencadenado cuando el elemento de destino desaparece.
Texto cambiado	ArmasDeTextoCambiado	Evento desencadenado cuando cambia el texto del elemento de destino.
Tecla pulsada	ArmasDePresiónDeClaveDeWeb	Evento desencadenado cuando se pulsa una tecla mientras el foco está dentro del elemento de destino.
Clic	WebMouseEventArgs	Evento desencadenado cuando se hace clic en el elemento de destino.
Doble clic	WebMouseEventArgs	Evento desencadenado cuando se hace doble clic en el elemento de destino.
Clic derecho	WebMouseEventArgs	Evento desencadenado cuando se hace clic con el botón derecho del ratón en el elemento de destino.
Movimiento del ratón	WebMouseEventArgs	Evento desencadenado cuando el ratón se mueve sobre el elemento de destino.
Ratón pulsado	WebMouseEventArgs	Evento desencadenado cuando cualquier botón del ratón se pulsa sobre el elemento de destino.
Botón del ratón soltado	WebMouseEventArgs	Evento desencadenado cuando cualquier botón del ratón se suelta sobre el elemento de destino.
El ratón accedió	WebMouseEventArgs	Evento desencadenado cuando el ratón accede a la parte visible del elemento de destino.
El ratón salió	WebMouseEventArgs	Evento desencadenado cuando el ratón sale de la parte visible del elemento de destino.
Enfoque alcanzado	ArgsVacíos	Evento desencadenado cuando el elemento de destino obtiene el foco.
Enfoque perdido	ArgsVacíos	Evento desencadenado cuando el elemento de destino pierde el enfoque.
La selección de texto cambió	WebTextSelectionChangedArgs	Evento desencadenado cuando cambia el texto del elemento de destino.

Eventos HTML: elementos de la IU

Nota: Los siguientes tipos de eventos solo son compatibles con las aplicaciones web identificadas por los selectores <html> que solo tienen el atributo app:

• El estado de descarga ha cambiado
• Pestaña activada
• Pestaña creada
• Pestaña eliminada
• Pestaña actualizada

De momento, estos eventos solo se permiten cuando el selector de ventanas contiene la parte <html>, como <html app='chrome.exe' />. Otros atributos como title o url no están permitidos. Si el selector de ventana contiene atributos distintos de app, se genera un error de runtime.

El selector estricto debería estar vacío.

Estos tipos de eventos no son compatibles con los navegadores integrados.

Tipo de evento	Tipo de TriggerEventArgs	Descripción
El estado de descarga ha cambiado	DownloadChangedArgs	Evento desencadenado cuando cambia cualquiera de las propiedades de una DownloadItem.
Pestaña activada	TabActivatedArgs	Evento desencadenado cuando cambia la pestaña activa en una ventana. Nota: La URL de la pestaña puede no establecerse en el momento en que se desencadenó este evento, pero puedes escuchar los eventos onUpdated que se notificarán cuando se establezca una URL.
Pestaña creada	TabCreatedArgs	Evento desencadenado cuando se crea una pestaña. Nota: La URL de la pestaña y la pertenencia al grupo de pestañas pueden no establecerse en el momento en que se activa este evento, pero puedes escuchar los eventos onUpdated que se notificarán cuando se establezca una URL o la pestaña se añada a un grupo de pestañas.
Pestaña eliminada	TabRemovedArgs	Evento desencadenado cuando se cierra una pestaña.
Pestaña actualizada	TabUpdatedArgs	Evento desencadenado cuando se actualiza una pestaña.
Se inició la navegación de pestañas	TabNavigationStartedArgs	Evento desencadenado cuando se inició la navegación de pestañas a una URL específica.
Navegación de pestañas completada	TabNavigationCompletedArgs	Evento desencadenado cuando se completa la navegación de la pestaña a una URL específica.
El enfoque de la ventana ha cambiado	HtmlWindowFocusChangedArgs	Evento desencadenado cuando cambia la ventana actualmente enfocada.
Se han cambiado los límites de la ventana	HtmlWindowBoundsChangedArgs	Evento desencadenado cuando se ha cambiado el tamaño de una ventana. Solo se envía cuando se confirman los nuevos límites, y no para los cambios en curso.
Ventana creada	HtmlWindowCreatedArgs	Evento desencadenado cuando se crea una ventana.
Ventana eliminada	HtmlWindowRemovedArgs	Evento desencadenado cuando se elimina (se cierra) una ventana.
Solicitud web: Antes de la redirección	WebRequestBeforeRedirectArgs	Evento desencadenado cuando está a punto de producirse un redireccionamiento iniciado por el servidor.
Solicitud web: Antes de la solicitud	WebRequestBeforeRequestArgs	Evento desencadenado cuando una solicitud está a punto de ocurrir.
Solicitud web: Antes del envío de los encabezados de HTTP	WebRequestBeforeSendHeadersArgs	Evento desencadenado cuando está a punto de producirse una solicitud y se han preparado los encabezados iniciales. El evento está destinado a permitir que las extensiones añadan, modifiquen y eliminen encabezados de solicitud.
Solicitud web: Completada	WebRequestCompletedArgs	Evento desencadenado cuando una solicitud web se ha procesado correctamente.
Solicitud web: Se ha producido un error	WebRequestErrorOccurredArgs	Evento desencadenado cuando una solicitud web no se pudo procesar correctamente. La API de solicitud web garantiza que para cada solicitud, se dispare Completed o Error occurred como evento final con una excepción.
Solicitud web: Encabezados de HTTP recibidos	WebRequestHeadersReceivedArgs	Evento desencadenado cada vez que se recibe un encabezado de respuesta HTTP(S). Debido a las redirecciones y solicitudes de autenticación, esto puede ocurrir varias veces por solicitud.
Solicitud web: Respuesta iniciada	WebRequestResponseStartedArgs	Evento desencadenado cuando se recibe el primer byte del cuerpo de respuesta. Para las solicitudes HTTP, esto significa que la línea de estado y los encabezados de respuesta están disponibles. Este evento es informativo y se gestiona de forma asíncrona. No permite modificar o cancelar la solicitud.
Solicitud web: Enviar encabezados de HTTP	WebRequestSendHeadersArgs	Evento desencadenado después de que todas las extensiones hayan tenido la oportunidad de modificar los encabezados de la solicitud, presenta la versión final. El evento se desencadena antes de que los encabezados se envíen a la red. Este evento es informativo y se gestiona de forma asíncrona. No permite modificar o cancelar la solicitud.

Eventos de UIA: elementos de la IU

Tipo de evento	Tipo de ArgumentosDesencadenadorEventos	Descripción
Apareció	ArgsVacíos	Evento desencadenado cuando aparece el elemento de destino.
Desapareció	ArgsVacíos	Evento desencadenado cuando el elemento de destino desaparece.
Tecla pulsada	KeyPressArgs	Evento desencadenado cuando se pulsa una tecla mientras el foco está dentro del elemento de destino.
Clic	MouseClickedArgs	Evento desencadenado cuando se hace clic en el elemento de destino.
Texto cambiado	ArmasDeTextoCambiado	Evento desencadenado cuando cambia el texto del elemento de destino.
La selección de texto cambió	UiaTextSelectionChangedArgs	Evento desencadenado cuando cambia el texto del elemento de destino.
Enfoque alcanzado	ArgsVacíos	Evento desencadenado cuando el elemento de destino obtiene el foco.
Enfoque perdido	ArgsVacíos	Evento desencadenado cuando el elemento de destino pierde el enfoque.
Invocado	ArgsVacíos	Evento desencadenado al invocarse el elemento de destino.
Selected	ArmasDeSelección	Evento desencadenado al seleccionarse el elemento de destino.
Selección anulada	ArmasDeSelección	Evento desencadenado al deseleccionarse el elemento de destino.
cambiado	UiaToggledArgs	Evento desencadenado al conmutarse el elemento de destino

Propiedades de TriggerEventArgs

TriggerArgs

Clase base para todas las clases args relacionadas con desencadenadores.

Propiedad	Tipo	Descripción
TriggerName	Cadena	El nombre de la actividad del desencadenador que emitió este evento (que se muestra como nombre de la actividad).
TriggerType	Tipo	El tipo .NET de la actividad de desencadenador que emitió este evento.

ArmasDeDesencadenadorDeElemento de IU

Herencia: TriggerArgs > UiElementTriggerArgs

Propiedad	Tipo	Descripción
Selector	Cadena	El selector del elemento de destino.
TargetElement	ElementoDeIU	El elemento de destino supervisado.

NativeTriggerBaseArgs

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs

Propiedad	Tipo	Descripción
SelectorIndex	Entero	El índice del selector del elemento de destino.

ArgsVacíos

Devuelve datos de los siguientes eventos:

• Apareció
• Desapareció
• Enfoque alcanzado
• Enfoque perdido
• Habilitada
• Deshabilitada
• Menú seleccionado
• Menú sin seleccionar
• Menú cancelado
• Menú emergente visible
• Menú emergente invisible
• Menú emergente cancelado

Herencia: TriggerArgs > UiElementTriggerArgs > EmptyArgs

TextChangedArg

Devuelve datos de los siguientes eventos:

• Texto cambiado
• Título cambiado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TextChangedArgs

Propiedad	Tipo	Descripción
Text	Cadena	El nuevo texto para el elemento de destino.

ArmasDeEstadoCambiado

Devuelve datos de los siguientes eventos:

• Estado cambiado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > StateChangedArgs

Propiedad	Tipo	Descripción
State	Cadena	El nuevo estado para el elemento de destino.

ArmasDeSelección

Devuelve datos de los siguientes eventos:

• La selección ha cambiado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > SelectionChangedArgs

Propiedad	Tipo	Descripción
Selection	Cadena	La nueva selección para el elemento de destino.

ArgosCambiados

Devuelve datos de los siguientes eventos:

• Ubicación cambiada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > LocationChangedArgs

Propiedad	Tipo	Descripción
Location	Rectángulo	Rectángulo de la ubicación modificada, con información sobre el tamaño del elemento y su posición.

ArgumentosDeHwnd

Devuelve datos de los siguientes eventos:

• Primer plano cambiado
• Primer plano perdido
• Minimizado
• restaurado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HwndArgs

Propiedad	Tipo	Descripción
Hwnd	IntPtr	Identificador de ventana.
HwndAsString	Cadena	Identificador de ventana como string.

KeyPressArgs

Devuelve datos de los siguientes eventos de los elementos WND y CTRL:

• Tecla pulsada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > KeyPressArgs

Propiedad	Tipo	Descripción
Key	Entero	La clave con la que se interactuó.
ScanCode	Entero	El código de escaneo correspondiente a la clave con la que se interactuó.
KeyAction	Entero	Indica si la tecla se presionó o se soltó. Valores posibles: 0 : se ha pulsado la tecla 1 : se ha liberado la clave
KeyModifiers	ModificadoresDeClave	El modificador de clave utilizado junto con la clave. Valores posibles: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

MouseClickedArgs

Devuelve datos de los siguientes eventos de los elementos WND y CTRL:

• Clic

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > MouseClickedArgs

Propiedad	Tipo	Descripción
X	Entero	La coordenada X del puntero del ratón.
Y	Entero	La coordenada Y del puntero del ratón.
MouseButton	Entero	El botón del ratón en el que se hizo clic. Valores posibles: 0 : ninguno 1 : izquierda 2 : medio 3 : derecha
MouseAction	Entero	Indica si se ha pulsado o soltado el botón del ratón. Valores posibles: 0 : se presionó el botón del ratón 1 : se soltó el botón del ratón
KeyModifiers	ModificadoresDeClave	El modificador de clave utilizado junto con el botón del ratón. Valores posibles: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

ArmasDePulsaciónDeClaveDeJava

Devuelve datos de los siguientes eventos para Java:

• Tecla pulsada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaKeyPressArgs

Propiedad	Tipo	Descripción
KeyChar	Cadena	El carácter correspondiente a la tecla pulsada.
KeyCode	Entero	El código correspondiente a la tecla pulsada.
ExtendedKeyCode	Entero	El código de tecla ampliado para la tecla pulsada. A diferencia de KeyCode, este valor depende de la distribución actual del teclado.
Location	Cadena	La ubicación de la clave que originó el evento.
KeyModifiers	ModificadoresDeClave	El modificador de clave utilizado junto con la clave. Valores posibles: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

ArmasDeAcciónDeMouse

Devuelve datos de los siguientes eventos para Java:

• Clic
• Ratón pulsado
• Botón del ratón soltado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseActionArgs

Propiedad	Tipo	Descripción
X	Entero	La coordenada X del puntero del ratón.
Y	Entero	La coordenada Y del puntero del ratón.
Button	Entero	El botón del ratón en el que se hizo clic. Valores posibles: 1 : izquierda 2 : medio 3 : derecha
ClickCount	Entero	El número de veces que se ha hecho clic en el botón.
KeyModifiers	ModificadoresDeClave	El modificador de clave utilizado junto con el botón del ratón. Valores posibles: None = 0 Alt = 1 Ctrl = 2 Shift = 4 Win = 8

ArgsDeMovimientoDeJava

Devuelve datos de los siguientes eventos para Java:

• Movimiento del ratón
• El ratón accedió
• El ratón salió

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaMouseMotionArgs

Propiedad	Tipo	Descripción
X	Entero	La coordenada X del puntero del ratón.
Y	Entero	La coordenada Y del puntero del ratón.
MouseButton	Entero	El botón del ratón en el que se ha hecho clic Valores posibles: 0 : ninguno 1 : izquierda 2 : medio 3 : derecha

ArgsDeCeldasDeJava

Devuelve datos de los siguientes eventos para Java:

• Clic

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellSelectedArgs

Propiedad	Tipo	Descripción
Row	Entero	Fila de celda seleccionada.
Column	Entero	Columna de celda seleccionada.

ArgsDeValorDeCeldaDeJava

Devuelve datos de los siguientes eventos para Java:

• Clic

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > JavaCellValueChangedArgs

Propiedad	Tipo	Descripción
Row	Entero	Fila de celdas.
Column	Entero	Columna de celda.
Value	Cadena	Nuevo valor de la celda.

WebMouseEventArgs

Devuelve datos de los siguientes eventos para WEBCTRL:

• Clic
• Doble clic
• Clic derecho
• Movimiento del ratón
• El ratón accedió
• El ratón salió
• Ratón pulsado
• Botón del ratón soltado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebMouseEventArgs

Nota: Sigue los nombres de propiedad definidos para los Eventos de ratón.

Propiedad	Tipo	Descripción
AltKey	Booleano	Si se pulsa la tecla ALT.
Button	Entero	Qué botón del ratón se pulsa. Valores posibles: 0 : izquierda 1 : medio 2 : derecha
ClientX	Entero	La coordenada X del puntero del ratón (relativa a la ventana).
ClientY	Entero	La coordenada Y del puntero del ratón (relativa a la ventana).
CtrlKey	Booleano	Si se pulsa la tecla CTRL.
MetaKey	Booleano	Si se pulsa la tecla META.
MovementX	Entero	La coordenada X del puntero del ratón (relativa a la posición del último evento mousemove).
MovementY	Entero	La coordenada Y del puntero del ratón (relativa a la posición del último evento mousemove).
OffsetX	Entero	La coordenada X del puntero del ratón (relativa al destino).
OffsetY	Entero	La coordenada Y del puntero del ratón (relativa al destino).
PageX	Entero	La coordenada X del puntero del ratón (relativa al documento).
PageY	Entero	La coordenada Y del puntero del ratón (relativa al documento).
ScreenX	Entero	La coordenada X del puntero del ratón (relativa a la pantalla).
ScreenY	Entero	La coordenada Y del puntero del ratón (relativa a la pantalla).
ShiftKey	Booleano	Si se pulsa la tecla MAYÚSCULAS.

ArmasDePresiónDeClaveDeWeb

Devuelve datos de los siguientes eventos para WEBCTRL:

• Tecla pulsada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebKeyPressArgs

Nota: Sigue los nombres de propiedad definidos para los Eventos de teclado .

Propiedad	Tipo	Descripción
AltKey	Booleano	Si se pulsa la tecla ALT.
Code	Cadena	El código de la clave que desencadenó el evento (por ejemplo, KeyA, KeyB, ControlLeft, ControlRight).
CtrlKey	Booleano	Si se pulsa la tecla CTRL.
IsComposing	Booleano	Si el estado del evento es de composición o no.
Key	Cadena	El valor de la clave que desencadenó el evento (por ejemplo, a, b, Control).
Location	Entero	La ubicación de una tecla en el teclado o dispositivo. Valores posibles: 0 (Estándar) representa casi todas las teclas del teclado 1 : se ha pulsado la tecla izquierda 2 : se ha pulsado la tecla derecha 3 : la tecla se pulsó en el teclado numérico
MetaKey	Booleano	Si se pulsa la tecla META.
Repeat	Booleano	Si una tecla se mantiene pulsada repetidamente, o no.
ShiftKey	Booleano	Si se pulsa la tecla MAYÚSCULAS.

WebTextSelectionChangedArgs

Devuelve datos de los siguientes eventos para WEBCTRL:

• La selección de texto cambió

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebTextSelectionChangedArgs

Nota: Sigue los nombres de propiedad definidos para los Eventos de teclado .

Propiedad	Tipo	Descripción
AnchorClientBounds	Rectángulo	Los límites del cliente de anclaje: información sobre el tamaño del elemento y su posición relativa a la ventana gráfica.
AnchorElement	ElementoDeIU	El elemento de anclaje de la IU.
AnchorOffset	Entero	El índice basado en 0 del carácter donde se inició la selección de texto (del texto completo del elemento de destino).
FocusClientBounds	Rectángulo	Los límites del cliente de enfoque: información sobre el tamaño del elemento y su posición relativa a la ventana gráfica.
FocusElement	ElementoDeIU	El elemento de IU de enfoque.
FocusOffset	Entero	El índice basado en 0 del carácter donde se finalizó la selección de texto (del texto completo del elemento de destino).
SelectedText	Cadena	La nueva selección de texto para el elemento de destino.

DownloadChangedArgs

Devuelve datos de los siguientes eventos para WEBCTRL:

• El estado de descarga ha cambiado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > DownloadChangedArgs

Propiedad	Tipo	Descripción
State	Cadena	El string que describe un cambio en la downloads.DownloadItem de una state.
Id	Cadena	La id de la downloads.DownloadItem que cambió.
FileName	Cadena	El string que describe un cambio en la downloads.DownloadItem de una url.
Url	Cadena	El string que describe un cambio en la downloads.DownloadItem de una filename.
StartTime	Cadena	El string que describe un cambio en la downloads.DownloadItem de una startTime.
EndTime	Cadena	El string que describe un cambio en la downloads.DownloadItem de una endTime.
Error	Cadena	El string que describe un cambio en el estado de la downloads.DownloadItem de una error.

TabActivatedArgs

Devuelve datos de los siguientes eventos para WEBCTRL:

• Pestaña activada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabActivatedArgs

Propiedad	Tipo	Descripción
TabId	Cadena	El ID de la pestaña que ha sido activada.
WindowId	Cadena	El ID de la ventana dentro de la cual cambió la pestaña seleccionada.
Title	Cadena	El nuevo título de la pestaña.
Url	Cadena	La URL de la pestaña si ha cambiado.

TabCreatedArgs

Devuelve datos de los siguientes eventos para WEBCTRL:

• Pestaña creada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabCreatedArgs

Propiedad	Tipo	Descripción
TabId	Cadena	El ID de la pestaña que se ha creado.
WindowId	Cadena	El ID de la ventana que contiene la pestaña.
Title	Cadena	El nuevo título de la pestaña.
Url	Cadena	La URL de la pestaña.

TabRemovedArgs

Devuelve datos de los siguientes eventos para WEBCTRL:

• Pestaña eliminada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabRemovedArgs

Propiedad	Tipo	Descripción
TabId	Cadena	El ID de la pestaña que se ha eliminado.
WindowId	Cadena	El ID de la ventana cuya pestaña está cerrada.
IsWindowClosing	Booleano	True cuando se cerró la pestaña porque su ventana principal estaba cerrada.

TabUpdatedArgs

Devuelve datos de los siguientes eventos para WEBCTRL:

• Pestaña actualizada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabUpdatedArgs

Propiedad	Tipo	Descripción
TabId	Cadena	El ID de la pestaña que se ha actualizado.
WindowId	Cadena	El ID de la ventana que contiene la pestaña.
Status	Cadena	El estado de carga de la pestaña.
Title	Cadena	El nuevo título de la pestaña.
Url	Cadena	La URL de la pestaña si ha cambiado.
Active	Booleano	Si la pestaña está activa en su ventana. No significa necesariamente que la ventana esté enfocada.

TabNavigationStartedArgs

Devuelve datos de los siguientes eventos para HTML:

• Se inició la navegación de pestañas

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationStartedArgs

Propiedad	Tipo	Descripción
Url	Cadena	La URL actualmente asociada con el marco, si el marco identificado por FrameId existió en un punto de la pestaña dada. El hecho de que una URL esté asociada a un FrameId dado no implica que el marco correspondiente siga existiendo.
TabId	Entero	El ID de la pestaña en la que se encuentra el marco.
FrameId	Entero	El ID del marco dentro de la pestaña, para el que se activó el evento iniciado, lo que dio lugar a la navegación por pestañas. Los marcos se identifican de forma única por su TabId y FrameId.
TimeStampMs	Double	La hora a la que se inició la navegación por pestañas, en milisegundos desde el epoch. Solo se garantiza la coherencia interna de la propiedad TimeStampMs de los eventos de navegación web. Comparar un evento con otro te dará el desplazamiento correcto entre ellos, pero compararlos con la hora actual dentro de la extensión (a través (new Date()).getTime(), por ejemplo) puede dar resultados inesperados.
DateTime	Fecha	La fecha y hora en que se inició la navegación por pestañas (UTC).

TabNavigationCompletedArgs

Devuelve datos de los siguientes eventos para HTML:

• Navegación de pestañas completada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > TabNavigationCompletedArgs

Propiedad	Tipo	Descripción
Url	Cadena	La URL actualmente asociada con este marco, si el marco identificado por FrameId existió en un punto de la pestaña dada. El hecho de que una URL esté asociada a un FrameId dado no implica que el marco correspondiente siga existiendo.
TabId	Entero	El ID de la pestaña en la que se encuentra el marco.
FrameId	Entero	El ID del marco dentro de la pestaña, para el que se activó el evento completado, lo que dio lugar a la navegación por pestañas. Los marcos se identifican de forma única por su TabId y FrameId.
TimeStampMs	Double	La hora a la que se completó la navegación por pestañas, en milisegundos desde el epoch. Solo se garantiza la coherencia interna de la propiedad TimeStampMs de los eventos de navegación web. Comparar un evento con otro te dará el desplazamiento correcto entre ellos, pero compararlos con la hora actual dentro de la extensión (a través (new Date()).getTime(), por ejemplo) puede dar resultados inesperados.
DateTime	Fecha	La fecha y hora en que se completó la navegación por pestañas (UTC).

HtmlWindowFocusChangedArgs

Devuelve datos de los siguientes eventos para HTML:

• El enfoque de la ventana ha cambiado

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowFocusChangedArgs

Propiedad	Tipo	Descripción
TabId	Cadena	El ID de la pestaña recién enfocada.
WindowId	Cadena	El ID de la ventana que contiene la pestaña.
Title	Cadena	El título de la pestaña.
Url	Cadena	La URL de la pestaña si ha cambiado.

HtmlWindowBoundsChangedArgs

Devuelve datos de los siguientes eventos para HTML:

• Se han cambiado los límites de la ventana

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowBoundsChangedArgs

Propiedad	Tipo	Descripción
WindowId	Cadena	El ID de la ventana cuyos límites han cambiado.
Focused	Booleano	Si la ventana es actualmente la ventana enfocada.
Top	Entero	El desplazamiento de la ventana desde el borde superior de la pantalla en píxeles.
Left	Entero	El desplazamiento de la ventana desde el borde izquierdo de la pantalla en píxeles.
Width	Entero	El ancho de la ventana, incluido el marco, en píxeles.
Height	Entero	La altura de la ventana, incluido el marco, en píxeles.

HtmlWindowCreatedArgs

Devuelve datos de los siguientes eventos para HTML:

• Ventana creada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowCreatedArgs

Propiedad	Tipo	Descripción
WindowId	Cadena	El ID de la ventana creada.

HtmlWindowRemovedArgs

Devuelve datos de los siguientes eventos para HTML:

• Ventana eliminada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > HtmlWindowRemovedArgs

Propiedad	Tipo	Descripción
WindowId	Cadena	El ID de la ventana eliminada.

WebRequestBaseArgs

Clase base para eventos de solicitud web args para HTML.

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs

Propiedad	Tipo	Descripción
FrameId	Cadena	El ID del marco en el que se produce la solicitud.
Initiator	Cadena	El origen donde se inició la solicitud.
Method	Cadena	Método HTTP estándar.
ParentFrameId	Cadena	El ID del marco que envuelve el marco que envió la solicitud.
RequestId	Cadena	El ID de la solicitud.
TabId	Cadena	El ID de la pestaña en la que tiene lugar la solicitud.
TimeStamp	Cadena	El tiempo en que se desencadena esta señal, en milisegundos desde el epoch.
Type	Cadena	Cómo se utilizará el recurso solicitado.
Url	Cadena	La URL.

WebRequestHeadersReceivedArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Encabezados de HTTP recibidos

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs

Propiedad	Tipo	Descripción
ResponseHeaders	Cadena	Los encabezados de respuesta HTTP que se han recibido con esta respuesta.
StatusCode	Cadena	Código de estado HTTP estándar devuelto por el servidor.
StatusLine	Cadena	Línea de estado HTTP de la respuesta.

WebResponseCacheDetailsArgs

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs

Propiedad	Tipo	Descripción
FromCache	Booleano	Indica si esta respuesta se obtuvo de la caché de disco.
Ip	Cadena	La dirección IP del servidor a la que se envió realmente la solicitud.

WebRequestBeforeRedirectArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Antes de la redirección

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebResponseCacheDetailsArgs > WebRequestBeforeRedirectArgs

Propiedad	Tipo	Descripción
RedirectUrl	Cadena	La URL de redirección.

WebRequestBeforeRequestArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Antes de la solicitud

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeRequestArgs

WebRequestBeforeSendHeadersArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Antes del envío de los encabezados de HTTP

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestBeforeSendHeadersArgs

Propiedad	Tipo	Descripción
RequestHeaders	Cadena	Los encabezados de la solicitud HTTP que se enviarán con esta solicitud.

WebRequestCompletedArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Completada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestHeadersReceivedArgs > WebResponseCacheDetailsArgs > WebRequestCompletedArgs

WebRequestErrorOccurredArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Se ha producido un error

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestErrorOccurredArgs

Propiedad	Tipo	Descripción
Error	Cadena	La descripción del error.
FromCache	Booleano	Indica si esta respuesta se obtuvo de la caché de disco.
Ip	Cadena	La dirección IP del servidor a la que se envió realmente la solicitud.

WebRequestResponseStartedArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Respuesta iniciada

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs → WebRequestHeadersReceivedArgs→ WebResponseCacheDetailsArgs→ WebRequestResponseStartedArgs

WebRequestSendHeadersArgs

Devuelve datos de los siguientes eventos para HTML:

• Solicitud web: Enviar encabezados de HTTP

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > WebRequestBaseArgs > WebRequestSendHeadersArgs

Propiedad	Tipo	Descripción
RequestHeaders	Cadena	Los encabezados de la solicitud HTTP que se enviarán con esta solicitud.

UiaToggledArgs

Devuelve datos de los siguientes eventos para UIA:

• Eventos activados

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaToggledArgs

Propiedad	Tipo	Descripción
State	Cadena	El nuevo estado para el elemento de destino.

UiaTextSelectionChangedArgs

Devuelve datos de los siguientes eventos para UIA:

• Eventos de selección de texto cambiados

Herencia: TriggerArgs > UiElementTriggerArgs > NativeTriggerBaseArgs > UiaTextSelectionChangedArgs

Propiedad	Tipo	Descripción
TextRanges	UiaTextRange()	Matriz que contiene información diferente sobre los elementos de texto seleccionados en el elemento de destino (podemos tener varios elementos de texto seleccionados en caso de selección de texto no adyacente). Cada elemento de esta matriz expone la siguiente información: Text (tipo String): selección de texto para ese elemento de texto seleccionado. Ejemplo: TriggerEventArgs.TextRanges(0).Text representa el texto del primer elemento de texto seleccionado. BoundingRectangles (tipo Rectangle()) : matriz de rectángulos delimitadores para el elemento de texto seleccionado. Un elemento de texto seleccionado puede tener varios rectángulos delimitadores asociados a él si abarca varias líneas. Cada rectángulo delimitador es de tipo Rectangle {X, Y, Width, Height} y proporciona información sobre la posición y el tamaño del elemento. Ejemplo: TriggerEventArgs.TextRanges(0).BoundingRectangles(0) representa el rectángulo delimitador de la primera línea en el primer elemento de texto seleccionado.

Herramienta de inspección de eventos

En el contexto de la automatización attended basada en desencadenadores, la herramienta de inspección de eventos puede utilizarse para identificar el tipo de eventos nativos que se desencadenan al interactuar con ciertos elementos de la IU en una aplicación y luego puede utilizarse para configurar la actividad Desencadenador de eventos de la aplicación. La herramienta captura y supervisa todos los tipos de eventos seleccionados, como Hacer clic, Tecla pulsada, Enfoque obtenido, Enfoque perdido y otras interacciones relevantes, lo que te permite analizar las acciones realizadas y si corresponde, diagnosticar incidencias.

La herramienta de inspección de eventos puede abrirse desde el UI Explorer una vez que se selecciona un elemento de IU válido, haciendo clic en el botón Inspeccionar eventos de la barra de herramientas.

La barra de herramientas consta de las siguientes opciones:

• Grabar: los eventos generados al interactuar con el elemento de IU se graban y se añaden a la lista de eventos.
• Pausa: los eventos generados por el elemento de IU al interactuar con él ya no se registran.
• Resaltar: muestra el contorno del elemento de destino y lo pone en primer plano durante unos segundos. El resaltado permanece activo hasta que se deshabilita.
• Abrir en UI Explorer: el elemento supervisado se abre en UI Explorer, donde puedes observar el selector de ese elemento.

Una vez que inicias la grabación de eventos, estarán disponibles dos opciones más:

• Borrar: elimina todos los eventos grabados.
• CSV: los eventos capturados pueden exportarse a un archivo .csv para su posterior análisis.

La ventana de Herramienta de inspección de eventos tiene dos secciones principales:

• Filtro de eventos: permite seleccionar los tipos de eventos que quieres supervisar para el elemento de destino.
• Lista de eventos: muestra información sobre los eventos capturados.

Puedes filtrar los tipos de eventos a capturar habilitando o deshabilitando las casillas de verificación de la lista de tipos de eventos. La lista puede variar en función de la tecnología del elemento seleccionado.

Todos los tipos de eventos del ratón (mover el ratón, pulsar el ratón, soltar el ratón, introducir con el ratón, salir con el ratón), específicos para los elementos de la IU Web o Java, están deshabilitados de forma predeterminada porque la lista de eventos, en estos casos, puede llegar a ser bastante grande. Nuestra recomendación es habilitar los tipos de eventos del ratón solo si tienes una necesidad específica de supervisarlos.

Además, vale la pena mencionar que los tipos de eventos pueden habilitarse o deshabilitarse incluso después de iniciar la grabación de eventos.

La lista de eventos tiene tres columnas:

• Nombre del evento: el tipo de evento.
• Marca de tiempo: la fecha y la hora en que se realizó el evento.
• Datos de los eventos: los datos y parámetros asociados para un determinado evento.

Cada columna puede ordenarse en orden ascendente o descendente. Los eventos se muestran de forma predeterminada en el orden en que se realizaron.

Cuando se encuentra el tipo de evento Desaparecido, ya no podrás seguir supervisando y se mostrará un mensaje de error en pantalla. Al hacer clic en cualquier opción de la barra de herramientas, se muestra el mismo mensaje de error en la pantalla. Las únicas opciones disponibles son borrar los datos o exportarlos a un archivo .csv. Para empezar a supervisar de nuevo, cierra la ventana y abre otra instancia de la herramienta de inspección de eventos.