TextChild 컨트롤 패턴

속성 및 메서드에 대한 정보를 포함하여 ITextChildProvider구현하기 위한 지침 및 규칙을 소개합니다. TextChild 컨트롤 패턴은 Text 컨트롤 패턴을 지원하는 요소의 가장 가까운 상위 항목에 액세스하는 데 사용됩니다.

예를 들어 다음 이미지와 같이 문서의 텍스트에 포함된 이미지와 하이퍼링크가 포함되어 있다고 가정합니다.

포함된 이미지와 하이퍼링크스크린샷

Microsoft UI 자동화 도구를 사용하여 이 문서 콘텐츠에 대한 UI 자동화 트리를 검사하는 경우 이미지를 나타내는 자식 요소 하나와 하이퍼링크를 나타내는 다른 자식 요소가 있는 문서 요소가 표시될 수 있습니다. 예를 들어:

샘플 UI 자동화 요소 트리스크린샷

일반적으로 이전 예제의 문서 요소는 Text 컨트롤 패턴을 지원하지만 문서 요소의 두 자식은 지원하지 않습니다. UI 자동화 클라이언트 애플리케이션에 이미지 요소 또는 하이퍼링크 요소에 대한 참조가 있는 경우 클라이언트는 TextChild 컨트롤 패턴을 사용하여 포함된 문서 요소에 의해 노출되는 Textcontrol 패턴에 편리하게 액세스할 수 있습니다.

구현 지침 및 규칙

ITextChildProvider 인터페이스를 구현하는 경우 다음 지침 및 규칙에 유의하세요.

• ITextChildProvider::TextContainer 속성은 상위 체인의 상위 요소가 ITextProvider지원하는지 여부에 관계없이 ITextProvider 인터페이스를 지원하는 가장 가까운 상위 요소를 지정해야 합니다.
• 요소는ITextProviderITextChildProvider** 인터페이스를 모두 지원해서는 안 됩니다.
• ITextChildProvider 구현하는 요소는 ITextProvider구현하는 요소의 자식 또는 하위 요소여야 합니다. 이 요소는 텍스트 컨트롤 패턴구현할 필요는 없습니다.
• ITextChildProvider::TextRange 속성은 ITextProvider::RangeFromChild 함수가 텍스트 자식 요소를 묶은 자식 요소로 호출할 때 포함하는 텍스트 공급자 요소가 반환하는 것과 동일한 텍스트 범위를 지정해야 합니다.

ITextChildProvider 필수 멤버

이러한 속성과 메서드는 ITextChildProvider 인터페이스를 구현하는 데 필요합니다.

이 컨트롤 패턴에는 연결된 메서드나 이벤트가 없습니다.

관련 항목

개념

• 컨트롤 형식 및 지원되는 컨트롤 패턴
• UI 자동화 컨트롤 패턴 개요
• UI 자동화 트리 개요