ITfRange::ShiftEndRegion-Methode (msctf.h)

Artikel
08/24/2023

Verschiebt den Endanker in einen angrenzenden Bereich.

Syntax

HRESULT ShiftEndRegion(
  [in]  TfEditCookie ec,
  [in]  TfShiftDir   dir,
  [out] BOOL         *pfNoRegion
);

Parameter

[in] ec

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

[in] dir

Enthält einen der TfShiftDir-Werte , der angibt, in welchen angrenzenden Bereich der Endanker verschoben wird.

[out] pfNoRegion

Zeiger auf einen BOOL-Wert , der ein Flag empfängt, das angibt, ob der Anker neben einem anderen Bereich positioniert ist. Empfängt einen Wert ungleich Null, wenn der Anker nicht an einen anderen Bereich angrenzt oder andernfalls null.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	pfNoRegion 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.

Der Anker muss neben dem gewünschten Bereich positioniert werden, bevor diese Methode aufgerufen wird. Andernfalls erhält pfNoRegion einen Wert ungleich null, und der Anker wird nicht verschoben. Wenn sich der Anker neben der gewünschten Region befindet, empfängt pfNoRegion null, und der Anker wird in die Region verschoben.

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