ITfProperty::FindRange-Methode (msctf.h)
Ruft einen Bereich ab, der den Text abdeckt, der einen nicht leeren Wert für die Eigenschaft enthält.
Syntax
HRESULT FindRange(
[in] TfEditCookie ec,
[in] ITfRange *pRange,
[out] ITfRange **ppRange,
[in] TfAnchor aPos
);
Parameter
[in] ec
Enthält ein Bearbeitungscookies, das den Bearbeitungskontext identifiziert. Dies wird von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen.
[in] pRange
Zeiger auf eine ITfRange-Schnittstelle , die den Punkt enthält, für den der Eigenschaftsbereich abgerufen werden soll. Der Punkt ist entweder der Start- oder Endanker dieses Bereichs, basierend auf dem Wert von aPos.
[out] ppRange
Zeiger auf einen ITfRange-Schnittstellenzeiger , der das angeforderte Bereichsobjekt empfängt.
[in] aPos
Enthält einen der TfAnchor-Werte , der angibt, welcher Anker von pRange als Punkt verwendet wird, für den der Eigenschaftsbereich abgerufen werden soll.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
|
pRange befindet sich nicht über oder neben der -Eigenschaft. ppRange empfängt NULL. |
|
Mindestens ein Parameter ist ungültig. |
|
Ein Speicherbelegungsfehler ist aufgetreten. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Der von ec identifizierte Bearbeitungskontext verfügt nicht über eine Schreib- oder Lese-/Schreibsperre. |
Hinweise
Diese Methode ruft einen Textbereich ab, der einen nicht leeren Wert für die Eigenschaft enthält. Wenn die Eigenschaft am angegebenen Punkt keinen Wert aufweist, empfängt ppRangeNULL , und die Methode gibt S_FALSE zurück. Wenn aPos im folgenden Beispiel TF_ANCHOR_START enthält, enthält der zurückgegebene Bereich "is". Wenn aPos TF_ANCHOR_END enthält, gibt die Methode S_FALSE zurück, da die -Eigenschaft nicht am Endpunkt des Bereichs vorhanden ist.
COLOR: RRRRR RR GGGGGGGG
TEXT: this <a>is som</a>e colored text
Wenn aPos TF_ANCHOR_START enthält, ignoriert diese Methode Eigenschaftsbereiche, die unmittelbar vor dem Startanker enden. Ebenso ignoriert diese Methode, wenn aPos TF_ANCHOR_END enthält, Eigenschaftsbereiche, die unmittelbar nach dem Endanker beginnen. Wenn aPos im folgenden Beispiel TF_ANCHOR_START enthält, enthält der zurückgegebene Bereich "colored " und nicht "some", da die Eigenschaft R-Wert am Startankerpunkt endet und die G-Werteigenschaft am Startanker beginnt. Wenn aPos TF_ANCHOR_END enthält, enthält der zurückgegebene Bereich "colored" und nicht "text".
COLOR: RRRRR GGGGGGGG BBBB
TEXT: this is some <a>colored </a>text
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | msctf.h |
| DLL | Msctf.dll |
| Verteilbare Komponente | TSF 1.0 unter Windows 2000 Professional |