共用方式為


CDocument 類別

對於使用者定義資料類別的基本功能。

class CDocument : public CCmdTarget

Members

y59b487w.collapse_all(zh-tw,VS.110).gif公用建構函式

名稱

描述

CDocument::CDocument

建構 CDocument 物件。

y59b487w.collapse_all(zh-tw,VS.110).gif公用方法

名稱

描述

CDocument::AddView

檢視附加至文件。

CDocument::BeginReadChunks

初始化大量讀取。

CDocument::CanCloseFrame

進階可覆寫;呼叫會在關閉檢視文件的框架視窗之前。

CDocument::ClearChunkList

清除大量清單。

CDocument::ClearPathName

清除清單巡覽文件物件。

CDocument::DeleteContents

呼叫執行文件的清除。

CDocument::FindChunk

搜尋具有指定之 GUID 的區塊。

CDocument::GetAdapter

會將指標 IDocument 物件實作介面。

CDocument::GetDocTemplate

會將指標傳至描述文件類型的文件樣板。

CDocument::GetFile

傳回指向 CFile 預期物件。

CDocument::GetFirstViewPosition

傳回第一個位置在檢視清單;用來開始反覆項目。

CDocument::GetNextView

藉由檢視逐一查看清單與文件相關聯的。

CDocument::GetPathName

傳回文件的資料檔案的路徑。

CDocument::GetThumbnail

呼叫以建立縮圖提供者所使用的點陣圖顯示縮圖。

CDocument::GetTitle

傳回文件的標題。

CDocument::InitializeSearchContent

呼叫以初始化搜尋處理常式的搜尋內容。

CDocument::IsModified

指示是否已修改文件,自上次儲存。

CDocument::IsSearchAndOrganizeHandler

告知 CDocument 物件執行個體是否為搜尋 _& 組織建立處理常式。

CDocument::LoadDocumentFromStream

呼叫方法來載入資料流的檔案資料。

CDocument::OnBeforeRichPreviewFontChanged

呼叫在豐富預覽字型之前變更。

CDocument::OnChangedViewList

呼叫,以檢視會從文件中移除。

CDocument::OnCloseDocument

呼叫關閉文件。

CDocument::OnCreatePreviewFrame

呼叫框架,當需要建立豐富預覽的預覽畫面。

CDocument::OnDocumentEvent

呼叫框架回應文件事件。

CDocument::OnDrawThumbnail

在衍生類別中覆寫這個方法會繪製縮圖內容。

CDocument::OnLoadDocumentFromStream

呼叫由架構,在需要從資料流載入文件資料。

CDocument::OnNewDocument

呼叫建立新文件。

CDocument::OnOpenDocument

透過呼叫來開啟現有的文件。

CDocument::OnPreviewHandlerQueryFocus

指示預覽處理常式會從呼叫 GetFocus 函式的 HWND。

CDocument::OnPreviewHandlerTranslateAccelerator

指示預覽處理常式會處理預覽處理常式執行中處理序的訊息幫浦 (Message Pump) 傳遞的按鍵。

CDocument::OnRichPreviewBackColorChanged

呼叫,以豐富預覽背景色彩就會變更。

CDocument::OnRichPreviewFontChanged

呼叫,以豐富預覽已經變更。

CDocument::OnRichPreviewSiteChanged

呼叫,以豐富預覽網站已變更。

CDocument::OnRichPreviewTextColorChanged

呼叫,以豐富預覽文字色彩變更。

CDocument::OnSaveDocument

呼叫將文件儲存至磁碟。

CDocument::OnUnloadHandler

呼叫框架,其在預覽處理常式卸載。

CDocument::PreCloseFrame

呼叫在框架視窗之前關閉。

CDocument::ReadNextChunkValue

讀取下一個區塊中的值。

CDocument::ReleaseFile

出現檔案以便讓其他應用程式使用。

CDocument::RemoveChunk

移除大量使用指定的 GUID。

CDocument::RemoveView

中斷連結文件的檢視。

CDocument::ReportSaveLoadException

進階可覆寫;呼叫,因為例外狀況,在開啟或儲存作業無法完成。

CDocument::SaveModified

