Metodo ITfInsertAtSelection::InsertEmbeddedAtSelection (msctf.h)

Articolo
03/08/2023

Il metodo ITfInsertAtSelection::InsertEmbeddedAtSelection inserisce un oggetto IDataObject nel punto di selezione o inserimento.

Sintassi

HRESULT InsertEmbeddedAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  IDataObject  *pDataObject,
  [out] ITfRange     **ppRange
);

Parametri

[in] ec

Identifica il contesto di modifica. Si ottiene da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] dwFlags

Campo di bit con uno dei valori seguenti:

TF_IAS_NOQUERY

Il parametro ppRange è NULL all'uscita.

TF_IAS_QUERYONLY

Il contesto non viene modificato, ma il parametro ppRange viene impostato come se si fosse verificato l'inserimento. L'accesso in sola lettura è sufficiente. Se questo flag non è impostato, il parametro ec deve avere accesso in lettura/scrittura.

TF_IAS_NO_DEFAULT_COMPOSITION

Il gestore TSF non crea una composizione predefinita se è necessaria una composizione. Il chiamante deve creare un oggetto composizione che copre il testo inserito prima di rilasciare il blocco del contesto.

[in] pDataObject

Puntatore all'oggetto da inserire.

[out] ppRange

Posizione dell'oggetto inserito. Facoltativa.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
TF_E_NOLOCK	Il parametro ec è un cookie di modifica non valido.
TF_E_DISCONNECTED	L'oggetto contesto non si trova in uno stack di documenti.
TS_E_NOSELECTION	Il contesto non ha alcuna selezione.
TS_E_READONLY	La selezione è di sola lettura.
TF_E_FORMAT	Il proprietario del contesto non può gestire gli oggetti del tipo fornito dal parametro pDataObject .

Commenti

I chiamanti possono utilizzare il metodo ITfQueryEmbedded::QueryInsertEmbedded per determinare se è probabile che un tipo di oggetto specifico venga accettato da questo metodo.

Per inserire testo anziché un oggetto IDataObject , utilizzare il metodo ITfInsertAtSelection::InsertTextAtSelection .

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional