ITfRange::GetText-Methode (msctf.h)

Artikel
08/24/2023

Die ITfRange::GetText-Methode ruft den Inhalt ab, der von diesem Textbereich abgedeckt wird.

Syntax

HRESULT GetText(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [out] WCHAR        *pchText,
  [in]  ULONG        cchMax,
  [out] ULONG        *pcch
);

Parameter

[in] ec

Bearbeiten Sie ein Cookie, das den bearbeitungskontext identifiziert, der von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen wurde.

[in] dwFlags

Bitfelder, die optionales Verhalten angeben.

Wert	Bedeutung
TF_TF_MOVESTART	Der Startanker des Bereichs wird bis zur Position nach dem letzten zurückgegebenen Zeichen erweitert.
TF_TF_IGNOREEND	Die Methode versucht, pchText mit der maximalen Anzahl von Zeichen zu füllen, anstatt die Kopie an der Position anzuhalten, die vom Endanker des Bereichs belegt ist.

[out] pchText

Zeiger auf einen Puffer, um den Text im Bereich zu empfangen.

[in] cchMax

Maximale Größe des Textpuffers.

[out] pcch

Zeiger auf eine ULONG,die die Anzahl von Zeichen darstellt, die in den pchText-Textpuffer geschrieben werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
TF_E_NOLOCK	Der Wert des ec-Parameters ist ein ungültiges Cookie, oder der Aufrufer verfügt nicht über eine schreibgeschützte Sperre.

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

ITfRange

TF_TF_*-Konstanten

Textspeicher