Condividi tramite


Metodo ITfRange::ShiftEnd (msctf.h)

Sposta l'ancoraggio finale dell'intervallo.

Sintassi

HRESULT ShiftEnd(
  [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 spostati dall'ancoraggio finale. 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 spostati dall'ancoraggio.

[in] pHalt

Puntatore a una struttura TF_HALTCOND che contiene le condizioni sullo 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_FAIL
Si è verificato un errore non specificato.
E_INVALIDARG
Uno o più parametri non sono validi.
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::ShiftEndRegion viene usato per spostare l'ancoraggio in un'area adiacente.

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

ITfRange::ShiftEnd può essere un'operazione lunga. Per prestazioni migliori, usare ITfRange::ShiftEndToRange 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::ShiftEndRegion

ITfRange::ShiftStart

TF_HALTCOND