ITfComposition::ShiftStart-Methode (msctf.h)

Artikel
02/29/2024

Verschiebt den Startanker einer Komposition.

Syntax

HRESULT ShiftStart(
  [in] TfEditCookie ecWrite,
  [in] ITfRange     *pNewStart
);

Parameter

[in] ecWrite

Enthält ein Bearbeitungscookie, das den von ITfEditSession::D oEditSession abgerufenen Bearbeitungskontext identifiziert.

[in] pNewStart

Zeiger auf ein ITfRange-Objekt , das die neue Startankerposition enthält. Der Startanker des Kontexts wird in den Startanker dieses Bereichs verschoben. Diese Methode schlägt fehl, wenn der Startanker dieses Bereichs außerhalb des Endankers der Komposition positioniert ist.

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	Der Startanker von pNewStart wird hinter dem Endanker der Komposition positioniert, oder pNewStart ist ungültig.
E_UNEXPECTED	Die Komposition wurde bereits beendet.
TF_E_NOLOCK	Der von ecWrite identifizierte Bearbeitungskontext verfügt nicht über eine Lese-/Schreibsperre.

Hinweise

Diese Methode bewirkt, dass die GUID_PROP_COMPOSING-Eigenschaft aus jedem Text entfernt wird, der aus der Komposition entfernt wurde. Ebenso wird die GUID_PROP_COMPOSING-Eigenschaft auch jedem Text hinzugefügt, der der Komposition hinzugefügt wird.

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

ITfComposition-Schnittstelle, ITfEditSession::D oEditSession, ITfRange-Schnittstelle, ITfComposition::ShiftEnd

Freigeben über