Metodo ITfRange::ShiftEnd (msctf.h)

Articolo
08/24/2023

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