CDocument Kelas

Menyediakan fungsionalitas dasar untuk kelas dokumen yang ditentukan pengguna.

Sintaks

class CDocument : public CCmdTarget

Anggota

Konstruktor Publik

Nama	Deskripsi
CDocument::CDocument	Membuat CDocument objek.

Metode Publik

Nama	Deskripsi
CDocument::AddView	Melampirkan tampilan ke dokumen.
CDocument::BeginReadChunks	Menginisialisasi pembacaan gugus.
CDocument::CanCloseFrame	Dapat ditimpa tingkat lanjut; dipanggil sebelum menutup jendela bingkai yang melihat dokumen ini.
CDocument::ClearChunkList	Menghapus daftar gugus.
CDocument::ClearPathName	Menghapus jalur objek dokumen.
CDocument::DeleteContents	Dipanggil untuk melakukan pembersihan dokumen.
CDocument::FindChunk	Mencari gugus dengan GUID tertentu.
CDocument::GetAdapter	Mengembalikan penunjuk ke antarmuka penerapan IDocument objek.
CDocument::GetDocTemplate	Mengembalikan penunjuk ke templat dokumen yang menjelaskan jenis dokumen.
CDocument::GetFile	Mengembalikan penunjuk ke objek yang diinginkan CFile .
CDocument::GetFirstViewPosition	Mengembalikan posisi yang pertama dalam daftar tampilan; digunakan untuk memulai iterasi.
CDocument::GetNextView	Melakukan iterasi melalui daftar tampilan yang terkait dengan dokumen.
CDocument::GetPathName	Mengembalikan jalur file data dokumen.
CDocument::GetThumbnail	Dipanggil untuk membuat bitmap yang akan digunakan oleh penyedia gambar mini untuk menampilkan gambar mini.
CDocument::GetTitle	Mengembalikan judul dokumen.
CDocument::InitializeSearchContent	Dipanggil untuk menginisialisasi konten pencarian untuk Penangan Pencarian.
CDocument::IsModified	Menunjukkan apakah dokumen telah dimodifikasi sejak terakhir disimpan.
CDocument::IsSearchAndOrganizeHandler	Memberi tahu apakah instans CDocument objek ini dibuat untuk handler Pencarian & Atur.
CDocument::LoadDocumentFromStream	Dipanggil untuk memuat data dokumen dari aliran.
CDocument::OnBeforeRichPreviewFontChanged	Dipanggil sebelum font Pratinjau Kaya diubah.
CDocument::OnChangedViewList	Dipanggil setelah tampilan ditambahkan ke atau dihapus dari dokumen.
CDocument::OnCloseDocument	Dipanggil untuk menutup dokumen.
CDocument::OnCreatePreviewFrame	Dipanggil oleh kerangka kerja saat perlu membuat bingkai pratinjau untuk Pratinjau Kaya.
CDocument::OnDocumentEvent	Dipanggil oleh kerangka kerja sebagai respons terhadap peristiwa dokumen.
CDocument::OnDrawThumbnail	Ambil alih metode ini dalam kelas turunan untuk menggambar konten gambar mini.
CDocument::OnLoadDocumentFromStream	Dipanggil oleh kerangka kerja saat perlu memuat data dokumen dari aliran.
CDocument::OnNewDocument	Dipanggil untuk membuat dokumen baru.
CDocument::OnOpenDocument	Dipanggil untuk membuka dokumen yang sudah ada.
CDocument::OnPreviewHandlerQueryFocus	Mengarahkan handler pratinjau untuk mengembalikan HWND dari memanggil GetFocus Fungsi.
CDocument::OnPreviewHandlerTranslateAccelerator	Mengarahkan handler pratinjau untuk menangani penekanan kunci yang diteruskan dari pompa pesan proses di mana handler pratinjau berjalan.
CDocument::OnRichPreviewBackColorChanged	Dipanggil ketika warna latar belakang Pratinjau Kaya telah berubah.
CDocument::OnRichPreviewFontChanged	Dipanggil ketika font Pratinjau Kaya telah berubah.
CDocument::OnRichPreviewSiteChanged	Dipanggil ketika situs Pratinjau Kaya telah berubah.
CDocument::OnRichPreviewTextColorChanged	Dipanggil ketika warna teks Pratinjau Kaya telah berubah.
CDocument::OnSaveDocument	Dipanggil untuk menyimpan dokumen ke disk.
CDocument::OnUnloadHandler	Dipanggil oleh kerangka kerja saat handler pratinjau sedang dibongkar.
CDocument::PreCloseFrame	Dipanggil sebelum jendela bingkai ditutup.
CDocument::ReadNextChunkValue	Membaca nilai gugus berikutnya.
CDocument::ReleaseFile	Merilis file untuk membuatnya tersedia untuk digunakan oleh aplikasi lain.
CDocument::RemoveChunk	Menghapus gugus dengan .GUID
CDocument::RemoveView	Mencopot tampilan dari dokumen.
CDocument::ReportSaveLoadException	Dapat ditimpa tingkat lanjut; dipanggil ketika operasi buka atau simpan tidak dapat diselesaikan karena pengecualian.
CDocument::SaveModified	Dapat ditimpa tingkat lanjut; dipanggil untuk bertanya kepada pengguna apakah dokumen harus disimpan.
CDocument::SetChunkValue	Mengatur nilai potongan.
CDocument::SetModifiedFlag	Mengatur bendera yang menunjukkan bahwa Anda telah memodifikasi dokumen sejak terakhir disimpan.
CDocument::SetPathName	Mengatur jalur file data yang digunakan oleh dokumen.
CDocument::SetTitle	Mengatur judul dokumen.
CDocument::UpdateAllViews	Memberi tahu semua tampilan bahwa dokumen telah dimodifikasi.

Metode yang Dilindungi

Nama	Deskripsi
CDocument::OnFileSendMail	Mengirim pesan surat dengan dokumen terlampir.
CDocument::OnUpdateFileSendMail	Mengaktifkan perintah Kirim Email jika dukungan email ada.

Anggota Data Publik

