Metodo ITfRange::GetEmbedded (msctf.h)

Articolo
08/24/2023

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