Metodo ITfRange::ShiftStart (msctf.h)

Articolo
03/08/2023

Sposta l'ancoraggio iniziale dell'intervallo.

Sintassi

HRESULT ShiftStart(
  [in]  TfEditCookie      ec,
  [in]  LONG              cchReq,
  [out] LONG              *pcch,
  [in]  const TF_HALTCOND *pHalt
);

Parametri

[in] ec

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

[in] cchReq

Contiene il numero di caratteri che l'ancoraggio iniziale viene spostato. Un valore negativo fa sì che l'ancoraggio si sposti all'indietro e un valore positivo causi lo spostamento in avanti dell'ancoraggio.

[out] pcch

Puntatore a un valore LONG che riceve il numero di caratteri che l'ancoraggio è stato spostato.

[in] pHalt

Puntatore a una struttura TF_HALTCOND che contiene condizioni relative allo spostamento. Questo parametro è facoltativo e può essere NULL.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	Uno o più parametri non sono validi.
E_FAIL	Si è verificato un errore non specificato.
TF_E_NOLOCK	Il contesto di modifica identificato da ec non ha un blocco di sola lettura.

Commenti

Le posizioni iniziale e finale di un intervallo sono denominate ancoraggi.

Questo metodo non può spostare un ancoraggio oltre un limite di area. Se lo spostamento raggiunge un limite di area, il numero di caratteri effettivamente spostati sarà minore di quello richiesto. ITfRange::ShiftStartRegion viene usato per spostare l'ancoraggio in un'area adiacente.

Se l'operazione di spostamento determina lo spostamento dell'ancoraggio di inizio dell'intervallo oltre l'ancoraggio finale, l'ancoraggio finale viene spostato nella stessa posizione dell'ancoraggio iniziale.

ITfRange::ShiftStart può essere un'operazione lunga. Per prestazioni migliori, usare ITfRange::ShiftStartToRange quando possibile.

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