Nama	Deskripsi
CDocument::m_bGetThumbnailMode	Menentukan bahwa CDocument objek dibuat oleh dllhost untuk gambar mini. Harus diperiksa di CView::OnDraw.
CDocument::m_bPreviewHandlerMode	Menentukan bahwa CDocument objek dibuat oleh prevhost untuk Rich Preview. Harus diperiksa di CView::OnDraw.
CDocument::m_bSearchMode	Menentukan bahwa CDocument objek dibuat oleh pengindeks atau aplikasi pencarian lainnya.
CDocument::m_clrRichPreviewBackColor	Menentukan warna latar belakang jendela Pratinjau Kaya. Warna ini diatur oleh host.
CDocument::m_clrRichPreviewTextColor	Menentukan warna latar depan jendela Pratinjau Kaya. Warna ini diatur oleh host.
CDocument::m_lfRichPreviewFont	Menentukan font teks untuk jendela Pratinjau Kaya. Informasi font ini diatur oleh host.

Keterangan

Dokumen mewakili unit data yang biasanya dibuka pengguna dengan perintah Buka File dan disimpan dengan perintah Simpan File.

CDocument mendukung operasi standar seperti membuat dokumen, memuatnya, dan menyimpannya. Kerangka kerja memanipulasi dokumen menggunakan antarmuka yang ditentukan oleh CDocument.

Aplikasi dapat mendukung lebih dari satu jenis dokumen; misalnya, aplikasi mungkin mendukung spreadsheet dan dokumen teks. Setiap jenis dokumen memiliki templat dokumen terkait; templat dokumen menentukan sumber daya apa (misalnya, menu, ikon, atau tabel akselerator) yang digunakan untuk jenis dokumen tersebut. Setiap dokumen berisi penunjuk ke objek terkait CDocTemplate .

Pengguna berinteraksi dengan dokumen melalui objek yang CView terkait dengannya. Tampilan merender gambar dokumen di jendela bingkai dan menginterpretasikan input pengguna sebagai operasi pada dokumen. Dokumen dapat memiliki beberapa tampilan yang terkait dengannya. Saat pengguna membuka jendela pada dokumen, kerangka kerja membuat tampilan dan melampirkannya ke dokumen. Templat dokumen menentukan jenis tampilan dan jendela bingkai apa yang digunakan untuk menampilkan setiap jenis dokumen.

Dokumen adalah bagian dari perutean perintah standar kerangka kerja dan akibatnya menerima perintah dari komponen antarmuka pengguna standar (seperti item menu Simpan File). Dokumen menerima perintah yang diteruskan oleh tampilan aktif. Jika dokumen tidak menangani perintah tertentu, dokumen meneruskan perintah ke templat dokumen yang mengelolanya.

Saat data dokumen dimodifikasi, setiap tampilannya harus mencerminkan modifikasi tersebut. CDocumentUpdateAllViews menyediakan fungsi anggota bagi Anda untuk memberi tahu tampilan perubahan tersebut, sehingga tampilan dapat mengecat ulang dirinya sendiri seperlunya. Kerangka kerja juga meminta pengguna untuk menyimpan file yang dimodifikasi sebelum menutupnya.

Untuk menerapkan dokumen dalam aplikasi umum, Anda harus melakukan hal berikut:

• Mendapatkan kelas dari CDocument untuk setiap jenis dokumen.

• Tambahkan variabel anggota untuk menyimpan data setiap dokumen.

• Menerapkan fungsi anggota untuk membaca dan memodifikasi data dokumen. Tampilan dokumen adalah pengguna terpenting dari fungsi anggota ini.

• Ambil alih CObject::Serialize fungsi anggota di kelas dokumen Anda untuk menulis dan membaca data dokumen ke dan dari disk.

CDocument mendukung pengiriman dokumen Anda melalui email jika ada dukungan email (MAPI). Lihat artikel Dukungan MAPI dan MAPI di MFC.

Untuk informasi selengkapnya tentang CDocument, lihat Serialisasi, Topik Arsitektur Dokumen/Tampilan, dan Pembuatan Dokumen/Tampilan.

Hierarki Warisan

CObject

CCmdTarget

CDocument

Persyaratan

Header: afxwin.h

CDocument::AddView

Panggil fungsi ini untuk melampirkan tampilan ke dokumen.

void AddView(CView* pView);

Parameter

pView
Menunjuk ke tampilan yang sedang ditambahkan.

Keterangan

Fungsi ini menambahkan tampilan yang ditentukan ke daftar tampilan yang terkait dengan dokumen; fungsi ini juga mengatur penunjuk dokumen tampilan ke dokumen ini. Kerangka kerja memanggil fungsi ini saat melampirkan objek tampilan yang baru dibuat ke dokumen; ini terjadi sebagai respons terhadap perintah File Baru, Buka File, atau Jendela Baru atau ketika jendela pemisah dipisahkan.

Panggil fungsi ini hanya jika Anda membuat dan melampirkan tampilan secara manual. Biasanya Anda akan membiarkan kerangka kerja menghubungkan dokumen dan tampilan dengan menentukan CDocTemplate objek untuk mengaitkan kelas dokumen, kelas tampilan, dan kelas jendela bingkai.

Contoh

// The following example toggles two views in an SDI (single document
// interface) frame window. A design decision must be made as to
// whether to leave the inactive view connected to the document,
// such that the inactive view continues to receive OnUpdate
// notifications from the document. It is usually desirable to
// keep the inactive view continuously in sync with the document, even
// though it is inactive. However, doing so incurs a performance cost,
// as well as the programming cost of implementing OnUpdate hints.
// It may be less expensive, in terms of performance and/or programming,
// to re-sync the inactive view with the document only with it is
// reactivated. This example illustrates this latter approach, by
// reconnecting the newly active view and disconnecting the newly
// inactive view, via calls to CDocument::AddView and RemoveView.

