AutomationElement.GetClickablePoint AutomationElement.GetClickablePoint AutomationElement.GetClickablePoint AutomationElement.GetClickablePoint Method

정의

AutomationElement에서 클릭할 수 있는 지점을 검색합니다.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

반환

클라이언트에서 이 요소를 클릭하는 데 사용할 수 있는 지점의 실제 화면 좌표입니다.The physical screen coordinates of a point that can be used by a client to click on this element.

예외

클릭할 수 있는 지점이 없습니다.There is no clickable point.

예제

다음 코드는 컨트롤에 클릭 가능한 지점을 검색 하 고 해당 지점에 시스템 커서를 이동 합니다.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))

설명

AutomationElement 완전히 다른 창으로 가려진 경우 클릭 가능한 아닙니다.An AutomationElement is not clickable if it is completely obscured by another window.

AutomationElement 클릭할 수 있는 경우 다음 조건이 모두 충족 합니다.An AutomationElement is clickable when it satisfies all the following conditions:

  • 프로그래밍 방식으로 볼 수 있고 제공 된 UI 자동화UI Automation 트리.It is programmatically visible and available with the UI 자동화UI Automation tree.

  • 이 완벽 하 게 뷰로 스크롤 해당 부모 컨테이너 내에서 있는 경우.It is scrolled fully into view within its parent container, if any. 잘린 요소는 경우 클릭 가능한 임을 보장할 수 없습니다.If the element is clipped, there is no guarantee that it is clickable.

  • 요소는 다른 UI 요소에 의해 숨겨지지 않습니다.The element is not obscured by any other UI element. 상위 이외의 일부 UI 요소로 가려진는 요소는 클릭 가능한 되지 않을 수 있습니다.If the element is partially obscured by some UI element other than its ancestors, it might not be clickable.

  • 창 요소를 포함 하는 자체가 클릭 가능한 이어야 합니다.The window containing the element must itself be clickable. 예를 들어, 완전히 투명 하 게 포함 하는 창의 경우에를 창을 클릭할 수 없습니다.For example, the window is not clickable if the containing window is completely transparent. 마우스 클릭을 클릭을 통해 하위 창에 투명 한 창 내에서 모든 컨트롤에 클릭 가능한 지점만 반환 되지 것입니다 있도록 합니다.Mouse clicks will click through to the window underneath, so any controls within the transparent window will not return clickable points.

  • 요소 컨테이너 (예: 목록 또는 트리 뷰) 인 경우 해당 지점이 있어야 할 때 클릭는 집중 컨트롤의 배경을 발생 합니다.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. 컨테이너 컨트롤의 모든 부분을 자식 요소에 의해 이미 사용 되 면 경우 클릭할 수는 없습니다.If every part of the container control is occupied by a child element, it is not clickable.

UI 자동화 공급자가으로 클릭할 수 있는 컨트롤 정의 되는 요소를 클릭할 때 아무것도 수행 하지 않을 수도가 있습니다.There is no guarantee that a control will do anything when clicked on a point defined as clickable by the UI Automation provider. 대신 컨트롤 패턴을 사용 하 여 컨트롤에서 작업을 수행 하는 것이 좋습니다.Consider using control patterns instead to perform actions on controls.

적용 대상

추가 정보