Bagikan melalui


Kelas CDocObjectServerItem

Menerapkan kata kerja server OLE khusus untuk server DocObject.

Sintaks

class CDocObjectServerItem : public COleServerItem

Anggota

Konstruktor yang Dilindungi

Nama Deskripsi
CDocObjectServerItem::CDocObjectServerItem Membuat CDocObjectServerItem objek.

Metode Publik

Nama Deskripsi
CDocObjectServerItem::GetDocument Mengambil penunjuk ke dokumen yang berisi item.

Metode yang Dilindungi

Nama Deskripsi
CDocObjectServerItem::OnDoVerb Dipanggil untuk menjalankan kata kerja.
CDocObjectServerItem::OnHide Melemparkan pengecualian jika kerangka kerja mencoba menyembunyikan item DocObject.
CDocObjectServerItem::OnShow Dipanggil oleh kerangka kerja untuk membuat item DocObject aktif di tempat. Jika item bukan DocObject, panggil COleServerItem::OnShow.

Keterangan

CDocObjectServerItem menentukan fungsi anggota yang dapat diganti: OnHide, OnDoVerb, dan OnShow.

Untuk menggunakan CDocObjectServerItem, pastikan bahwa penimpaan OnGetEmbeddedItem di kelas -turunan Anda COleServerDocmengembalikan objek baru CDocObjectServerItem . Jika Anda perlu mengubah fungsionalitas apa pun dalam item, Anda dapat membuat instans baru kelas turunan Anda sendiri CDocObjectServerItem.

Untuk informasi lebih lanjut tentang DocObjects, lihat CDocObjectServer dan COleCmdUI di Referensi MFC.

Hierarki Warisan

CObject

CCmdTarget

CDocItem

COleServerItem

CDocObjectServerItem

Persyaratan

Header: afxdocob.h

CDocObjectServerItem::CDocObjectServerItem

Membuat CDocObjectServerItem objek.

CDocObjectServerItem(COleServerDoc* pServerDoc, BOOL bAutoDelete);

Parameter

pServerDoc
Penunjuk ke dokumen yang akan berisi item DocObject baru.

bAutoDelete
Menunjukkan apakah objek dapat dihapus saat tautan ke objek dirilis. Atur argumen ke FALSE jika CDocObjectServerItem objek adalah bagian integral dari data dokumen Anda. Atur ke TRUE jika objek adalah struktur sekunder yang digunakan untuk mengidentifikasi rentang dalam data dokumen Anda yang dapat dihapus oleh kerangka kerja.

CDocObjectServerItem::GetDocument

Mengambil penunjuk ke dokumen yang berisi item.

COleServerDoc* GetDocument() const;

Tampilkan Nilai

Penunjuk ke dokumen yang berisi item; NULL jika item bukan bagian dari dokumen.

Keterangan

Ini memungkinkan akses ke dokumen server yang Anda teruskan sebagai argumen ke konstruktor CDocObjectServerItem .

CDocObjectServerItem::OnDoVerb

Dipanggil oleh kerangka kerja untuk menjalankan kata kerja yang ditentukan.

virtual void OnDoVerb(LONG iVerb);

Parameter

iVerb
Menentukan kata kerja yang akan dijalankan. Untuk nilai yang mungkin, lihat IOleObject::D oVerb di Windows SDK.

Keterangan

Implementasi default memanggil fungsi anggota OnShow jika item adalah DocObject dan OLEIVERB_INPLACEACTIVATE atau OLEIVERB_SHOW ditentukan. Jika item bukan DocObject atau kata kerja yang berbeda ditentukan, implementasi default memanggil COleServerItem::OnDoVerb.

CDocObjectServerItem::OnHide

Dipanggil oleh kerangka kerja untuk menyembunyikan item.

virtual void OnHide();

Keterangan

Implementasi default melemparkan pengecualian jika item adalah DocObject. Anda tidak dapat menyembunyikan item DocObject aktif karena mengambil seluruh tampilan. Anda harus menonaktifkan item DocObject untuk membuatnya menghilang. Jika item bukan DocObject, implementasi default memanggil COleServerItem::OnHide.

CDocObjectServerItem::OnShow

Dipanggil oleh kerangka kerja untuk menginstruksikan aplikasi server agar item DocObject aktif.

virtual void OnShow();

Keterangan

Jika item bukan DocObject, implementasi default memanggil COleServerItem::OnShow. Ambil alih fungsi ini jika Anda ingin melakukan pemrosesan khusus saat membuka item DocObject.

Lihat juga

Kelas COleServerItem
Bagan Hierarki
Kelas CDocObjectServer
Kelas COleDocObjectItem