AutomationElement.GetClickablePoint Methode

Definitie

Hiermee haalt u een punt op waarop AutomationElement kan worden geklikt.

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

Retouren

De fysieke schermcoƶrdinaten van een punt dat door een client kan worden gebruikt om op dit element te klikken.

Uitzonderingen

Er is geen klikbaar punt.

De gebruikersinterface voor de AutomationElement app bestaat niet meer.

Voorbeelden

Met de volgende code wordt een klikbaar punt voor een besturingselement opgehaald en wordt de systeemcursor naar dat punt verplaatst.

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

Opmerkingen

Een AutomationElement is niet klikbaar als het volledig wordt bedekt door een ander venster.

Een AutomationElement kan worden geklikt wanneer deze voldoet aan alle volgende voorwaarden:

  • Het is programmatisch zichtbaar en beschikbaar met de UI Automation boomstructuur.

  • Het wordt volledig in beeld geschoven binnen de bovenliggende container, indien van toepassing. Als het element is geknipt, is er geen garantie dat het erop kan worden geklikt.

  • Het element wordt niet verborgen door een ander UI-element. Als het element gedeeltelijk wordt verborgen door een ander UI-element dan de bovenliggende elementen, is het mogelijk niet klikbaar.

  • Het venster met het element moet zelf kunnen worden geklikt. Het venster kan bijvoorbeeld niet worden geklikt als het venster volledig transparant is. Met muisklikken klikt u door naar het venster eronder, zodat besturingselementen in het transparante venster geen klikbare punten retourneren.

  • Als het element een container is (zoals lijst- of boomstructuurweergave), moet het een punt hebben dat wanneer erop wordt geklikt, de achtergrond van het besturingselement wordt gericht. Als elk deel van het containerbeheer wordt bezet door een onderliggend element, kan het niet worden geklikt.

Er is geen garantie dat een besturingselement iets doet wanneer op een punt wordt geklikt dat is gedefinieerd als klikbaar door de UI Automation-provider. U kunt in plaats daarvan besturingspatronen gebruiken om acties uit te voeren op besturingselementen.

Van toepassing op

Zie ook