ITfContext::SetSelection-Methode (msctf.h)

Artikel
02/29/2024

Legt die Auswahl im Dokument fest.

Syntax

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

Parameter

[in] ec

Enthält ein Bearbeitungscooky, das die Bearbeitungssitzung identifiziert. Dies ist der Wert, der an ITfEditSession::D oEditSession übergeben wird.

[in] ulCount

Gibt die Anzahl der Auswahlen im pSelection-Array an.

[in] pSelection

Ein Array von TF_SELECTION Strukturen, die die Informationen für jede Auswahl enthalten.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TF_E_NOSELECTION	Das Dokument hat keine Auswahl.
TF_E_NOLOCK	Das Cookie in ec ist ungültig.

Hinweise

Eine Auswahl ist eine Spanne hervorgehobener Text oder eine Einfügemarke, wenn die Spanne leer ist und den Benutzerfokusbereich innerhalb eines Dokuments identifiziert. Einige Dokumente können mehrfach ausgewählt werden. In pSelection kann nur eine Auswahl der Länge null vorhanden sein, da sie die Position des Dokument-Carets darstellt.

Wenn eine Anwendung den text anpassen muss, der durch eine Auswahl abgedeckt wird, sollte sie warten, bis der Aufrufer die Sperre aufgibt. Anwendungen können jedoch alle Stilmember der TF_SELECTION-Strukturen anpassen und gleichzeitig S_OK zurückgeben.

Der Aufrufer kann das fInterimChar-Flag nur festlegen, wenn eine Auswahl festgelegt ist. In diesem Fall sollte die Auswahl genau ein Zeichen umfassen, und das ase-Element der TF_SELECTION-Struktur ist auf TFAE_NONE festgelegt.

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	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfContext-Schnittstelle, ITfEditSession::D oEditSession, TF_SELECTION-Struktur, ITfContext::GetSelection

Freigeben über