ITfRange::ShiftStart-Methode (msctf.h)

Artikel
08/24/2023

Verschiebt den Startanker des Bereichs.

Syntax

HRESULT ShiftStart(
  [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 Startanker 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 wurde.

[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_INVALIDARG	Mindestens ein Parameter ist ungültig.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
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::ShiftStartRegion wird verwendet, um den Anker in eine angrenzende Region zu verschieben.

Wenn durch den Umschaltvorgang der Bereichsstartanker über den Endanker verschoben wird, wird der Endanker an die gleiche Position wie der Startanker verschoben.

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

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