void CMainFrame::OnViewChange(UINT nCmdID)
// There is an ON_COMMAND_RANGE message map entry associated with
// OnViewChange:
// ON_COMMAND_RANGE(ID_VIEW_CHANGE1, ID_VIEW_CHANGE2, &OnViewChange)
{
   CView *pViewAdd;
   CView *pViewRemove;
   CDocument *pDoc = GetActiveDocument();

   // cvView1 and cvView2 are enum members defined in my CMainFrame class
   if ((nCmdID == ID_VIEW_CHANGE1) && (m_currentView == cvView1))
      return;
   if ((nCmdID == ID_VIEW_CHANGE2) && (m_currentView == cvView2))
      return;

   if (nCmdID == ID_VIEW_CHANGE2)
   {
      if (m_pView2 == NULL)
      {
         m_pView1 = GetActiveView();
         m_pView2 = new CMyView2;

         //Note that if OnSize has been overridden in CMyView2
         //and GetDocument() is used in this override it can
         //cause assertions and, if the assertions are ignored,
         //cause access violation.

         m_pView2->Create(NULL, NULL, AFX_WS_DEFAULT_VIEW, rectDefault, this,
                          AFX_IDW_PANE_FIRST + 1, NULL);
      }
      pViewAdd = m_pView2;
      pViewRemove = m_pView1;
      m_currentView = cvView2;
   }
   else
   {
      pViewAdd = m_pView1;
      pViewRemove = m_pView2;
      m_currentView = cvView1;
   }

   // Set the child i.d. of the active view to AFX_IDW_PANE_FIRST,
   // so that CFrameWnd::RecalcLayout will allocate to this
   // "first pane" that portion of   the frame window's client area
   // not allocated to control   bars.  Set the child i.d. of the
   // other view to anything other than AFX_IDW_PANE_FIRST; this
   // examples switches the child id's of the two views.

   int nSwitchChildID = pViewAdd->GetDlgCtrlID();
   pViewAdd->SetDlgCtrlID(AFX_IDW_PANE_FIRST);
   pViewRemove->SetDlgCtrlID(nSwitchChildID);

   // Show the newly active view and hide the inactive view.

   pViewAdd->ShowWindow(SW_SHOW);
   pViewRemove->ShowWindow(SW_HIDE);

   // Connect the newly active view to the document, and
   // disconnect the inactive view.
   pDoc->AddView(pViewAdd);
   pDoc->RemoveView(pViewRemove);

   SetActiveView(pViewAdd);
   RecalcLayout();
}

CDocument::BeginReadChunks

Menginisialisasi pembacaan gugus.

virtual void BeginReadChunks ();

Keterangan

CDocument::CanCloseFrame

Dipanggil oleh kerangka kerja sebelum jendela bingkai yang menampilkan dokumen ditutup.

virtual BOOL CanCloseFrame(CFrameWnd* pFrame);

Parameter

pFrame
Menunjuk ke jendela bingkai tampilan yang dilampirkan ke dokumen.

Tampilkan Nilai

Bukan nol jika aman untuk menutup jendela bingkai; jika tidak, 0.

Keterangan

Implementasi default memeriksa apakah ada jendela bingkai lain yang menampilkan dokumen. Jika jendela bingkai yang ditentukan adalah yang terakhir yang menampilkan dokumen, fungsi akan meminta pengguna untuk menyimpan dokumen jika telah dimodifikasi. Ambil alih fungsi ini jika Anda ingin melakukan pemrosesan khusus saat jendela bingkai ditutup. Ini adalah pengalih tingkat lanjut.

CDocument::CDocument

Membuat CDocument objek.

CDocument();

Keterangan

Kerangka kerja menangani pembuatan dokumen untuk Anda. Mengambil alih OnNewDocument fungsi anggota untuk melakukan inisialisasi berdasarkan per dokumen; ini sangat penting dalam aplikasi antarmuka dokumen tunggal (SDI).

CDocument::ClearChunkList

Menghapus daftar gugus.

virtual void ClearChunkList ();

Keterangan

CDocument::ClearPathName

Menghapus jalur objek dokumen.

virtual void ClearPathName();

Keterangan

Menghapus jalur dari CDocument objek menyebabkan aplikasi meminta pengguna saat dokumen disimpan berikutnya. Ini membuat perintah Simpan berulah seperti perintah Simpan Sebagai .

CDocument::DeleteContents

Dipanggil oleh kerangka kerja untuk menghapus data dokumen tanpa menghancurkan objek itu CDocument sendiri.

virtual void DeleteContents();

Keterangan

Ini dipanggil tepat sebelum dokumen akan dihancurkan. Ini juga dipanggil untuk memastikan bahwa dokumen kosong sebelum digunakan kembali. Ini sangat penting untuk aplikasi SDI, yang hanya menggunakan satu dokumen; dokumen digunakan kembali setiap kali pengguna membuat atau membuka dokumen lain. Panggil fungsi ini untuk mengimplementasikan "Edit Hapus Semua" atau perintah serupa yang menghapus semua data dokumen. Implementasi default fungsi ini tidak melakukan apa pun. Ambil alih fungsi ini untuk menghapus data dalam dokumen Anda.

Contoh

// This example is the handler for an Edit Clear All command.
void CExampleDoc::OnEditClearAll()
{
   DeleteContents();
   UpdateAllViews(NULL);
}

void CExampleDoc::DeleteContents()
{
   // Re-initialize document data here.
}

CDocument::FindChunk

Mencari gugus dengan GUID tertentu.

virtual POSITION FindChunk(
    REFCLSID guid,
    DWORD pid);

Parameter

guid
Menentukan GUID gugus yang akan ditemukan.

pid
Menentukan PID dari gugus yang akan ditemukan.

Tampilkan Nilai

Posisi dalam daftar gugus internal jika berhasil. Jika tidak NULL, .

Keterangan

CDocument::GetAdapter

Mengembalikan penunjuk ke objek yang mengimplementasikan IDocument antarmuka.

virtual ATL::IDocument* GetAdapter();

Tampilkan Nilai

Penunjuk ke objek yang mengimplementasikan IDocument antarmuka.

Keterangan

CDocument::GetDocTemplate

Panggil fungsi ini untuk mendapatkan penunjuk ke templat dokumen untuk jenis dokumen ini.

CDocTemplate* GetDocTemplate() const;

Tampilkan Nilai

Penunjuk ke templat dokumen untuk tipe dokumen ini, atau NULL jika dokumen tidak dikelola oleh templat dokumen.

Contoh

// This example accesses the doc template object to construct
// a default document name such as SHEET.XLS, where "sheet"
// is the base document name and ".xls" is the file extension
// for the document type.
CString strDefaultDocName, strBaseName, strExt;
CDocTemplate *pDocTemplate = GetDocTemplate();
if (!pDocTemplate->GetDocString(strBaseName, CDocTemplate::docName) || !pDocTemplate->GetDocString(strExt, CDocTemplate::filterExt))
{
   AfxThrowUserException(); // These doc template strings will
                            // be available if you created the application using AppWizard
                            // and specified the file extension as an option for
                            // the document class produced by AppWizard.
}
strDefaultDocName = strBaseName + strExt;

CDocument::GetFile

Panggil fungsi anggota ini untuk mendapatkan penunjuk ke CFile objek.

virtual CFile* GetFile(
    LPCTSTR lpszFileName,
    UINT nOpenFlags,
    CFileException* pError);

