Metodo ITfRange::ShiftStartToRange (msctf.h)

Articolo
02/29/2024

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