Description des options générales

Ce module est disponible à partir des versions postérieures au 20260507

Plusieurs interfaces ui_element acceptent une table d’options permettant d’indiquer l’application cible, le nombre de résultats, la profondeur de récursion, la vérification de détection et le pas de défilement.

Options de requête

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

• pid
  type entier, identifiant de processus de l’application cible. En l’absence de valeur, l’application au premier plan est généralement utilisée.
• max_level
  type entier, profondeur de récursion des éléments enfants. Les valeurs 1 ou 2 sont couramment utilisées pour contrôler la quantité de données renvoyées.
• max_elements
  type entier, nombre maximal d’éléments de premier niveau renvoyés.
• fallback_children
  type booléen, tente de lire les éléments enfants lorsque la liste ordinaire est vide. La valeur par défaut varie selon l’interface.
• include_hit_state
  type booléen, indique s’il faut compléter les champs de l’état de détection.
• hit_test
  type booléen, indique s’il faut activer la détection par échantillonnage de l’écran. Les scripts ordinaires n’ont généralement pas besoin de l’activer.
• fallback_hit_test
  type booléen, indique s’il faut tenter la détection par échantillonnage lorsque la liste ordinaire est vide.
• hit_test_spacing
  type numérique, espacement des échantillons à l’écran, en coordonnées logiques. 40 par défaut.

Options d’action

• point
  type table, point utilisé pour le défilement ou la détection, par exemple { x = 200, y = 700 }, en pixels physiques.
• x / y
  type entier, équivalents de point, pouvant être placés directement dans la table d’options.
• steps
  type numérique, paramètre de pas utilisé pour les opérations de défilement, d’augmentation ou de diminution. L’effet exact dépend du contrôle cible.

Description

list_text_elements() est plus conservatrice par défaut pour assurer la compatibilité avec les anciens scripts. find(), find_all(), snapshot() et les interfaces d’action conviennent mieux à une utilisation directe dans les nouveaux scripts. hit_test peut renvoyer un élément plus proche de la couche supérieure actuelle de l’interface, mais son coût est plus élevé ; il est recommandé de ne l’utiliser que si une requête ordinaire ne trouve aucun élément.