AutomationElement.GetClickablePoint Metodo

Definizione

Recupera un punto sull'oggetto AutomationElement selezionabile.Retrieves a point on the AutomationElement that can be clicked.

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

Restituisce

Coordinate dello schermo fisico di un punto che può essere usato da un client per fare clic su questo elemento.The physical screen coordinates of a point that can be used by a client to click on this element.

Eccezioni

Non ci sono punti selezionabili.There is no clickable point.

L'interfaccia utente per AutomationElement non esiste più.The UI for the AutomationElement no longer exists.

Esempi

Il codice seguente recupera un punto selezionabile per un controllo e sposta il cursore di sistema fino a tale punto.The following code retrieves a clickable point for a control and moves the system cursor to that point.

// 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))

Commenti

Un AutomationElement oggetto non è selezionabile se è completamente nascosto da un'altra finestra.An AutomationElement is not clickable if it is completely obscured by another window.

Un AutomationElement oggetto è selezionabile quando soddisfa tutte le condizioni seguenti:An AutomationElement is clickable when it satisfies all the following conditions:

  • È visibile a livello di codice e disponibile con Automazione interfaccia utenteUI Automation l'albero.It is programmatically visible and available with the Automazione interfaccia utenteUI Automation tree.

  • Viene visualizzato completamente nella visualizzazione all'interno del contenitore padre, se disponibile.It is scrolled fully into view within its parent container, if any. Se l'elemento viene troncato, non è garantito che sia selezionabile.If the element is clipped, there is no guarantee that it is clickable.

  • L'elemento non è nascosto da un altro elemento dell'interfaccia utente.The element is not obscured by any other UI element. Se l'elemento è parzialmente nascosto da alcuni elementi dell'interfaccia utente diversi dai relativi predecessori, potrebbe non essere selezionabile.If the element is partially obscured by some UI element other than its ancestors, it might not be clickable.

  • La finestra contenente l'elemento deve essere selezionabile.The window containing the element must itself be clickable. La finestra, ad esempio, non è selezionabile se la finestra contenitore è completamente trasparente.For example, the window is not clickable if the containing window is completely transparent. I clic del mouse faranno clic sulla finestra sottostante, pertanto tutti i controlli all'interno della finestra trasparente non restituiranno punti selezionabili.Mouse clicks will click through to the window underneath, so any controls within the transparent window will not return clickable points.

  • Se l'elemento è un contenitore, ad esempio un elenco o una visualizzazione albero, deve disporre di un punto che, quando selezionato, provocherà lo stato attivo dello sfondo del controllo.If the element is a container (such as list or tree view), it must have a point that when clicked will cause the background of the control to be focused. Se ogni parte del controllo contenitore è occupata da un elemento figlio, non è selezionabile.If every part of the container control is occupied by a child element, it is not clickable.

Non vi è alcuna garanzia che un controllo esegua alcuna operazione quando si fa clic su un punto definito come selezionabile dal provider di automazione interfaccia utente.There is no guarantee that a control will do anything when clicked on a point defined as clickable by the UI Automation provider. È consigliabile usare invece i pattern di controllo per eseguire azioni sui controlli.Consider using control patterns instead to perform actions on controls.

Si applica a

Vedi anche