CDocument 類別

發行項
02/28/2013

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

class CDocument : public CCmdTarget

Members

公用建構函式

名稱	描述
CDocument::CDocument	建構 CDocument 物件。

公用方法

名稱	描述
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	告知修改文件中的所有檢視。

受保護的方法

名稱	描述
CDocument::OnFileSendMail	傳送附加了文件的郵件訊息。
CDocument::OnUpdateFileSendMail	如果郵件支援存在，啟用傳送郵件命令。

公用資料成員

名稱	描述
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 成員函式通知檢視的這類變更，因此，檢視可以視需要重新自我繪製。此架構也會提示使用者在關閉之前儲存已修改的檔案。

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