Parameter

lpszFileName
String yang merupakan jalur ke file yang diinginkan. Jalur mungkin relatif atau absolut.

pError
Penunjuk ke objek pengecualian file yang ada yang menunjukkan status penyelesaian operasi.

nOpenFlags
Mode berbagi dan akses. Menentukan tindakan yang akan diambil saat membuka file. Anda dapat menggabungkan opsi yang tercantum dalam konstruktor CFile::CFile CFile dengan menggunakan operator bitwise OR (|). Diperlukan satu izin akses dan satu opsi berbagi; modeCreate mode dan modeNoInherit bersifat opsional.

Tampilkan Nilai

Penunjuk ke CFile objek.

CDocument::GetFirstViewPosition

Panggil fungsi ini untuk mendapatkan posisi tampilan pertama dalam daftar tampilan yang terkait dengan dokumen.

virtual POSITION GetFirstViewPosition() const;

Tampilkan Nilai

POSITION Nilai yang dapat digunakan untuk iterasi dengan GetNextView fungsi anggota.

Contoh

//To get the first view in the list of views:
//To get the first view in the list of views:
// POSITION pos = GetFirstViewPosition();
// CView* pFirstView = GetNextView(pos);
//
// This example uses CDocument::GetFirstViewPosition
// and GetNextView to repaint each view.
// An easier way to accomplish the same result is to call
// UpdateAllViews(NULL);
void CExampleDoc::OnRepaintAllViews()
{
   POSITION pos = GetFirstViewPosition();
   while (pos != NULL)
   {
      CView *pView = GetNextView(pos);
      pView->UpdateWindow();
   }
}

CDocument::GetNextView

Panggil fungsi ini untuk melakukan iterasi melalui semua tampilan dokumen.

virtual CView* GetNextView(POSITION& rPosition) const;

Parameter

rPosition
Referensi ke nilai yang POSITION dikembalikan oleh panggilan sebelumnya ke GetNextView fungsi atau GetFirstViewPosition anggota. Nilai ini tidak boleh NULL.

Tampilkan Nilai

Penunjuk ke tampilan yang diidentifikasi oleh rPosition.

Keterangan

Fungsi mengembalikan tampilan yang diidentifikasi oleh rPosition lalu diatur rPosition ke POSITION nilai tampilan berikutnya dalam daftar. Jika tampilan yang diambil adalah yang terakhir dalam daftar, maka rPosition diatur ke NULL.

Contoh

//To get the first view in the list of views:
//To get the first view in the list of views:
// POSITION pos = GetFirstViewPosition();
// CView* pFirstView = GetNextView(pos);
//
// This example uses CDocument::GetFirstViewPosition
// and GetNextView to repaint each view.
// An easier way to accomplish the same result is to call
// UpdateAllViews(NULL);
void CExampleDoc::OnRepaintAllViews()
{
   POSITION pos = GetFirstViewPosition();
   while (pos != NULL)
   {
      CView *pView = GetNextView(pos);
      pView->UpdateWindow();
   }
}

CDocument::GetPathName

Panggil fungsi ini untuk mendapatkan jalur file disk dokumen yang sepenuhnya memenuhi syarat.

const CString& GetPathName() const;

Tampilkan Nilai

Jalur dokumen yang sepenuhnya memenuhi syarat. String ini kosong jika dokumen belum disimpan atau tidak memiliki file disk yang terkait dengannya.

CDocument::GetThumbnail

Membuat bitmap yang akan digunakan oleh penyedia gambar mini untuk menampilkan gambar mini.

virtual BOOL GetThumbnail(
    UINT cx,
    HBITMAP* phbmp,
    DWORD* pdwAlpha);

Parameter

cx
Menentukan lebar dan tinggi bitmap.

phbmp
Berisi handel ke bitmap, ketika fungsi berhasil dikembalikan.

pdwAlpha
DWORD Berisi yang menentukan nilai saluran alfa, ketika fungsi berhasil dikembalikan.

Tampilkan Nilai

Mengembalikan TRUE jika bitmap untuk gambar mini berhasil dibuat; jika tidak FALSE.

Keterangan

CDocument::GetTitle

Panggil fungsi ini untuk mendapatkan judul dokumen, yang biasanya berasal dari nama file dokumen.

const CString& GetTitle() const;

Tampilkan Nilai

Judul dokumen.

CDocument::InitializeSearchContent

Dipanggil untuk menginisialisasi konten pencarian untuk Penangan Pencarian.

virtual void InitializeSearchContent ();

Keterangan

Ambil alih metode ini di kelas turunan untuk menginisialisasi konten pencarian. Konten harus berupa string dengan bagian yang dibatasi oleh ";". Misalnya, "titik; persegi panjang; item ole".

CDocument::IsModified

Panggil fungsi ini untuk menentukan apakah dokumen telah dimodifikasi sejak terakhir disimpan.

virtual BOOL IsModified();

Tampilkan Nilai

Bukan nol jika dokumen telah dimodifikasi sejak terakhir disimpan; jika tidak, 0.

CDocument::IsSearchAndOrganizeHandler

Memberi tahu apakah instans CDocument ini dibuat untuk handler Pencarian & Atur.

BOOL IsSearchAndOrganizeHandler() const;

Tampilkan Nilai

Mengembalikan jika instans TRUE CDocument ini dibuat untuk handler Pencarian & Atur.

Keterangan

Saat ini fungsi ini hanya mengembalikan TRUE untuk penangan Pratinjau Kaya yang diimplementasikan di server di luar proses. Anda dapat mengatur bendera yang sesuai (m_bPreviewHandlerMode, , ) m_bGetThumbnailModedi tingkat aplikasi Anda untuk membuat fungsi ini kembali TRUEm_bSearchMode.

CDocument::LoadDocumentFromStream

Dipanggil untuk memuat data dokumen dari aliran.

virtual HRESULT LoadDocumentFromStream(
    IStream* pStream,
    DWORD dwGrfMode);

Parameter

pStream
Penunjuk ke aliran. Aliran ini disediakan oleh Shell.

dwGrfMode
Mode akses ke aliran.

Tampilkan Nilai

S_OK jika operasi pemuatan berhasil, jika tidak HRESULT dengan kode kesalahan.

Keterangan

Anda dapat mengambil alih metode ini di kelas turunan untuk menyesuaikan cara memuat data dari aliran.

CDocument::m_bGetThumbnailMode

