ITextStoreAnchor::GetSelection-Methode (textstor.h)

Artikel
03/02/2024

Die ITextStoreAnchor::GetSelection-Methode gibt den Offset einer Textauswahl in einem Textstream zurück. Diese Methode unterstützt mehrere Textauswahlen. Der Aufrufer muss über eine schreibgeschützte Sperre für das Dokument verfügen, bevor diese Methode aufgerufen wird.

Syntax

HRESULT GetSelection(
  [in]  ULONG               ulIndex,
  [in]  ULONG               ulCount,
  [out] TS_SELECTION_ANCHOR *pSelection,
  [out] ULONG               *pcFetched
);

Parameter

[in] ulIndex

Gibt die Textauswahl an, die den Prozess starten. Wenn die TF_DEFAULT_SELECTION Konstante für diesen Parameter angegeben wird, wird der Prozess durch die Eingabeauswahl gestartet, und es wird nur eine einzelne Auswahl (die für Eingabevorgänge geeignete) zurückgegeben.

[in] ulCount

Gibt die maximale Anzahl von Auswahlmöglichkeiten an, die zurückgegeben werden sollen.

[out] pSelection

Empfängt die Format-, Start- und Endzeichenpositionen des ausgewählten Texts. Diese Werte werden in die TS_SELECTION_ANCHOR-Struktur eingefügt.

[out] pcFetched

Empfängt die Anzahl der zurückgegebenen pSelection-Strukturen .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Die -Methode konnte den Start- oder Endanker nicht in die TS_SELECTION_ANCHOR-Struktur laden.
E_OUTOFMEMORY	Die -Methode konnte keinen Arbeitsspeicher für die Auswahl zuweisen.
TS_E_NOLOCK	Der Aufrufer verfügt nicht über eine schreibgeschützte Sperre für das Dokument.
TS_E_NOSELECTION	Das Dokument hat keine Auswahl.

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

Kontexte bearbeiten

ITextStoreAnchor

ITextStoreAnchor::SetSelection

Verschiedene Frameworkkonstanten

TF_DEFAULT_SELECTION

TS_SELECTION_ANCHOR

Freigeben über