Metodo ITfRange::InsertEmbedded (msctf.h)

Articolo
03/08/2023

Il metodo ITfRange::InsertEmbedded inserisce un oggetto nella posizione dell'ancoraggio iniziale dell'intervallo di testo.

Sintassi

HRESULT InsertEmbedded(
  [in] TfEditCookie ec,
  [in] DWORD        dwFlags,
  [in] IDataObject  *pDataObject
);

Parametri

[in] ec

Modificare il cookie ottenuto da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] dwFlags

Campi di bit che specificano la modalità di inserimento. Se TF_IE_CORRECTION è impostato, l'operazione è una correzione, in modo che altri servizi di testo possano conservare i dati associati al testo originale.

[in] pDataObject

Puntatore all'oggetto trasferimento dati da inserire.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_NOTIMPL	L'applicazione di implementazione non espone oggetti incorporati nel flusso.
TF_E_COMPOSITION_REJECTED	Il proprietario del contesto ha rifiutato una composizione predefinita.
TF_E_FORMAT	Il proprietario del contesto non può gestire il tipo di oggetto specificato.
TF_E_NOLOCK	Il valore del parametro ec è un cookie non valido oppure il chiamante non dispone di un blocco di sola lettura.
TF_E_RANGE_NOT_COVERED	Il chiamante ha già una composizione attiva, ma l'intervallo è posizionato sul testo non coperto dalla composizione.
TF_E_READONLY	Impossibile modificare il documento o il percorso dell'intervallo.

Commenti

Utilizzare questo metodo per inserire oggetti nel flusso di testo, perché il carattere segnaposto dell'oggetto TF_CHAR_EMBEDDED non può essere passato a ITfRange::SetText. Questo metodo viene modellato dopo l'API degli Appunti OLE, con le applicazioni che usano pDataObject come un IDataObject restituito da OleGetClipboard.

Quando un intervallo copre più aree, il metodo deve essere chiamato separatamente in ogni area. In caso contrario, il metodo potrebbe non riuscire.

Per impostazione predefinita, i servizi di testo iniziano e terminano una composizione temporanea che copre l'intervallo, per garantire che i proprietari del contesto riconoscano in modo coerente le composizioni sul testo modificato. Se il proprietario della composizione rifiuta una composizione predefinita, il metodo restituisce TF_E_COMPOSITION_REJECTED. Le composizioni predefinite vengono create solo se il chiamante non ne ha già avviato uno. Se il chiamante ha una composizione attiva, la chiamata ha esito negativo.

Per determinare in anticipo se un proprietario del contesto supporta l'inserimento di un particolare oggetto, usare ITfQueryEmbedded::QueryInsertEmbedded.

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