ITfRange::GetEmbedded method (msctf.h)

Artikel
08/24/2023

Metode ITfRange::GetEmbedded mendapatkan konten yang sesuai dengan karakter TS_CHAR_EMBEDDED dalam aliran teks. Jangkar awal rentang teks diposisikan tepat sebelum karakter yang diminati.

Sintaks

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

Parameter

[in] ec

Edit cookie yang diperoleh dari ITfDocumentMgr::CreateContext atau ITfEditSession::D oEditSession.

[in] rguidService

Pengidentifikasi yang menentukan bagaimana konten yang disematkan diperoleh.

Nilai	Makna
GUID_TS_SERVICE_ACCESSIBLE	Output harus menjadi objek Yang dapat diakses.
GUID_TS_SERVICE_ACTIVEX	Penelepon memerlukan penunjuk langsung ke objek yang mendukung antarmuka yang ditentukan oleh riid.
GUID_TS_SERVICE_DATAOBJECT	Konten harus diperoleh sebagai objek transfer data IDataObject , dengan riid yang IID_IDataObject. Klien harus menentukan opsi ini saat salinan konten diperlukan.
Penelepon ditentukan	Layanan teks dan pemilik konteks dapat menentukan GUID kustom.

[in] riid

UUID antarmuka objek yang diminta.

[out] ppunk

Arahkan ke objek . Hal ini dapat dilemparkan untuk mencocokkan riid.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.
E_NOTIMPL	Aplikasi penerapan tidak mengekspos objek yang disematkan dalam aliran teksnya.
TF_E_NOINTERFACE	Objek tidak mendukung antarmuka yang diminta.
TF_E_NOLOCK	Nilai dalam parameter ec adalah cookie yang tidak valid, atau pemanggil tidak memiliki kunci baca-saja.
TF_E_NOOBJECT	Jangkar awal rentang tidak diposisikan sebelum karakter TF_CHAR_EMBEDDED.
TF_E_NOSERVICE	Konten tidak dapat dikembalikan untuk mencocokkan rguidService.

Keterangan

Meskipun objek yang diperoleh mungkin tidak mendukung antarmuka tertentu, kemungkinan objek akan mendukung antarmuka yang terkait dengan dokumen atau kontrol yang disematkan seperti IOleObject, IDataObject, IViewObject, IPersistStorage, IOleCache, atau IDispatch. Pemanggil harus menggunakan QueryInterface untuk memeriksa antarmuka yang menarik. Jika metode berhasil tetapi riid adalah NULL, aplikasi menunjukkan adanya objek yang disematkan tetapi tidak mengekspos objek itu sendiri. Prosesor teks masih dapat memperoleh manfaat dari pemberitahuan tentang potensi pemecahan kata.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional