Metodo ITfRange::ShiftStartRegion (msctf.h)

Articolo
03/08/2023

Sposta l'ancoraggio iniziale in un'area adiacente.

Sintassi

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

Parametri

[in] ec

Contiene un cookie di modifica che identifica il contesto di modifica ottenuto da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] dir

Contiene uno dei valori TfShiftDir che specifica l'area adiacente in cui viene spostato l'ancoraggio iniziale.

[out] pfNoRegion

Puntatore a un valore BOOL che riceve un flag che indica se l'ancoraggio è posizionato adiacente a un'altra area. Riceve un valore diverso da zero se l'ancoraggio non è adiacente a un'altra area o zero in caso contrario.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	pfNoRegion non è valido.
TF_E_NOLOCK	Il contesto di modifica identificato da ec non ha un blocco di sola lettura.

Commenti

Le posizioni iniziali e finali di un intervallo sono denominate ancoraggi.

L'ancoraggio deve essere posizionato adiacente all'area desiderata prima di chiamare questo metodo. In caso contrario, pfNoRegion riceve un valore diverso da zero e l'ancoraggio non viene spostato. Se l'ancoraggio è adiacente all'area desiderata, pfNoRegion riceve zero e l'ancoraggio viene spostato nell'area.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional