Condividi tramite


Metodo ITfRange::ShiftStartToRange (msctf.h)

Sposta l'ancoraggio iniziale di questo intervallo a un ancoraggio all'interno di un altro intervallo.

Sintassi

HRESULT ShiftStartToRange(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange,
  [in] TfAnchor     aPos
);

Parametri

[in] ec

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

[in] pRange

Puntatore a un'interfaccia ITfRange che contiene l'ancoraggio a cui viene spostato l'ancoraggio iniziale.

[in] aPos

Contiene uno dei valori TfAnchor che specifica l'ancoraggio di pRange in cui viene spostato l'ancoraggio iniziale.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
Il metodo è stato eseguito correttamente.
E_INVALIDARG
pRange non è valido.
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 iniziali e finali di un intervallo sono denominate ancoraggi.

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

Questo metodo è più efficiente di ITfRange::ShiftStart e deve essere usato quando possibile.

Requisiti

Requisito Valore
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::ShiftEndToRange

ITfRange::ShiftStart

TfAnchor