Condividi tramite


Metodo ITfRange::ShiftStart (msctf.h)

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

Vedi anche

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::ShiftEnd

ITfRange::ShiftStartRegion

ITfRange::ShiftStartToRange

TF_HALTCOND