ITextStoreACP::GetTextExt-Methode (textstor.h)

Artikel
08/26/2023

Die ITextStoreACP::GetTextExt-Methode gibt das begrenzungsfeld 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]  TsViewCookie vcView,
  [in]  LONG         acpStart,
  [in]  LONG         acpEnd,
  [out] RECT         *prc,
  [out] BOOL         *pfClipped
);

Parameter

[in] vcView

Gibt die Kontextansicht an.

[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 einen 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 den Anfang oder das Ende 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	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

Itextstoreacp

ITfContextOwner::GetTextExt

ITfContextView::GetTextExt

Freigeben über