Menentukan bahwa CDocument objek dibuat oleh dllhost untuk gambar mini. Harus diperiksa di CView::OnDraw.

BOOL m_bGetThumbnailMode;

Keterangan

TRUE menunjukkan bahwa dokumen dibuat oleh dllhost untuk gambar mini.

CDocument::m_bPreviewHandlerMode

Menentukan bahwa CDocument objek dibuat oleh prevhost untuk Pratinjau Kaya. Harus diperiksa di CView::OnDraw.

BOOL m_bPreviewHandlerMode;

Keterangan

TRUE menunjukkan bahwa dokumen dibuat oleh prevhost untuk Pratinjau Kaya.

CDocument::m_bSearchMode

Menentukan bahwa CDocument objek dibuat oleh pengindeks atau oleh aplikasi pencarian lain.

BOOL m_bSearchMode;

Keterangan

TRUE menunjukkan bahwa dokumen dibuat oleh pengindeks atau oleh aplikasi pencarian lain.

CDocument::m_clrRichPreviewBackColor

Menentukan warna latar belakang jendela Pratinjau Kaya. Warna ini diatur oleh host.

COLORREF m_clrRichPreviewBackColor;

Keterangan

CDocument::m_clrRichPreviewTextColor

Menentukan warna latar depan jendela Pratinjau Kaya. Warna ini diatur oleh host.

COLORREF m_clrRichPreviewTextColor;

Keterangan

CDocument::m_lfRichPreviewFont

Menentukan font teks untuk jendela Pratinjau Kaya. Informasi font ini diatur oleh host.

CFont m_lfRichPreviewFont;

Keterangan

CDocument::OnBeforeRichPreviewFontChanged

Dipanggil sebelum font Pratinjau Kaya diubah.

virtual void OnBeforeRichPreviewFontChanged();

Keterangan

CDocument::OnChangedViewList

Dipanggil oleh kerangka kerja setelah tampilan ditambahkan ke atau dihapus dari dokumen.

virtual void OnChangedViewList();

Keterangan

Implementasi default fungsi ini memeriksa apakah tampilan terakhir sedang dihapus dan, jika demikian, menghapus dokumen. Ambil alih fungsi ini jika Anda ingin melakukan pemrosesan khusus saat kerangka kerja menambahkan atau menghapus tampilan. Misalnya, jika Anda ingin dokumen tetap terbuka bahkan ketika tidak ada tampilan yang melekat padanya, ambil alih fungsi ini.

CDocument::OnCloseDocument

Dipanggil oleh kerangka kerja saat dokumen ditutup, biasanya sebagai bagian dari perintah Tutup File.

virtual void OnCloseDocument();

Keterangan

Implementasi default fungsi ini menghancurkan semua bingkai yang digunakan untuk melihat dokumen, menutup tampilan, membersihkan konten dokumen, lalu memanggil DeleteContents fungsi anggota untuk menghapus data dokumen.

Ambil alih fungsi ini jika Anda ingin melakukan pemrosesan pembersihan khusus saat kerangka kerja menutup dokumen. Misalnya, jika dokumen mewakili rekaman dalam database, Anda mungkin ingin mengambil alih fungsi ini untuk menutup database. Anda harus memanggil versi kelas dasar fungsi ini dari penimpaan Anda.

CDocument::OnCreatePreviewFrame

Dipanggil oleh kerangka kerja saat perlu membuat bingkai pratinjau untuk Pratinjau Kaya.

virtual BOOL OnCreatePreviewFrame();

Tampilkan Nilai

Mengembalikan TRUE jika bingkai berhasil dibuat; jika tidak FALSE.

Keterangan

CDocument::OnDocumentEvent

Dipanggil oleh kerangka kerja sebagai respons terhadap peristiwa dokumen.

virtual void OnDocumentEvent(DocumentEvent deEvent);

Parameter

deEvent
[di] Jenis data enumerasi yang menjelaskan jenis peristiwa.

Keterangan

Peristiwa dokumen dapat memengaruhi beberapa kelas. Metode ini bertanggung jawab untuk menangani peristiwa dokumen yang memengaruhi kelas selain CDocument Kelas. Saat ini, satu-satunya kelas yang harus merespons peristiwa dokumen adalah CDataRecoveryHandler Kelas. Kelas CDocument ini memiliki metode lain yang dapat ditimpa yang bertanggung jawab untuk menangani efek pada CDocument.

Tabel berikut mencantumkan nilai yang mungkin untuk deEvent dan peristiwa yang sesuai dengannya.

Nilai	Peristiwa yang Sesuai
onAfterNewDocument	Dokumen baru dibuat.
onAfterOpenDocument	Dokumen baru dibuka.
onAfterSaveDocument	Dokumen disimpan.
onAfterCloseDocument	Dokumen ditutup.

CDocument::OnDrawThumbnail

Ambil alih metode ini dalam kelas turunan untuk menggambar gambar mini.

virtual void OnDrawThumbnail(
    CDC& dc,
    LPRECT lprcBounds);

Parameter

dc
Referensi ke konteks perangkat.

lprcBounds
Menentukan persegi panjang batas area tempat gambar mini harus digambar.

Keterangan

CDocument::OnFileSendMail

Mengirim pesan melalui host email penduduk (jika ada) dengan dokumen sebagai lampiran.

void OnFileSendMail();

Keterangan

OnFileSendMailOnSaveDocument panggilan untuk membuat serialisasi (menyimpan) dokumen yang tidak berjudul dan dimodifikasi ke file sementara, yang kemudian dikirim melalui surat elektronik. Jika dokumen belum dimodifikasi, file sementara tidak diperlukan; aslinya dikirim. OnFileSendMail memuat MAPI32.DLL jika belum dimuat.

Implementasi OnFileSendMail khusus untuk COleDocument menangani file campuran dengan benar.

CDocument mendukung pengiriman dokumen Anda melalui email jika ada dukungan email (MAPI). Lihat artikel Topik MAPI dan Dukungan MAPI di MFC.

CDocument::OnLoadDocumentFromStream

Dipanggil oleh kerangka kerja saat perlu memuat data dokumen dari aliran.

virtual HRESULT OnLoadDocumentFromStream(
    IStream* pStream,
    DWORD grfMode);

Parameter

pStream
Penunjuk ke aliran masuk.

grfMode
Mode akses ke aliran.

Tampilkan Nilai

S_OK jika beban berhasil; jika tidak, kode kesalahan.

Keterangan

CDocument::OnNewDocument

