UI 자동화 Invoke 컨트롤 패턴 구현

이 항목에서는 이벤트 및 속성에 대한 정보를 포함하여 IInvokeProvider를 구현하기 위한 지침 및 규칙을 제공합니다. 추가 참조에 대한 링크는 항목 끝에 나열되어 있습니다.

InvokePattern 컨트롤 패턴은 활성화되었을 때 상태를 유지하지 않고 명확한 단일 작업을 시작하거나 수행하는 컨트롤을 지원하는 데 사용됩니다. 확인란 및 라디오 단추와 같이 상태를 유지하는 컨트롤은 각각 IToggleProvider 및 ISelectionItemProvider 를 구현해야 합니다. Invoke 컨트롤 패턴을 구현하는 컨트롤의 예제를 보려면 Control Pattern Mapping for UI Automation Clients을 참조하세요.

구현 지침 및 규칙

Invoke 컨트롤 패턴을 구현할 때는 다음 지침 및 규칙에 유의하세요.

• 동일한 동작이 다른 컨트롤 패턴 공급자를 통해 노출되지 않으면 컨트롤이 IInvokeProvider를 구현합니다. 예를 들어, 컨트롤의 Invoke 메서드가 Expand 또는 Collapse 메서드와 동일한 작업을 수행하는 경우 이 컨트롤은 IInvokeProvider를 구현하지 않아야 합니다.

• 일반적으로 컨트롤은 미리 정의된 키보드 바로 가기 또는 몇 가지 키 입력의 조합을 클릭하거나, 두 번 클릭하거나, ENTER 키를 눌러 호출합니다.

• InvokedEvent 는 활성화된 컨트롤에서 발생합니다(연결된 작업을 수행하는 컨트롤에 대한 응답으로) 가능하면, 컨트롤이 작업을 완료하여 차단하지 않고 반환된 후에 이벤트가 발생해야 합니다. 다음 시나리오에서 호출 요청을 처리하기 전에 Invoked 이벤트가 발생해야 합니다.

  • 작업이 완료될 때까지 기다리는 것은 실제로 불가능합니다.

  • 작업에는 사용자 개입이 필요합니다.

  • 작업은 시간이 오래 걸리므로 상당한 시간 동안 호출 클라이언트가 차단됩니다.

• 컨트롤 호출로 인해 심각한 부작용이 발생하는 경우, 이러한 부작용은 HelpText 속성을 통해 노출되어야 합니다. 예를 들어, Invoke 가 선택 항목과 연결되지 않은 경우에도 Invoke 로 인해 다른 컨트롤이 선택될 수 있습니다.

• 마우스 포인터(또는 마우스를 위에 올려 놓기) 효과는 일반적으로 Invoked 이벤트로 간주되지 않습니다. 하지만 가리키기 상태를 기반으로 작업을 수행(시각적 효과를 발생시키는 것과 반대 개념)하는 컨트롤은 InvokePattern 컨트롤 패턴을 지원해야 합니다.

• 컨트롤을 호출하는 것은 항목을 선택하는 것과 다릅니다. 그러나 컨트롤에 따라, 컨트롤 호출로 인해 항목이 잘못된 방식으로 선택될 수 있습니다. 예를 들어, 내 문서 폴더에서 Microsoft Word 문서 목록 항목을 호출하면 항목이 선택되고 문서가 열리는 두 가지 작업이 수행됩니다.

• 호출하는 즉시 UI 자동화 트리에서 요소가 사라질 수 있습니다. 그 결과, 이벤트 콜백에서 제공하는 요소로부터 정보를 요청하는 작업에 실패할 수 있습니다. 이러한 문제의 해결 방법으로 캐시된 정보를 프리페치하는 것이 좋습니다.

• 컨트롤은 여러 개의 컨트롤 패턴을 구현할 수 있습니다. 예를 들어, Microsoft Excel 도구 모음의 채우기 색 컨트롤은 InvokePattern 및 ExpandCollapsePattern 컨트롤 패턴을 둘 다 구현합니다. ExpandCollapsePattern 은 메뉴를 노출하고 InvokePattern 은 선택된 색으로 활성 상태의 선택 항목을 채웁니다.

IInvokeProvider에 필요한 멤버

IInvokeProvider를 구현하려면 다음과 같은 속성 및 메서드가 필요합니다.

예외

공급자는 다음과 같은 예외를 throw해야 합니다.

참고 항목

• UI 자동화 컨트롤 패턴 개요
• UI 자동화 공급자의 컨트롤 패턴 지원
• 클라이언트용 UI 자동화 컨트롤 패턴
• UI 자동화를 사용하여 컨트롤 호출
• UI 자동화 트리 개요
• UI 자동화의 캐싱 사용