進階可覆寫;呼叫詢問使用者是否要儲存文件。

CDocument::SetChunkValue

設定大量值。

CDocument::SetModifiedFlag

設定指定的旗標已修改文件,自上次儲存。

CDocument::SetPathName

設定文件所使用的資料檔案的路徑。

CDocument::SetTitle

設定這個文件的標題。

CDocument::UpdateAllViews

告知修改文件中的所有檢視。

y59b487w.collapse_all(zh-tw,VS.110).gif受保護的方法

名稱

描述

CDocument::OnFileSendMail

傳送附加了文件的郵件訊息。

CDocument::OnUpdateFileSendMail

如果郵件支援存在,啟用傳送郵件命令。

y59b487w.collapse_all(zh-tw,VS.110).gif公用資料成員

名稱

描述

CDocument::m_bGetThumbnailMode

指定 CDocument 物件由縮圖 dllhost 的建立。 應該由簽入 CView::OnDraw

CDocument::m_bPreviewHandlerMode

指定 CDocument 物件由 Rich Preview的 prevhost 建立。 應該由簽入 CView::OnDraw

CDocument::m_bSearchMode

指定 CDocument 物件由索引子或其他建立搜尋應用程式。

CDocument::m_clrRichPreviewBackColor

指定豐富預覽視窗的背景色彩。 這個色彩會由主應用程式設定。

CDocument::m_clrRichPreviewTextColor

指定豐富預覽視窗的前景色彩。 這個色彩會由主應用程式設定。

CDocument::m_lfRichPreviewFont

提供豐富預覽視窗指定文字的字型。 這個字型資訊由主應用程式設定。

備註

資料表示使用者通常會開啟 [開啟舊檔] 命令並儲存檔案儲存訂單資料的單位。

CDocument 支援標準作業,例如建立文件載入和儲存。 這個架構資料作業使用 CDocument定義的介面。

應用程式可以支援一種以上的一種類型的文件,例如,應用程式可能會支援報表和 Word 文件。 文件的每個型別都有相關聯的文件樣板;文件樣板指定哪些資源 (例如,功能表、圖示或快速鍵 (Accelerator) 對應表) 針對該資料型別使用。 每個文件含有指向其關聯的 CDocTemplate 物件。

使用者與資料互動是透過 CView 與其相關聯的物件。 檢視呈現文件的影像在框架視窗中並解譯為文件中的作業中的使用者輸入。 文件可以具有多個檢視相關聯的。 當使用者開啟文件的視窗時,架構會建立檢視並將其附加至文件。 文件樣板指定哪些檢視和框架視窗是用來顯示文件類型。

文件是架構的標準命令傳送的一部分而接收來自標準使用者介面元件的命令 (例如檔案儲存功能表項目)。 文件現用檢視表轉送的命令。 如果文件不處理該命令,則傳送命令給處理它的文件樣板。

在修改文件中的資料,其檢視中的每一個都必須以反映這些變更。 CDocument 提供 UpdateAllViews 成員函式通知檢視的這類變更,因此,檢視可以視需要重新自我繪製。 此架構也會提示使用者在關閉之前儲存已修改的檔案。

若要實作在典型的應用程式中的資料,您必須執行下列動作:

  • 從文件中的每個型別的 CDocument 衍生類別。

  • 加入成員變數以儲存每個文件的資料。

  • 實作讀取和修改文件的資料成員函式。 文件的檢視是這些成員函式的最重要的使用者。

  • 覆寫您的文件中類別的 CObject::Serialize 成員函式從磁碟讀取和寫入文件中的資料。

CDocument 透過電子郵件傳送支援您的文件中,如果郵件支援 (MAPI 存在)。 請參閱文章 MAPI在 MFC 的 MAPI 支援

如需 CDocument的資訊,請參閱 序列化文件/檢視架構主題文件/檢視建立

繼承階層架構

CObject

CCmdTarget

CDocument

需求

**標頭檔:**afxwin.h

請參閱

參考

CCmdTarget 類別

階層架構圖

CCmdTarget 類別

CView 類別

CDocTemplate 類別

概念

MFC MDIDOCVW 範例

MFC SNAPVW 範例

MFC NPP 範例