Kelas COleTemplateServer

Nota

Pustaka Microsoft Foundation Classes (MFC) terus didukung. Namun, kami tidak lagi menambahkan fitur atau memperbarui dokumentasi.

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

Syntax

class COleTemplateServer : public COleObjectFactory

Members

Konstruktor Publik

Name	Description
COleTemplateServer::COleTemplateServer	Membuat COleTemplateServer objek.

Metode Publik

Name	Description
COleTemplateServer::ConnectTemplate	Menyambungkan templat dokumen ke objek yang mendasar COleObjectFactory .
COleTemplateServer::Unregister	Membatalkan pendaftaran templat dokumen terkait.
COleTemplateServer::UpdateRegistry	Mendaftarkan jenis dokumen dengan registri sistem OLE.

Remarks

Kelas ini berasal dari kelas COleObjectFactory; biasanya, Anda dapat menggunakan COleTemplateServer secara langsung daripada mengambil kelas Anda sendiri. COleTemplateServer menggunakan 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

Requirements

Header: afxdisp.h

COleTemplateServer::COleTemplateServer

Membuat COleTemplateServer objek.

COleTemplateServer();

Remarks

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);

Parameters

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.

Remarks

Untuk informasi selengkapnya, lihat Kunci CLSID di Windows SDK.

COleTemplateServer::Unregister

Membatalkan pendaftaran templat dokumen terkait.

BOOL Unregister();

Mengembalikan Nilai

TRUE jika berhasil; jika tidak FALSE.

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);

Parameters

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.

Remarks

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.

Baca juga

Sampel MFC HIERSVR
Kelas COleObjectFactory
Bagan Hierarki
Kelas COleServerDoc
Kelas COleServerItem