UI 자동화 Value 컨트롤 패턴 구현
.gif "참고") 참고 |
|---|
이 문서는 System.Windows.Automation 네임스페이스에 정의된 관리되는 UI Automation 클래스를 사용하려는 .NET Framework 개발자를 위해 작성되었습니다.UI Automation에 대한 최신 정보는 Windows Automation API: UI Automation을 참조하십시오. |
이 항목에서는 이벤트 및 속성에 대한 정보를 포함하여 IValueProvider 구현에 대한 지침 및 규칙을 소개합니다. 추가 참조에 대한 링크는 항목 끝 부분에 나와 있습니다.
ValuePattern 컨트롤 패턴은 범위를 확장하지 않고 문자열로 표시할 수 있는 내장 값을 갖는 컨트롤을 지원하는 데 사용됩니다. 이 문자열을 편집할 수 있는지 여부는 해당 컨트롤 및 설정에 따라 다릅니다. 이 패턴을 구현하는 컨트롤 예제를 보려면 UI 자동화 클라이언트에 대한 컨트롤 패턴 매핑을 참조하십시오.
이 항목에는 다음 단원이 포함되어 있습니다.
- 구현 지침 및 규칙
- IValueProvider의 필수 멤버
- 예외
- 관련 항목
구현 지침 및 규칙
Value 컨트롤 패턴을 구현하는 경우 다음 지침 및 규칙을 따르십시오.
- 컨트롤의 현재 편집 모드와 상관없이 항목의 값을 편집할 수 있으려면 ListItem 및 TreeItem과 같은 컨트롤에서 ValuePattern을 지원해야 합니다. 하위 항목을 편집할 수 있으려면 부모 컨트롤에서도 ValuePattern을 지원해야 합니다.
편집할 수 있는 목록 항목 예제
.png "편집할 수 있는 목록 항목")
한 줄 편집 컨트롤에서는 IValueProvider를 구현하여 해당 콘텐츠에 대한 프로그래밍 방식 액세스를 지원합니다. 그러나 여러 줄 편집 컨트롤에서는 IValueProvider를 구현하지 않고 ITextProvider를 구현하여 해당 콘텐츠에 대한 액세스를 제공합니다.
여러 줄 편집 컨트롤의 텍스트 콘텐츠를 검색하려면 컨트롤에서 ITextProvider를 구현해야 합니다. 그러나 ITextProvider는 컨트롤 값 설정을 지원하지 않습니다.
IValueProvider는 형식 정보 또는 부분 문자열 값 검색을 지원하지 않습니다. 이런 경우에는 ITextProvider를 구현합니다.
색 값(예: "노랑") 및 해당 내부 RGB 구조 간 문자열 매핑을 지원하는 Microsoft Word의 색 선택 선택 컨트롤(아래 그림 참조) 같은 컨트롤에서는 IValueProvider를 구현해야 합니다.
색 견본 문자열 매핑의 예
.png "노란색이 강조 표시된 색 선택")
- SetValue에 대한 호출을 허용하기 전에 컨트롤의 IsEnabledProperty를 true로, IsReadOnlyProperty를 false로 설정해야 합니다.
IValueProvider의 필수 멤버
IValueProvider 구현에 필요한 속성 및 메서드는 다음과 같습니다.
필수 멤버 |
멤버 형식 |
참고 |
|---|---|---|
Property |
없음 |
|
Property |
없음 |
|
메서드 |
없음 |
예외
공급자는 다음 예외를 throw해야 합니다.
예외 형식 |
조건 |
|---|---|
|
|
|
|
|
참고 항목
작업
ValuePattern Insert Text Sample