Condividi tramite


Metodo ITextStoreAnchor::InsertEmbeddedAtSelection (textstor.h)

Il metodo ITextStoreAnchor::InsertEmbeddedAtSelection inserisce un oggetto IDataObject nel punto di inserimento o nella selezione. Il client che chiama questo metodo deve avere un blocco di lettura/scrittura prima di inserire un IDataObject nel flusso di testo.

Sintassi

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parametri

[in] dwFlags

Specifica se i parametri paStart e paEnd conterranno i risultati dell'inserimento dell'oggetto.

Impossibile combinare i flag TF_IAS_NOQUERY e TF_IAS_QUERYONLY .

Valore Significato
TF_IAS_NOQUERY
Il testo viene inserito e i valori dei parametri ppaStart e ppaEnd possono essere NULL. Usare questo flag se i risultati dell'inserimento di testo non sono necessari.
TF_IAS_QUERYONLY
Il testo non viene inserito e gli ancoraggi ppaStart e ppaEnd contengono i risultati dell'inserimento di testo. I valori di questi parametri dipendono dal modo in cui l'applicazione implementa l'inserimento di testo in un documento.

Usare questo flag per visualizzare i risultati dell'inserimento di testo senza inserire effettivamente il testo, ad esempio per stimare i risultati del confronto o modificare in caso contrario una selezione.

[in] pDataObject

Puntatore all'oggetto IDataObject da inserire.

[out] ppaStart

Puntatore all'oggetto ancoraggio all'inizio dell'inserimento dell'oggetto.

[out] ppaEnd

Puntatore all'oggetto ancoraggio alla fine dell'inserimento dell'oggetto. Per un punto di inserimento, questo valore di parametro sarà uguale al valore del parametro ppaStart .

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
Il metodo è stato eseguito correttamente.
E_FAIL
Il metodo non è riuscito a creare un'istanza di uno degli ancoraggi paStart o paEnd.
E_INVALIDARG
Il parametro pchText non è valido.
E_OUTOFMEMORY
Il metodo non è riuscito a creare un'istanza di uno degli ancoraggi paStart o paEnd.
TS_E_NOLOCK
Il chiamante non ha un blocco nel documento.

Commenti

I client devono usare questo metodo per inserire un oggetto in un flusso di testo, poiché non è possibile passare una costante TS_CHAR_EMBEDDED in ITextStoreAnchor::SetText.

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 textstor.h
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

Idataobject

ITextStoreAnchor

ITextStoreAnchor::QueryInsertEmbeddeded

ITextStoreAnchor::SetText

costanti TF_IAS_*

TS_CHAR_EMBEDDED