ITfRange::ShiftEnd-Methode (msctf.h)

Artikel
08/24/2023

Verschiebt den Endanker des Bereichs.

Syntax

HRESULT ShiftEnd(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

Parameter

[in] ec

Enthält ein Bearbeitungscooky, das den Bearbeitungskontext identifiziert. Dies wird von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen.

[in] cchReq

Enthält die Anzahl der Zeichen, die der Endanker verschoben wird. Ein negativer Wert bewirkt, dass sich der Anker rückwärts bewegt, und ein positiver Wert bewirkt, dass sich der Anker vorwärts bewegt.

[out] pcch

Zeiger auf einen LONG-Wert , der die Anzahl der Zeichen empfängt, die der Anker verschoben hat.

[in] pHalt

Zeiger auf eine TF_HALTCOND-Struktur , die Bedingungen für die Verschiebung enthält. Dieser Parameter ist optional und kann NULL sein.

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 von ec identifizierte Bearbeitungskontext verfügt nicht über eine schreibgeschützte Sperre.

Hinweise

Die Start- und Endpositionen eines Bereichs werden als Anker bezeichnet.

Diese Methode kann einen Anker nicht über eine Regionsgrenze hinaus verschieben. Wenn die Verschiebung eine Regionsgrenze erreicht, ist die Anzahl der tatsächlich verschobenen Zeichen kleiner als die angeforderte. ITfRange::ShiftEndRegion wird verwendet, um den Anker in eine angrenzende Region zu verschieben.

Wenn der Schichtvorgang bewirkt, dass der Bereichsendanker über den Startanker hinaus bewegt wird, wird der Startanker an die gleiche Position wie der Endanker verschoben.

ITfRange::ShiftEnd kann ein langwieriger Vorgang sein. Um die Leistung zu verbessern, verwenden Sie nach Möglichkeit ITfRange::ShiftEndToRange .

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