Dipanggil oleh kerangka kerja sebagai bagian dari perintah File Baru.

virtual BOOL OnNewDocument();

Tampilkan Nilai

Bukan nol jika dokumen berhasil diinisialisasi; jika tidak, 0.

Keterangan

Implementasi default fungsi ini memanggil DeleteContents fungsi anggota untuk memastikan bahwa dokumen kosong lalu menandai dokumen baru sebagai bersih. Ambil alih fungsi ini untuk menginisialisasi struktur data untuk dokumen baru. Anda harus memanggil versi kelas dasar fungsi ini dari penimpaan Anda.

Jika pengguna memilih perintah File Baru dalam aplikasi SDI, kerangka kerja menggunakan fungsi ini untuk menginisialisasi ulang dokumen yang ada, daripada membuat yang baru. Jika pengguna memilih File Baru dalam aplikasi antarmuka beberapa dokumen (MDI), kerangka kerja membuat dokumen baru setiap kali lalu memanggil fungsi ini untuk menginisialisasinya. Anda harus menempatkan kode inisialisasi Anda dalam fungsi ini alih-alih di konstruktor agar perintah File Baru efektif dalam aplikasi SDI.

Perhatikan bahwa ada kasus di mana OnNewDocument dipanggil dua kali. Ini terjadi ketika dokumen disematkan sebagai Server Dokumen ActiveX. Fungsi ini pertama kali dipanggil oleh CreateInstance metode (diekspos oleh COleObjectFactorykelas -turunan) dan kedua kalinya InitNew dengan metode (diekspos oleh COleServerDockelas -turunan).

Contoh

Contoh berikut mengilustrasikan metode alternatif untuk menginisialisasi objek dokumen.

// Method 1: In an MDI application, the simplest place to do
// initialization is in the document constructor.  The framework
// always creates a new document object for File New or File Open.
CExampleDoc::CExampleDoc()
{
   // Do initialization of MDI document here.
}

 

// Method 2: In an SDI or MDI application, do all initialization
// in an override of OnNewDocument, if you are certain that
// the initialization is effectively saved upon File Save
// and fully restored upon File Open, via serialization.
BOOL CMyDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   // Do initialization of new document here.

   return TRUE;
}

 

// Method 3: If the initialization of your document is not
// effectively saved and restored by serialization (during File Save
// and File Open), then implement the initialization in single
// function (named InitMyDocument in this example).  Call the
// shared initialization function from overrides of both
// OnNewDocument and OnOpenDocument.
BOOL CExampleDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   InitMyDocument(); // call your shared initialization function

   // If your new document object requires additional initialization
   // not necessary when the document is deserialized via File Open,
   // then perform that additional initialization here.

   return TRUE;
}

CDocument::OnOpenDocument

Dipanggil oleh kerangka kerja sebagai bagian dari perintah Buka File.

virtual BOOL OnOpenDocument(LPCTSTR lpszPathName);

Parameter

lpszPathName
Menunjuk ke jalur dokumen yang akan dibuka.

Tampilkan Nilai

Bukan nol jika dokumen berhasil dimuat; jika tidak, 0.

Keterangan

Implementasi default fungsi ini membuka file yang ditentukan, memanggil DeleteContents fungsi anggota untuk memastikan bahwa dokumen kosong, memanggil CObject::Serialize untuk membaca konten file, lalu menandai dokumen sebagai bersih. Ambil alih fungsi ini jika Anda ingin menggunakan sesuatu selain mekanisme arsip atau mekanisme file. Misalnya, Anda dapat menulis aplikasi di mana dokumen mewakili rekaman dalam database daripada file terpisah.

Jika pengguna memilih perintah Buka File dalam aplikasi SDI, kerangka kerja menggunakan fungsi ini untuk menginisialisasi ulang objek yang ada CDocument , daripada membuat yang baru. Jika pengguna memilih Buka File dalam aplikasi MDI, kerangka kerja membuat objek baru CDocument setiap kali lalu memanggil fungsi ini untuk menginisialisasinya. Anda harus menempatkan kode inisialisasi Anda dalam fungsi ini alih-alih di konstruktor agar perintah Buka File efektif dalam aplikasi SDI.

Contoh

Contoh berikut mengilustrasikan metode alternatif untuk menginisialisasi objek dokumen.

// Method 1: In an MDI application, the simplest place to do
// initialization is in the document constructor.  The framework
// always creates a new document object for File New or File Open.
CExampleDoc::CExampleDoc()
{
   // Do initialization of MDI document here.
}

 

// Method 2: In an SDI or MDI application, do all initialization
// in an override of OnNewDocument, if you are certain that
// the initialization is effectively saved upon File Save
// and fully restored upon File Open, via serialization.
BOOL CMyDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   // Do initialization of new document here.

   return TRUE;
}

 

// Method 3: If the initialization of your document is not
// effectively saved and restored by serialization (during File Save
// and File Open), then implement the initialization in single
// function (named InitMyDocument in this example).  Call the
// shared initialization function from overrides of both
// OnNewDocument and OnOpenDocument.
BOOL CExampleDoc::OnNewDocument()
{
   if (!CDocument::OnNewDocument())
   {
      return FALSE;
   }

   InitMyDocument(); // call your shared initialization function

   // If your new document object requires additional initialization
   // not necessary when the document is deserialized via File Open,
   // then perform that additional initialization here.

   return TRUE;
}

 

// Additional example of OnOpenDocument()
BOOL CExampleDoc::OnOpenDocument(LPCTSTR lpszPathName)
{
   if (!CDocument::OnOpenDocument(lpszPathName))
   {
      return FALSE;
   }

   InitMyDocument(); // call your shared initialization function

   return TRUE;
}

CDocument::OnPreviewHandlerQueryFocus

Mengarahkan handler pratinjau untuk mengembalikan yang HWND diambil dari memanggil GetFocus fungsi.

virtual HRESULT OnPreviewHandlerQueryFocus(HWND* phwnd);

Parameter

phwnd
[out] Ketika metode ini kembali, berisi penunjuk ke HWND yang dikembalikan dari memanggil GetFocus fungsi dari utas latar depan handler pratinjau.

Tampilkan Nilai

Mengembalikan S_OK jika berhasil; atau nilai kesalahan sebaliknya.

Keterangan

CDocument::OnPreviewHandlerTranslateAccelerator

Mengarahkan handler pratinjau untuk menangani penekanan kunci yang diteruskan dari pompa pesan proses di mana handler pratinjau berjalan.

