ITextStoreACP2::GetTextExt-Methode (textstor.h)

Artikel
03/06/2024

Ruft das begrenzungsfeld in Bildschirmkoordinaten des Texts an einer angegebenen Zeichenposition ab. 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 Begrenzungsfeld abgeschnitten wurde. Wenn dieser Parameter TRUE ist, enthält das Begrenzungsfeld abgeschnittenen 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.
TS_E_INVALIDARG	Die angegebene Start- 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 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll

Weitere Informationen

ITextStoreACP2

Freigeben über