AutomationElement.GetClickablePoint Método

  • Referencia

Definición

Espacio de nombres:
System.Windows.Automation
Ensamblado:
UIAutomationClient.dll

Recupera un punto en AutomationElement en el que se puede hacer clic.

public:
 System::Windows::Point GetClickablePoint();
public System.Windows.Point GetClickablePoint ();
member this.GetClickablePoint : unit -> System.Windows.Point
Public Function GetClickablePoint () As Point

Devoluciones

Point

Las coordenadas físicas de la pantalla de un punto que un cliente puede usar para hacer clic en este elemento.

Excepciones

NoClickablePointException

No hay ningún punto interactivo.

ElementNotAvailableException

La interfaz de usuario para el AutomationElement ya no existe.

Ejemplos

El código siguiente recupera un punto que se puede hacer clic para un control y mueve el cursor del sistema a ese punto.

// element is an AutomationElement.
System.Windows.Point clickablePoint = element.GetClickablePoint();
System.Windows.Forms.Cursor.Position = 
    new System.Drawing.Point((int)clickablePoint.X, (int)clickablePoint.Y);

' element is an AutomationElement.
Dim clickablePoint As System.Windows.Point = element.GetClickablePoint()
System.Windows.Forms.Cursor.Position = New System.Drawing.Point(CInt(clickablePoint.X), CInt(clickablePoint.Y))

Comentarios

No AutomationElement se puede hacer clic en si otra ventana la oculta por completo.

Se AutomationElement puede hacer clic cuando cumple todas las condiciones siguientes:

  • Está visible y disponible mediante programación con el árbol de Automatización de la interfaz de usuario.

  • Se desplaza por completo en la vista dentro de su contenedor primario, si existe. Si el elemento se recorta, no hay ninguna garantía de que se pueda hacer clic en él.

  • El elemento no está oculto por ningún otro elemento de interfaz de usuario. Si el elemento está parcialmente oculto por algún elemento de interfaz de usuario distinto de sus antecesores, es posible que no se pueda hacer clic en él.

  • Se debe hacer clic en la ventana que contiene el elemento. Por ejemplo, la ventana no se puede hacer clic si la ventana contenedora es completamente transparente. Los clics del mouse harán clic en la ventana debajo, por lo que los controles dentro de la ventana transparente no devolverán puntos que se puedan hacer clic.

  • Si el elemento es un contenedor (como la lista o la vista de árbol), debe tener un punto que cuando se haga clic hará que el fondo del control se centre. Si cada parte del control contenedor está ocupada por un elemento secundario, no se puede hacer clic en él.

No hay ninguna garantía de que un control haga nada cuando se haga clic en un punto definido como seleccionable por el proveedor de Automatización de la interfaz de usuario. Considere la posibilidad de usar patrones de control en su lugar para realizar acciones en los controles.

Se aplica a

Consulte también