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
S_OK	Die Methode war erfolgreich.
S_FALSE	pRange befindet sich nicht über oder neben der -Eigenschaft. ppRange empfängt NULL.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_OUTOFMEMORY	Ein Speicherbelegungsfehler ist aufgetreten.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
TF_E_NOLOCK	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

Weitere Informationen

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange

TfAnchor