ITfRange::ShiftStartToRange-Methode (msctf.h)

Artikel
03/04/2024

Verschiebt den Startanker dieses Bereichs in einen Anker innerhalb eines anderen Bereichs.

Syntax

HRESULT ShiftStartToRange(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange,
  [in] TfAnchor     aPos
);

Parameter

[in] ec

Enthält ein Bearbeitungscookie, das den Bearbeitungskontext identifiziert, der von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen wurde.

[in] pRange

Zeiger auf eine ITfRange-Schnittstelle , die den Anker enthält, in den der Startanker verschoben wird.

[in] aPos

Enthält einen der TfAnchor-Werte , der angibt, in welchen Anker von pRange der Startanker verschoben wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	pRange 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 Endposition eines Bereichs werden als Anker bezeichnet.

Wenn der Verschiebungsvorgang bewirkt, dass der Bereichsstartanker am Endanker vorbei bewegt wird, wird der Endanker an dieselbe Position wie der Startanker verschoben.

Diese Methode ist effizienter als ITfRange::ShiftStart und sollte nach Möglichkeit verwendet werden.

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