Descripción de las opciones comunes

Este módulo solo está disponible a partir de las versiones posteriores a 20260507

Varias interfaces de ui_element aceptan una tabla de opciones para especificar la aplicación objetivo, la cantidad devuelta, la profundidad recursiva, la verificación de impacto y los pasos de desplazamiento.

Opciones de consulta

local options = {
    pid = app.front_pid(),
    max_level = 2,
    max_elements = 200,
    include_hit_state = true,
}

• pid Tipo entero: especifica el identificador de proceso de la aplicación objetivo. Si no se proporciona, normalmente se usa la aplicación en primer plano.
• max_level Tipo entero: profundidad recursiva de los elementos secundarios. Usar normalmente 1 o 2 controla la cantidad de datos devueltos.
• max_elements Tipo entero: cantidad máxima de elementos de nivel superior que se devolverán.
• fallback_children Tipo booleano: intenta leer los elementos secundarios cuando la lista normal está vacía. El valor predeterminado varía según la interfaz.
• include_hit_state Tipo booleano: indica si se deben añadir los campos del estado de impacto.
• hit_test Tipo booleano: indica si se debe habilitar la detección de impacto mediante muestreo de pantalla. Normalmente no es necesario activarla en scripts comunes.
• fallback_hit_test Tipo booleano: indica si se debe intentar la detección de impacto mediante muestreo de pantalla cuando la lista normal está vacía.
• hit_test_spacing Tipo numérico: intervalo del muestreo de pantalla, en coordenadas lógicas. El valor predeterminado es 40.

Opciones de acción

• point Tipo tabla: especifica el punto de coordenadas que se usará para desplazarse o detectar el impacto; por ejemplo, { x = 200, y = 700 }, en píxeles físicos.
• x / y Tipo entero: equivalente a point; se puede colocar directamente en la tabla de opciones.
• steps Tipo numérico: parámetro de pasos para las operaciones de desplazamiento, aumento o disminución. El efecto concreto depende del control objetivo.

Descripción

list_text_elements() se conserva para compatibilidad con scripts antiguos y es más conservadora de forma predeterminada. find(), find_all(), snapshot() y las interfaces de acción son más adecuadas para usarlas directamente en scripts nuevos. hit_test puede devolver un elemento más cercano a la capa superior actual de la interfaz, pero tiene un coste mayor; se recomienda usarlo solo cuando la consulta normal no encuentre elementos.