(msctf.h) ITfProperty：：FindRange 方法
取得範圍，涵蓋包含屬性非空白值的文字。
語法
HRESULT FindRange(
[in] TfEditCookie ec,
[in] ITfRange *pRange,
[out] ITfRange **ppRange,
[in] TfAnchor aPos
);
參數
[in] ec
包含可識別編輯內容的編輯 Cookie。 這是從 ITfDocumentMgr：：CreateCoNtext 或 ITfEditSession：:D oEditSession取得。
[in] pRange
ITfRange介面的指標，其中包含要取得屬性範圍的點。 此點會根據 aPos的值，成為此範圍的起點錨點或結束錨點。
[out] ppRange
接收要求之範圍物件的 ITfRange 介面指標指標的指標。
[in] aPos
包含其中一個 TfAnchor 值，指定 pRange 的錨點做為取得屬性範圍的點。
傳回值
這個方法可以傳回下列其中一個值。
| 值 | 描述 |
|---|---|
|
此方法成功。 |
|
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，則傳回的範圍會包含「colored」 而不是 「some」，因為 R 值屬性會在起點錨點結束，而 G 值屬性會從開始錨點開始。 如果 aPos 包含TF_ANCHOR_END，傳回的範圍會包含「colored」 而非 「text」。
COLOR: RRRRR GGGGGGGG BBBB
TEXT: this is some <a>colored </a>text
需求
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | msctf.h |
| Dll | Msctf.dll |
| 可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |