ITextStoreAnchor::GetTextExt-Methode (textstor.h)

Artikel
03/09/2024

Die ITextStoreAnchor::GetTextExt-Methode gibt das umgebende Feld in Bildschirmkoordinaten eines Textbereichs 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]  TsViewCookie vcView,
  [in]  IAnchor      *paStart,
  [in]  IAnchor      *paEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Parameter

[in] vcView

Gibt die Kontextansicht an.

[in] paStart

Gibt den Anker an, der am Anfang des Bereichs positioniert ist.

[in] paEnd

Gibt den Anker an, der am Ende des Bereichs positioniert ist.

[out] prc

Empfängt das begrenzungsfeld des Textbereichs in Bildschirmkoordinaten.

[out] pfClipped

Empfängt einen booleschen Wert, der angibt, ob der Text im Begrenzungsfeld abgeschnitten wurde. Bei TRUE enthält das Begrenzungsfeld beschnittenen Text und nicht den gesamten angeforderten Textbereich. Das Begrenzungsfeld ist 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.
E_FAIL	Die Methode konnte keinen gültigen Schnittstellenzeiger auf die Start- und/oder Endanker abrufen.
TS_E_INVALIDARG	Mindestens ein Eingabeparameter ist ungültig.
TS_E_INVALIDPOS	Der durch die Parameter paStart und paEnd angegebene Bereich erstreckt sich über den Anfang oder das Ende des Dokuments hinaus.
TS_E_NOLAYOUT	Die Anwendung hat kein Textlayout berechnet. Alle weiteren Aufrufe sind erst erfolgreich, wenn die Anwendung ITextStoreAnchorSink::OnLayoutChange aufruft.
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 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITextStoreAnchor

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt

Freigeben über