값 컨트롤 패턴

속성 및 메서드에 대한 정보를 포함하여 IValueProvider를 구현하기 위한 지침 및 규칙을 설명합니다. 컨트롤 패턴은 범위에 걸쳐 있지 않고 문자열로 나타낼 수 있는 내장 값이 있는 컨트롤을 지원하는 데 사용됩니다.

값 문자열은 컨트롤 및 해당 설정에 따라 편집할 수 있습니다. 이 컨트롤 패턴을 구현하는 컨트롤의 예는 컨트롤 형식 및 지원되는 컨트롤 패턴을 참조하세요.

이 항목에는 다음과 같은 섹션이 포함되어 있습니다.

구현 지침 및 규칙

컨트롤 패턴을 구현할 때 다음 지침 및 규칙을 확인합니다.

  • 목록 항목 또는 트리 항목과 같은 컨트롤은 컨트롤의 현재 편집 모드에 관계없이 항목의 값을 편집할 수 있는 경우 컨트롤 패턴을 지원해야 합니다. 부모 컨트롤은 자식 항목을 편집할 수 있는 경우 컨트롤 패턴도 지원해야 합니다. 다음 이미지는 편집 가능한 목록 항목의 예를 보여줍니다.

    편집 가능한 목록 항목을 보여 주는 그림

  • 단일 및 다중 줄 편집 컨트롤은 읽기 전용 콘텐츠를 노출하기 위해 ITextProvider 를 구현해야 합니다.

  • 여러 줄 편집 컨트롤은 내용을 변경할 수 있는 경우 IValueProvider 를 구현해야 합니다.

  • IValueProvider 는 서식 지정 정보 또는 부분 문자열 값 검색을 지원하지 않습니다. 이러한 시나리오에서 ITextProvider 를 구현합니다.

  • IValueProvider는 색 값(예: "노란색")과 해당하는 내부 RGB 값 간의 문자열 매핑을 지원하는 Microsoft Word 색 선택 컨트롤(다음 이미지 참조)과 같은 컨트롤에 의해 구현되어야 합니다.

    색 견본 문자열 매핑을 보여 주는 그림

  • 컨트롤에는 ITextProvider::SetValue 호출을 허용하기 전에 해당 IsEnabled 속성이 TRUE로 설정되고 ITextProvider::IsReadOnly 속성이 FALSE로 설정되어야 합니다.

IValueProvider에 필요한 멤버

IValueProvider 인터페이스를 구현하려면 다음 속성과 메서드가 필요합니다.

필요한 멤버 멤버 형식 참고
Isreadonly 속성 없음
속성 없음
SetValue 방법 없음

 

이 컨트롤 패턴에 연결된 이벤트가 없습니다.

컨트롤 형식 및 해당 지원되는 컨트롤 패턴

UI 자동화 컨트롤 패턴 개요

UI 자동화 트리 개요

텍스트 및 TextRange 컨트롤 패턴