비고
이 설명서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI 자동화 클래스를 사용하려는 .NET Framework 개발자를 위한 것입니다. UI 자동화에 대한 최신 정보는 Windows Automation API: UI 자동화참조하세요.
Microsoft UI 자동화 이벤트 알림은 화면 읽기 프로그램 및 화면 돋보기와 같은 보조 기술의 주요 기능입니다. 이러한 UI 자동화 클라이언트는 UI에서 문제가 발생할 때 UI 자동화 공급자에 의해 발생하는 이벤트를 추적하고 정보를 사용하여 최종 사용자에게 알립니다.
클라이언트가 이벤트를 구독하는 경우에만 공급자 애플리케이션이 선택적으로 이벤트를 발생하도록 하여, 클라이언트가 이벤트를 수신 대기하지 않으면 아예 이벤트가 발생하지 않도록 함으로써 효율성이 향상됩니다.
이벤트 유형
UI 자동화 이벤트는 다음 범주로 분류됩니다.
| 이벤트 | 설명 |
|---|---|
| 속성 변경 | UI 자동화 요소 또는 컨트롤 패턴의 속성이 변경될 때 발생합니다. 예를 들어, 클라이언트가 애플리케이션의 확인란 컨트롤을 모니터링해야 한다면, ToggleState 속성의 변경 이벤트를 수신하도록 등록할 수 있습니다. 확인란 컨트롤을 선택하거나 선택 취소하면 공급자가 이벤트를 발생시키고 클라이언트가 필요에 따라 작동할 수 있습니다. |
| 요소 동작 | 사용자 또는 프로그래밍 활동으로 인해 UI가 변경될 때 발생합니다. 예를 들어 단추를 클릭하거나 InvokePattern를 통해 호출할 때입니다. |
| 구조 변경 | UI 자동화 트리의 구조가 변경될 때 발생합니다. 바탕 화면에 새 UI 항목이 표시되거나 숨겨지거나 제거되면 구조가 변경됩니다. |
| 전역 데스크톱 변경 | 클라이언트에 대한 전역 관심 작업이 발생할 때, 예를 들어 포커스가 한 요소에서 다른 요소로 이동하거나 창이 닫히는 경우에 발생합니다. |
일부 이벤트가 반드시 UI 상태가 변경되었음을 의미하지는 않습니다. 예를 들어 사용자가 텍스트 입력 필드를 탭한 다음 단추를 클릭하여 필드를 TextChangedEvent 업데이트하는 경우 사용자가 실제로 텍스트를 변경하지 않은 경우에도 발생합니다. 이벤트를 처리할 때 작업을 수행하기 전에 클라이언트 애플리케이션에서 실제로 변경된 내용이 있는지 확인해야 할 수 있습니다.
UI 상태가 변경되지 않은 경우에도 다음 이벤트가 발생할 수 있습니다.
AutomationPropertyChangedEvent(변경된 속성에 따라 다름)ElementSelectedEventInvalidatedEventTextChangedEvent
UI 자동화 이벤트 식별자
Microsoft UI 자동화 이벤트는 개체로 AutomationEvent 식별됩니다. 속성에는 Id 이벤트의 종류를 고유하게 식별하는 값이 포함되어 있습니다.
가능한 값 Id 은 이벤트 인수에 사용되는 형식과 함께 다음 표에 제공됩니다. 클라이언트와 공급자가 사용하는 식별자는 서로 다른 클래스에서 동일한 이름의 필드를 가지고 있습니다.
UI 자동화 이벤트 인수
다음 클래스는 이벤트 인수를 캡슐화합니다.
| 클래스 | 설명 |
|---|---|
| AsyncContentLoadedEventArgs | 완료된 로드 비율을 포함하여 콘텐츠의 비동기 로드에 대한 정보를 포함합니다. |
| AutomationEventArgs | 추가 데이터가 필요하지 않은 간단한 이벤트에 대한 정보를 포함합니다. |
| AutomationFocusChangedEventArgs | 한 요소에서 다른 요소로의 입력 포커스 변경에 대한 정보를 포함합니다. 이 형식의 이벤트는 공급자가 아닌 UI 자동화 시스템에 의해 발생합니다. |
| AutomationPropertyChangedEventArgs | 요소 또는 컨트롤 패턴의 속성 값 변경에 대한 정보를 포함합니다. |
| StructureChangedEventArgs | UI 자동화 트리의 변경 내용에 대한 정보를 포함합니다. |
| WindowClosedEventArgs | 창 닫는 방법에 대한 정보를 포함합니다. |
모든 이벤트 인수 클래스에는 멤버가 EventId 포함됩니다. 이 식별자는 AutomationEvent 안에 캡슐화됩니다.
이벤트를 식별하는 데 사용되는 개체는 AutomationEvent 공급자가 필드 AutomationElementIdentifiers 및 컨트롤 패턴 식별자 클래스(예: DockPatternIdentifiers.)에서 가져옵니다. 클라이언트 애플리케이션은 AutomationElement의 필드에서 및 DockPattern와 같은 컨트롤 패턴 클래스의 필드에서 해당 필드를 가져옵니다.
이벤트 식별자 목록은 클라이언트에 대한 UI 자동화 이벤트를 참조하세요.