ITfReadOnlyProperty::EnumRanges 메서드(msctf.h)
지정된 범위 내에서 속성의 고유 값을 포함하는 범위의 열거형을 가져옵니다.
구문
HRESULT EnumRanges(
[in] TfEditCookie ec,
[out] IEnumTfRanges **ppEnum,
[in] ITfRange *pTargetRange
);
매개 변수
[in] ec
편집 컨텍스트를 식별하는 편집 쿠키를 포함합니다. ITfDocumentMgr::CreateContext 또는 ITfEditSession::D oEditSession에서 가져옵니다.
[out] ppEnum
열거자 개체를 수신하는 IEnumTfRanges 인터페이스 포인터에 대한 포인터입니다. 호출자는 더 이상 필요하지 않은 경우 이 개체를 해제해야 합니다.
[in] pTargetRange
고유한 속성 값을 검색할 범위를 지정하는 ITfRange 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 자세한 내용은 주의 섹션을 참조하세요.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
메모리 할당 오류가 발생했습니다. |
|
지정되지 않은 오류가 발생했습니다.
참고 애플리케이션이 ITextStoreACP::FindNextAttrTransition을 구현하지 않으면 ITfReadOnlyProperty::EnumRanges가 E_FAIL 함께 실패합니다.
|
|
ec로 식별되는 편집 컨텍스트에는 읽기 전용 또는 읽기/쓰기 잠금이 없습니다. |
설명
참고: 애플리케이션이 ITextStoreACP::FindNextAttrTransition을 구현하지 않으면 ITfReadOnlyProperty::EnumRanges 가 E_FAIL 함께 실패합니다.
이 메서드에서 가져온 열거자에는 지정된 속성의 빈 값을 포함하여 각 고유 값에 대한 범위가 포함됩니다. 예를 들어 다음과 같은 표시된 텍스트에 가상의 색 속성을 적용할 수 있습니다.
COLOR: RR GGGGGGGG
TEXT: this is some colored text
이 범위로 설정된 pTargetRange를 사용하여 ITfReadOnlyProperty::EnumRanges를 호출하면 열거자에는 5개의 범위가 포함됩니다.
| 범위 인덱스 | Color 속성 값 | 범위 텍스트 |
|---|---|---|
| 0 | <empty> | "this " |
| 1 | R | "입니다" |
| 2 | <empty> | " some " |
| 3 | G | "색이 지정된 " |
| 4 | <empty> | "text" |
pTargetRange가 NULL이면 열거자가 시작되고 컨텍스트에서 비어 있지 않은 속성 값이 포함된 첫 번째 및 마지막 범위로 끝납니다. 위의 예제에서 pTargetRange에 대해 NULL을 지정하면 세 개의 범위가 있는 열거자가 생성됩니다.
| 범위 인덱스 | Color 속성 값 | 범위 내의 텍스트 |
|---|---|---|
| 0 | R | "입니다" |
| 1 | <empty> | " some " |
| 2 | G | "색이 지정된 " |
열거형 범위는 속성 중간에 앵커가 배치되더라도 pTargetRange의 시작 및 끝 앵커로 시작 및 종료됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | msctf.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |