Bagikan melalui

Kelas COleTemplateServer

  • Artikel

Digunakan untuk server pengeditan visual OLE, server otomatisasi, dan kontainer tautan (aplikasi yang mendukung tautan ke penyematan).

Sintaks

class COleTemplateServer : public COleObjectFactory

Anggota

Konstruktor Publik

Nama Deskripsi
COleTemplateServer::COleTemplateServer Membuat COleTemplateServer objek.

Metode Publik

Nama Deskripsi
COleTemplateServer::ConnectTemplate Menyambungkan templat dokumen ke objek yang mendasar COleObjectFactory .
COleTemplateServer::Batalkan pendaftaran Membatalkan pendaftaran templat dokumen terkait.
COleTemplateServer::UpdateRegistry Mendaftarkan jenis dokumen dengan registri sistem OLE.

Keterangan

Kelas ini berasal dari kelas COleObjectFactory; biasanya, Anda dapat menggunakan COleTemplateServer secara langsung daripada mengambil kelas Anda sendiri. COleTemplateServermenggunakan objek CDocTemplate untuk mengelola dokumen server. Gunakan COleTemplateServer saat menerapkan server lengkap, yaitu server yang dapat dijalankan sebagai aplikasi mandiri. Server lengkap biasanya merupakan beberapa aplikasi antarmuka dokumen (MDI), meskipun aplikasi antarmuka dokumen tunggal (SDI) didukung. Satu COleTemplateServer objek diperlukan untuk setiap jenis dokumen server yang didukung aplikasi; yaitu, jika aplikasi server Anda mendukung lembar kerja dan bagan, Anda harus memiliki dua COleTemplateServer objek.

COleTemplateServer mengambil alih fungsi anggota yang OnCreateInstance ditentukan oleh COleObjectFactory. Fungsi anggota ini dipanggil oleh kerangka kerja untuk membuat objek C++ dari jenis yang tepat.

Untuk informasi selengkapnya tentang server, lihat artikel Server: Menerapkan Server.

Hierarki Warisan

CObject

CCmdTarget

COleObjectFactory

COleTemplateServer

Persyaratan

Header: afxdisp.h

COleTemplateServer::COleTemplateServer

Membuat COleTemplateServer objek.

COleTemplateServer();

Keterangan

Untuk deskripsi singkat tentang penggunaan COleTemplateServer kelas, lihat gambaran umum kelas COleLinkingDoc .

COleTemplateServer::ConnectTemplate

Menyambungkan templat dokumen yang ditunjukkan oleh pDocTemplate ke objek COleObjectFactory yang mendasar.

void ConnectTemplate(
    REFCLSID clsid,
    CDocTemplate* pDocTemplate,
    BOOL bMultiInstance);

Parameter

clsid
Referensi ke ID kelas OLE yang diminta templat.

pDocTemplate
Penunjuk ke templat dokumen.

bMultiInstance
Menunjukkan apakah satu instans aplikasi dapat mendukung beberapa instans. Jika TRUE, beberapa instans aplikasi diluncurkan untuk setiap permintaan untuk membuat objek.

Keterangan

Untuk informasi selengkapnya, lihat Kunci CLSID di Windows SDK.

COleTemplateServer::Batalkan pendaftaran

Membatalkan pendaftaran templat dokumen terkait.

BOOL Unregister();

Tampilkan Nilai

TRUE jika berhasil; jika tidak FALSE.

Keterangan

EnterRemarks

COleTemplateServer::UpdateRegistry

Memuat informasi jenis file dari string templat dokumen dan menempatkan informasi tersebut di registri sistem OLE.

void UpdateRegistry(
    OLE_APPTYPE nAppType = OAT_INPLACE_SERVER,
    LPCTSTR* rglpszRegister = NULL,
    LPCTSTR* rglpszOverwrite = NULL,
    BOOL bRegister = TRUE);

Parameter

nAppType
Nilai dari enumerasi OLE_APPTYPE, yang didefinisikan dalam AFXDISP.H. Ini dapat memiliki salah satu nilai berikut:

  • OAT_INPLACE_SERVER Server memiliki antarmuka pengguna server penuh.

  • OAT_SERVER Server hanya mendukung penyematan.

  • OAT_CONTAINER Container mendukung tautan ke objek yang disematkan.

  • Objek IDispatchOAT_DISPATCH_OBJECT mampu.

  • OAT_DOC_OBJECT_SERVER Server mendukung penyematan dan model komponen Objek Dokumen.

rglpszRegister
Daftar entri yang ditulis ke dalam registri hanya jika tidak ada entri.

rglpszOverwrite
Daftar entri yang ditulis ke dalam registri terlepas dari apakah ada entri sebelumnya.

bRegister
Menentukan apakah kelas akan didaftarkan. Jika bRegister TRUE, kelas terdaftar di registri sistem. Jika tidak, itu membatalkan pendaftaran kelas.

Keterangan

Informasi pendaftaran dimuat melalui panggilan ke CDocTemplate::GetDocString. Substring yang diambil adalah substring yang diidentifikasi oleh indeks regFileTypeId, , regFileTypeNamedan fileNewName, seperti yang dijelaskan di GetDocString halaman referensi.

regFileTypeId Jika substring kosong atau jika panggilan gagal GetDocString karena alasan lain, fungsi ini gagal dan informasi file tidak dimasukkan dalam registri.

Informasi dalam argumen rglpszRegister dan rglpszOverwrite ditulis ke registri melalui panggilan ke AfxOleRegisterServerClass. Informasi default, yang terdaftar ketika dua argumen adalah NULL, cocok untuk sebagian besar aplikasi. Untuk informasi tentang struktur informasi dalam argumen ini, lihat AfxOleRegisterServerClass.

Untuk informasi selengkapnya, lihat Menerapkan Antarmuka IDispatch.

Lihat juga

Sampel MFC HIERSVR
Kelas COleObjectFactory
Bagan Hierarki
Kelas COleServerDoc
Kelas COleServerItem