IUIAutomationElement3::get_CurrentIsPeripheral 메서드(uiautomationclient.h)

요소에 대한 현재 주변 UI 표시기를 검색합니다.

이 속성은 읽기 전용입니다.

구문

HRESULT get_CurrentIsPeripheral(
  BOOL *retVal
);

매개 변수

retVal

반환 값

없음

설명

IsPeripheral 속성이 TRUE인 경우 클라이언트 애플리케이션은 현재 키보드 대화형인 경우에도 요소가 포커스를 가져갔다고 가정할 수 없습니다.

이 속성은 다음 컨트롤 형식과 관련이 있습니다.

• UIA_GroupControlTypeId
• UIA_MenuControlTypeId
• UIA_PaneControlTypeId
• UIA_ToolBarControlTypeId
• UIA_ToolTipControlTypeId
• UIA_WindowControlTypeId
• UIA_CustomControlTypeId

주변 장치 UI가 관련 패턴 중 하나를 지원하는 경우 주변 장치 UI의 모양은 종종 이러한 이벤트 중 하나를 트리거합니다.

• WindowOpened (UIA_Window_WindowOpenedEventId)
• MenuOpened (UIA_MenuOpenedEventId)
• ToolTipOpened (UIA_ToolTipOpenedEventId)

보조 기술인 클라이언트 애플리케이션이 이러한 이벤트 중 하나를 처리하는 경우 클라이언트는 CurrentIsPeripheral 값을 검사 합니다. 값이 TRUE이면 클라이언트는 변경된 포커스를 새 UI의 표시기 또는 관심 있는 UI로 사용할 수 없으므로 사용자가 단일 작업으로 연결할 수 있는 주변 장치 UI의 대체 표현을 제공해야 할 수 있습니다. 그렇지 않으면 주변 장치 UI가 컨트롤 뷰, 탭 시퀀스 등에 존재하지 않습니다. 클라이언트는 한 번에 하나의 주변 장치 UI 항목만 전체 트리에 존재하며 다른 항목을 열면 첫 번째 항목이 자동으로 닫힙니다.

요구 사항

지원되는 최소 클라이언트	Windows 8.1 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	uiautomationclient.h(UIAutomation.h 포함)

추가 정보

IUIAutomationElement3

참조