Condividi tramite


Metodo ITfRange::GetEmbedded (msctf.h)

Il metodo ITfRange::GetEmbedded ottiene il contenuto che corrisponde a un carattere TS_CHAR_EMBEDDED nel flusso di testo. L'ancoraggio iniziale dell'intervallo di testo viene posizionato immediatamente prima del carattere di interesse.

Sintassi

HRESULT GetEmbedded(
  [in]  TfEditCookie ec,
  [in]  REFGUID      rguidService,
  [in]  REFIID       riid,
  [out] IUnknown     **ppunk
);

Parametri

[in] ec

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

[in] rguidService

Identificatore che specifica come viene ottenuto il contenuto incorporato.

Valore Significato
GUID_TS_SERVICE_ACCESSIBLE
L'output deve essere un oggetto Accessible.
GUID_TS_SERVICE_ACTIVEX
Il chiamante richiede un puntatore diretto all'oggetto che supporta l'interfaccia specificata da riid.
GUID_TS_SERVICE_DATAOBJECT
Il contenuto deve essere ottenuto come oggetto trasferimento dati IDataObject , con riid IID_IDataObject. I client devono specificare questa opzione quando è necessaria una copia del contenuto.
Definito dal chiamante
I servizi di testo e i proprietari del contesto possono definire GUID personalizzati.

[in] riid

UUID dell'interfaccia dell'oggetto richiesto.

[out] ppunk

Puntatore all'oggetto . Può essere eseguito il cast per trovare la corrispondenza con riid.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
Il metodo è stato eseguito correttamente.
E_INVALIDARG
Uno o più parametri non sono validi.
E_NOTIMPL
L'applicazione che implementa non espone oggetti incorporati nel flusso di testo.
TF_E_NOINTERFACE
L'oggetto non supporta l'interfaccia richiesta.
TF_E_NOLOCK
Il valore nel parametro ec è un cookie non valido oppure il chiamante non dispone di un blocco di sola lettura.
TF_E_NOOBJECT
L'ancoraggio iniziale dell'intervallo non viene posizionato prima di un carattere TF_CHAR_EMBEDDED.
TF_E_NOSERVICE
Il contenuto non può essere restituito in modo che corrisponda a rguidService.

Commenti

Anche se l'oggetto ottenuto potrebbe non supportare determinate interfacce, è probabile che l'oggetto supporti tali interfacce associate a documenti o controlli incorporati, ad esempio IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache o IDispatch. Il chiamante deve usare QueryInterface per eseguire il probe di qualsiasi interfaccia interessante. Se il metodo ha esito positivo ma riid è NULL, l'applicazione indica la presenza di un oggetto incorporato ma non espone l'oggetto stesso. I processori di testo possono comunque trarre vantaggio da una notifica relativa al potenziale word break.

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

Oggetti accessibili

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::InsertEmbedded

Costanti del framework varie

Archivi di testo