virtual HRESULT OnPreviewHandlerTranslateAccelerator(MSG* pmsg);

Parameter

pmsg
[di] Penunjuk ke pesan jendela.

Tampilkan Nilai

Jika pesan penekanan kunci dapat diproses oleh handler pratinjau, handler memprosesnya dan mengembalikan S_OK. Jika handler pratinjau tidak dapat memproses pesan penekanan kunci, ia menawarkannya ke host melalui IPreviewHandlerFrame::TranslateAccelerator. Jika host memproses pesan, metode ini mengembalikan S_OK. Jika host tidak memproses pesan, metode ini mengembalikan S_FALSE.

Keterangan

CDocument::OnRichPreviewBackColorChanged

Dipanggil ketika warna latar belakang Pratinjau Kaya telah berubah.

virtual void OnRichPreviewBackColorChanged();

Keterangan

CDocument::OnRichPreviewFontChanged

Dipanggil ketika font Pratinjau Kaya telah berubah.

virtual void OnRichPreviewFontChanged();

Keterangan

CDocument::OnRichPreviewSiteChanged

Dipanggil ketika situs Pratinjau Kaya telah berubah.

virtual void OnRichPreviewSiteChanged();

Keterangan

CDocument::OnRichPreviewTextColorChanged

Dipanggil saat warna teks Pratinjau Kaya telah berubah.

virtual void OnRichPreviewTextColorChanged();

Keterangan

CDocument::OnSaveDocument

Dipanggil oleh kerangka kerja sebagai bagian dari perintah Simpan File atau Simpan File Sebagai.

virtual BOOL OnSaveDocument(LPCTSTR lpszPathName);

Parameter

lpszPathName
Menunjuk ke jalur yang sepenuhnya memenuhi syarat tempat file harus disimpan.

Tampilkan Nilai

Bukan nol jika dokumen berhasil disimpan; jika tidak, 0.

Keterangan

Implementasi default fungsi ini membuka file yang ditentukan, memanggil CObject::Serialize untuk menulis data dokumen ke file, lalu menandai dokumen sebagai bersih. Ambil alih fungsi ini jika Anda ingin melakukan pemrosesan khusus saat kerangka kerja menyimpan dokumen. Misalnya, Anda dapat menulis aplikasi di mana dokumen mewakili rekaman dalam database daripada file terpisah.

CDocument::OnUnloadHandler

Dipanggil oleh kerangka kerja saat handler pratinjau dibongkar.

virtual void OnUnloadHandler();

Keterangan

CDocument::OnUpdateFileSendMail

ID_FILE_SEND_MAIL Mengaktifkan perintah jika dukungan email (MAPI) ada.

void OnUpdateFileSendMail(CCmdUI* pCmdUI);

Parameter

pCmdUI
Penunjuk ke objek yang CCmdUI terkait dengan ID_FILE_SEND_MAIL perintah .

Keterangan

Jika tidak, fungsi akan menghapus ID_FILE_SEND_MAIL perintah dari menu, termasuk pemisah di atas atau di bawah item menu yang sesuai. MAPI diaktifkan jika MAPI32.DLL ada di jalur dan, di bagian WIN.INI [Mail] file, MAPI=1. Sebagian besar aplikasi menempatkan perintah ini pada menu File.

CDocument mendukung pengiriman dokumen Anda melalui email jika ada dukungan email (MAPI). Lihat artikel Topik MAPI dan Dukungan MAPI di MFC.

CDocument::PreCloseFrame

Fungsi anggota ini dipanggil oleh kerangka kerja sebelum jendela bingkai dihancurkan.

virtual void PreCloseFrame(CFrameWnd* pFrame);

Parameter

pFrame
Penunjuk ke CFrameWnd yang menyimpan objek terkait CDocument .

Keterangan

Ini dapat ditimpa untuk memberikan pembersihan kustom, tetapi pastikan untuk memanggil kelas dasar juga.

Default tidak PreCloseFrame melakukan apa pun di CDocument. Kelas CDocument-turunan COleDocument dan CRichEditDoc gunakan fungsi anggota ini.

CDocument::ReadNextChunkValue

Membaca nilai gugus berikutnya.

virtual BOOL ReadNextChunkValue(IFilterChunkValue** ppValue);

Parameter

ppValue
[out] Saat fungsi kembali, ppValue berisi nilai yang dibaca.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

CDocument::ReleaseFile

Fungsi anggota ini dipanggil oleh kerangka kerja untuk merilis file, membuatnya tersedia untuk digunakan oleh aplikasi lain.

virtual void ReleaseFile(
    CFile* pFile,
    BOOL bAbort);

Parameter

pFile
Penunjuk ke objek yang CFile akan dilepaskan.

bAbort
Menentukan apakah file akan dirilis dengan menggunakan CFile::Close atau CFile::Abort. FALSE jika file akan dirilis menggunakan CFile::Close; TRUE jika file akan dirilis menggunakan CFile::Abort.

Keterangan

Jika bAbort adalah TRUE, ReleaseFile panggilan CFile::Abort, dan file dirilis. CFile::Abort tidak akan melemparkan pengecualian.

Jika bAbort adalah FALSE, ReleaseFile panggilan CFile::Close dan file dirilis.

Ambil alih fungsi anggota ini untuk memerlukan tindakan oleh pengguna sebelum file dirilis.

CDocument::RemoveChunk

Menghapus potongan dengan GUID.

virtual void RemoveChunk(
    REFCLSID guid,
    DWORD pid);

Parameter

Guid
GUID Menentukan gugus yang akan dihapus.

Pid
PID Menentukan gugus yang akan dihapus.

Keterangan

CDocument::RemoveView

Panggil fungsi ini untuk melepaskan tampilan dari dokumen.

void RemoveView(CView* pView);

Parameter

pView
Menunjuk ke tampilan yang dihapus.

Keterangan

Fungsi ini menghapus tampilan yang ditentukan dari daftar tampilan yang terkait dengan dokumen; ini juga mengatur penunjuk dokumen tampilan ke NULL. Fungsi ini dipanggil oleh kerangka kerja saat jendela bingkai ditutup atau panel jendela pemisah ditutup.

Panggil fungsi ini hanya jika Anda melepaskan tampilan secara manual. Biasanya Anda akan membiarkan kerangka kerja melepaskan dokumen dan tampilan dengan menentukan CDocTemplate objek untuk mengaitkan kelas dokumen, kelas tampilan, dan kelas jendela bingkai.

