ITfProperty::FindRange 메서드(msctf.h)
속성에 대해 비어 있지 않은 값이 포함된 텍스트를 포함하는 범위를 가져옵니다.
구문
HRESULT FindRange(
[in] TfEditCookie ec,
[in] ITfRange *pRange,
[out] ITfRange **ppRange,
[in] TfAnchor aPos
);
매개 변수
[in] ec
편집 컨텍스트를 식별하는 편집 쿠키를 포함합니다. ITfDocumentMgr::CreateContext 또는 ITfEditSession::D oEditSession에서 가져옵니다.
[in] pRange
속성 범위를 가져올 점을 포함하는 ITfRange 인터페이스에 대한 포인터입니다. 점이 aPos 값에 따라 이 범위의 시작 앵커 또는 끝 앵커가 됩니다.
[out] ppRange
요청된 범위 개체를 수신하는 ITfRange 인터페이스 포인터에 대한 포인터입니다.
[in] aPos
속성 범위를 가져오는 지점으로 사용되는 pRange의 앵커를 지정하는 TfAnchor 값 중 하나를 포함합니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | Description |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
pRange 는 속성이 끝나지 않았거나 인접하지 않습니다. ppRange 는 NULL을 받습니다. |
|
하나 이상의 매개 변수가 잘못되었습니다. |
|
메모리 할당 오류가 발생했습니다. |
|
지정되지 않은 오류가 발생했습니다. |
|
ec로 식별되는 편집 컨텍스트에는 읽기 전용 또는 읽기/쓰기 잠금이 없습니다. |
설명
이 메서드는 속성에 대해 비어 있지 않은 값이 포함된 텍스트 범위를 가져옵니다. 속성에 지정된 지점에 값이 없으면 ppRange 는 NULL 을 수신하고 메서드는 S_FALSE 반환합니다. 다음 예제에서 aPos 에 TF_ANCHOR_START 포함된 경우 반환된 범위에는 "is"가 포함됩니다. aPos에 TF_ANCHOR_END 포함된 경우 속성이 범위의 끝점에 없기 때문에 메서드는 S_FALSE 반환합니다.
COLOR: RRRRR RR GGGGGGGG
TEXT: this <a>is som</a>e colored text
aPos에 TF_ANCHOR_START 포함된 경우 이 메서드는 시작 앵커 바로 전에 끝나는 속성 범위를 무시합니다. 마찬가지로 aPos 에 TF_ANCHOR_END 포함된 경우 이 메서드는 끝 앵커 바로 다음에 시작되는 속성 범위를 무시합니다. 다음 예제에서 aPos 에 TF_ANCHOR_START 포함된 경우 R 값 속성이 시작 앵커 지점에서 끝나고 G 값 속성이 시작 앵커에서 시작되므로 반환된 범위에는 "일부"가 아닌 "색이 지정된"이 포함됩니다. aPos에 TF_ANCHOR_END 포함된 경우 반환된 범위에는 "text"가 아닌 "색이 지정된"이 포함됩니다.
COLOR: RRRRR GGGGGGGG BBBB
TEXT: this is some <a>colored </a>text
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | msctf.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |