ITfRange::ShiftStartRegion-Methode (msctf.h)

Artikel
08/24/2023

Verschiebt den Startanker in einen angrenzenden Bereich.

Syntax

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

Parameter

[in] ec

Enthält ein Bearbeitungscooky, das den Von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufenen Bearbeitungskontext identifiziert.

[in] dir

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

[out] pfNoRegion

Zeiger auf eine BOOL , die ein Flag empfängt, das angibt, ob der Anker neben einer anderen Region positioniert ist. Empfängt einen wert nonzero, wenn der Anker nicht an eine andere Region 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 der gewünschten Region positioniert werden, bevor diese Methode aufgerufen wird. Andernfalls erhält pfNoRegion einen Nonzero-Wert, und der Anker wird nicht verschoben. Wenn der Anker an die gewünschte Region angrenzt, erhält 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