Lihat contoh di AddView untuk implementasi sampel.

CDocument::ReportSaveLoadException

Dipanggil jika pengecualian dilemparkan (biasanya atau CFileException CArchiveException) saat menyimpan atau memuat dokumen.

virtual void ReportSaveLoadException(
    LPCTSTR lpszPathName,
    CException* e,
    BOOL bSaving,
    UINT nIDPDefault);

Parameter

lpszPathName
Menunjuk ke nama dokumen yang sedang disimpan atau dimuat.

e
Menunjuk ke pengecualian yang dilemparkan. Mungkin NULL.

bSaving
Bendera yang menunjukkan operasi apa yang sedang berlangsung; bukan nol jika dokumen sedang disimpan, 0 jika dokumen sedang dimuat.

nIDPDefault
Pengidentifikasi pesan kesalahan yang akan ditampilkan jika fungsi tidak menentukan yang lebih spesifik.

Keterangan

Implementasi default memeriksa objek pengecualian dan mencari pesan kesalahan yang secara khusus menjelaskan penyebabnya. Jika pesan tertentu tidak ditemukan atau jika e adalah NULL, pesan umum yang ditentukan oleh nIDPDefault parameter digunakan. Fungsi kemudian menampilkan kotak pesan yang berisi pesan kesalahan. Ambil alih fungsi ini jika Anda ingin memberikan pesan kegagalan tambahan yang disesuaikan. Ini adalah pengalih tingkat lanjut.

CDocument::SaveModified

Dipanggil oleh kerangka kerja sebelum dokumen yang dimodifikasi akan ditutup.

virtual BOOL SaveModified();

Tampilkan Nilai

Bukan nol jika aman untuk melanjutkan dan menutup dokumen; 0 jika dokumen tidak boleh ditutup.

Keterangan

Implementasi default fungsi ini menampilkan kotak pesan yang menanyakan kepada pengguna apakah akan menyimpan perubahan ke dokumen, jika ada yang telah dibuat. Ambil alih fungsi ini jika program Anda memerlukan prosedur permintaan yang berbeda. Ini adalah pengalih tingkat lanjut.

CDocument::SetChunkValue

Mengatur nilai potongan.

virtual BOOL SetChunkValue (IFilterChunkValue* pValue);

Parameter

pValue
Menentukan nilai gugus yang akan diatur.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

CDocument::SetModifiedFlag

Panggil fungsi ini setelah Anda melakukan modifikasi pada dokumen.

virtual void SetModifiedFlag(BOOL bModified = TRUE);

Parameter

bModified
Bendera yang menunjukkan apakah dokumen telah dimodifikasi.

Keterangan

Dengan memanggil fungsi ini secara konsisten, Anda memastikan bahwa kerangka kerja meminta pengguna untuk menyimpan perubahan sebelum menutup dokumen. Biasanya Anda harus menggunakan nilai TRUE default untuk bModified parameter . Untuk menandai dokumen sebagai bersih (tidak dimodifikasi), panggil fungsi ini dengan nilai FALSE.

CDocument::SetPathName

Panggil fungsi ini untuk menentukan jalur file disk dokumen yang sepenuhnya memenuhi syarat.

virtual void SetPathName(
    LPCTSTR lpszPathName,
    BOOL bAddToMRU = TRUE);

Parameter

lpszPathName
Menunjuk ke string yang akan digunakan sebagai jalur untuk dokumen.

bAddToMRU
Menentukan apakah nama file ditambahkan ke daftar file yang terakhir digunakan (MRU). Jika TRUE, nama file ditambahkan; jika FALSE, itu tidak ditambahkan.

Keterangan

Bergantung pada nilai bAddToMRU jalur ditambahkan, atau tidak ditambahkan, ke daftar MRU yang dikelola oleh aplikasi. Perhatikan bahwa beberapa dokumen tidak terkait dengan file disk. Panggil fungsi ini hanya jika Anda mengambil alih implementasi default untuk membuka dan menyimpan file yang digunakan oleh kerangka kerja.

CDocument::SetTitle

Panggil fungsi ini untuk menentukan judul dokumen (string yang ditampilkan di bilah judul jendela bingkai).

virtual void SetTitle(LPCTSTR lpszTitle);

Parameter

lpszTitle
Menunjuk ke string yang akan digunakan sebagai judul dokumen.

Keterangan

Memanggil fungsi ini memperbarui judul semua jendela bingkai yang menampilkan dokumen.

CDocument::UpdateAllViews

Panggil fungsi ini setelah dokumen diubah.

void UpdateAllViews(
    CView* pSender,
    LPARAM lHint = 0L,
    CObject* pHint = NULL);

Parameter

pSender
Arahkan ke tampilan yang mengubah dokumen, atau NULL jika semua tampilan akan diperbarui.

lHint
Berisi informasi tentang modifikasi.

pHint
Menunjuk ke objek yang menyimpan informasi tentang modifikasi.

Keterangan

Anda harus memanggil fungsi ini setelah memanggil SetModifiedFlag fungsi anggota. Fungsi ini menginformasikan setiap tampilan yang dilampirkan ke dokumen, kecuali untuk tampilan yang ditentukan oleh pSender, bahwa dokumen telah dimodifikasi. Anda biasanya memanggil fungsi ini dari kelas tampilan Anda setelah pengguna mengubah dokumen melalui tampilan.

Fungsi ini memanggil CView::OnUpdate fungsi anggota untuk setiap tampilan dokumen kecuali tampilan pengiriman, passing pHint , dan lHint. Gunakan parameter ini untuk meneruskan informasi ke tampilan tentang modifikasi yang dilakukan pada dokumen. Anda dapat mengodekan informasi menggunakan lHint dan/atau Anda dapat menentukan CObjectkelas -turunan untuk menyimpan informasi tentang modifikasi dan meneruskan objek kelas tersebut menggunakan pHint. Ambil alih CView::OnUpdate fungsi anggota di kelas -turunan Anda CViewuntuk mengoptimalkan pembaruan tampilan tampilan berdasarkan informasi yang diteruskan.

Contoh

void CExampleDoc::OnUpdateAllViews()
{
   UpdateAllViews(NULL);
}

Lihat juga

Sampel MFC MDIDOCVW
Sampel MFC SNAPVW
Sampel MFC NPP
CCmdTarget Kelas
Bagan Hierarki
CCmdTarget Kelas
CView Kelas
CDocTemplate Kelas