TextChild 컨트롤 패턴
속성 및 메서드에 대한 정보를 포함하여 ITextChildProvider를 구현하기 위한 지침 및 규칙을 소개합니다. TextChild 컨트롤 패턴은 텍스트 컨트롤 패턴을 지원하는 요소의 가장 가까운 상위 항목에 액세스하는 데 사용됩니다.
예를 들어 문서의 텍스트에 다음 이미지와 같이 포함된 이미지와 하이퍼링크가 포함되어 있다고 가정합니다.
Microsoft UI 자동화 도구를 사용하여 이 문서 콘텐츠의 UI 자동화 트리를 검사하는 경우 이미지를 나타내는 자식 요소 하나와 하이퍼링크를 나타내는 다른 자식 요소가 있는 문서 요소가 표시될 수 있습니다. 예:
일반적으로 이전 예제의 문서 요소는 Text 컨트롤 패턴을 지원하지만 문서 요소의 두 자식은 지원하지 않습니다. UI 자동화 클라이언트 애플리케이션에 이미지 요소 또는 하이퍼링크 요소에 대한 참조가 있는 경우 클라이언트는 포함된 문서 요소에 의해 노출되는 Textcontrol 패턴에 액세스하는 편리한 방법으로 TextChild 컨트롤 패턴을 사용할 수 있습니다.
구현 지침 및 규칙
ITextChildProvider 인터페이스를 구현할 때 다음 지침 및 규칙을 확인합니다.
- ITextChildProvider::TextContainer 속성은 상위 체인의 상위 요소도 ITextProvider를 지원하는지 여부에 관계없이 ITextProvider 인터페이스를 지원하는 가장 가까운 상위 요소를 지정해야 합니다.
- 요소는ITextProvider 및 ITextChildProvider** 인터페이스를 모두 지원해서는 안 됩니다.
- ITextChildProvider를 구현하는 요소는 ITextProvider를 구현하는 요소의 자식 또는 하위 항목이어야 합니다. 이 요소도 텍스트 컨트롤 패턴을 구현할 필요는 없습니다.
- ITextChildProvider::TextRange 속성은 ITextProvider::RangeFromChild 함수가 텍스트 자식 요소를 묶은 자식 요소로 호출할 때 포함된 텍스트 공급자 요소가 반환하는 것과 동일한 텍스트 범위를 지정해야 합니다.
ITextChildProvider에 필요한 멤버
이러한 속성과 메서드는 ITextChildProvider 인터페이스를 구현하는 데 필요합니다.
| 필요한 멤버 | 멤버 형식 | 참고 |
|---|---|---|
| TextContainer | 속성 | 없음 |
| Textrange | 속성 | 없음 |
이 컨트롤 패턴에는 연결된 메서드 또는 이벤트가 없습니다.
관련 항목
개념