ITfRange::GetEmbedded method (msctf.h)
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 |
---|---|
|
Output harus menjadi objek Yang dapat diakses. |
|
Penelepon memerlukan penunjuk langsung ke objek yang mendukung antarmuka yang ditentukan oleh riid. |
|
Konten harus diperoleh sebagai objek transfer data IDataObject , dengan riid yang IID_IDataObject. Klien harus menentukan opsi ini saat salinan konten diperlukan. |
|
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 |
---|---|
|
Metode berhasil. |
|
Satu atau beberapa parameter tidak valid. |
|
Aplikasi penerapan tidak mengekspos objek yang disematkan dalam aliran teksnya. |
|
Objek tidak mendukung antarmuka yang diminta. |
|
Nilai dalam parameter ec adalah cookie yang tidak valid, atau pemanggil tidak memiliki kunci baca-saja. |
|
Jangkar awal rentang tidak diposisikan sebelum karakter TF_CHAR_EMBEDDED. |
|
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 |
Lihat juga
ITfEditSession::D oEditSession