ITfContextOwner::GetTextExt-Methode (msctf.h)

Artikel
02/29/2024

Die ITfContextOwner::GetTextExt-Methode gibt den begrenzungsrahmen in Bildschirmkoordinaten des Texts an einer angegebenen Zeichenposition zurück. Der Aufrufer muss über eine schreibgeschützte Sperre für das Dokument verfügen, bevor diese Methode aufgerufen wird.

Syntax

HRESULT GetTextExt(
  [in]  LONG acpStart,
  [in]  LONG acpEnd,
  [out] RECT *prc,
  [out] BOOL *pfClipped
);

Parameter

[in] acpStart

Gibt die Anfangszeichenposition des Texts an, der im Dokument abgerufen werden soll.

[in] acpEnd

Gibt die Endzeichenposition des Texts an, der im Dokument abgerufen werden soll.

[out] prc

Empfängt das begrenzungsfeld in Bildschirmkoordinaten des Texts an den angegebenen Zeichenpositionen.

[out] pfClipped

Empfängt den booleschen Wert, der angibt, ob der Text im Begrenzungsrahmen abgeschnitten wurde. Wenn dieser Parameter TRUE ist, enthält das Begrenzungsfeld beschnittenen Text und nicht den gesamten angeforderten Textbereich. Das Begrenzungsfeld wird abgeschnitten, da der angeforderte Bereich nicht sichtbar ist.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TS_E_INVALIDARG	Die angegebene Anfangs- und Endzeichenposition sind gleich.
TS_E_INVALIDPOS	Der durch die Parameter acpStart und acpEnd angegebene Bereich erstreckt sich über das Ende des Dokuments oder den Anfang des Dokuments hinaus.
TS_E_NOLAYOUT	Die Anwendung hat kein Textlayout berechnet.
TS_E_NOLOCK	Der Aufrufer verfügt nicht über eine schreibgeschützte Sperre für das Dokument.

Hinweise

Wenn das Dokumentfenster minimiert ist oder der angegebene Text derzeit nicht sichtbar ist, gibt die Methode S_OK zurück, wobei der prc-Parameter auf {0,0,0,0}festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msctf.h
DLL	Msimtf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITextStoreACP::GetTextExt

ITfContextOwner

ITfContextView::GetTextExt

Freigeben über