Třída CDocument

Článek
03/04/2013

Poskytuje základní funkce pro třídy dokumentu definované uživatelem.

class CDocument : public CCmdTarget

Členy

Veřejné konstruktory

Název	Description
CDocument::CDocument	Konstrukce CDocument objektu.

Veřejné metody

Název	Description
CDocument::AddView	Zobrazení se připojí k dokumentu.
CDocument::BeginReadChunks	Inicializuje chunk čtení.
CDocument::CanCloseFrame	Rozšířené overridable; volána před zavřením okna rámeček zobrazení tohoto dokumentu.
CDocument::ClearChunkList	Vymaže seznam bloku.
CDocument::ClearPathName	Vymaže cestu objektu dokumentu.
CDocument::DeleteContents	Nazývá se provést vyčištění dokumentu.
CDocument::FindChunk	Vyhledá v bloku se zadaným identifikátorem GUID.
CDocument::GetAdapter	Vrací ukazatel na objekt provádění IDocument rozhraní.
CDocument::GetDocTemplate	Vrací ukazatel na šablonu dokumentu, který popisuje typ dokumentu.
CDocument::GetFile	Vrací ukazatel na požadované CFile objektu.
CDocument::GetFirstViewPosition	Vrátí první pozici v seznamu zobrazení; lze začít iterace.
CDocument::GetNextView	Projde seznam pohledů, které jsou přidružené k dokumentu.
CDocument::GetPathName	Vrátí cestu k souboru dat dokumentu.
CDocument::GetThumbnail	Nazývá rastrový obrázek miniatury zprostředkovatele používat zobrazit miniaturu vytvořit.
CDocument::GetTitle	Vrátí název dokumentu.
CDocument::InitializeSearchContent	Nazývá inicializace hledání popisovače obsahu hledání.
CDocument::IsModified	Označuje, zda byl dokument od posledního uložení změněn.
CDocument::IsSearchAndOrganizeHandler	Udává, zda tato instance CDocument objekt byl vytvořen pro hledání & Uspořádejte popisovač.
CDocument::LoadDocumentFromStream	Nazývá se načíst data dokumentu z datového proudu.
CDocument::OnBeforeRichPreviewFontChanged	Volána před změní písmo náhledu ve formátu RTF.
CDocument::OnChangedViewList	Volat po zobrazení je přidána nebo odebrána z dokumentu.
CDocument::OnCloseDocument	Nazývá dokument zavřete.
CDocument::OnCreatePreviewFrame	Rámci vyvolána při potřebuje k vytvoření rámečku náhled pro náhled formátu RTF.
CDocument::OnDocumentEvent	Volat rámec v odezvě na událost dokumentu.
CDocument::OnDrawThumbnail	Tato metoda v odvozené třídě kreslení obsahu miniaturu přepište.
CDocument::OnLoadDocumentFromStream	Rámci vyvolána při potřebuje načíst data dokumentu z datového proudu.
CDocument::OnNewDocument	Nazývá vytvoření nového dokumentu.
CDocument::OnOpenDocument	Nazývá otevřete existující dokument.
CDocument::OnPreviewHandlerQueryFocus	Přesměruje popisovač náhled HWND vrátit z volání funkce změnou na aktivní.
CDocument::OnPreviewHandlerTranslateAccelerator	Přesměruje popisovač náhled zpracování klávesový úhoz předány ze zprávy čerpadla procesu, ve kterém je spuštěna rutina náhledu souborů.
CDocument::OnRichPreviewBackColorChanged	Jen při změně barvy pozadí náhledu RTF.
CDocument::OnRichPreviewFontChanged	Nazývá se při změně formátu RTF náhled písma.
CDocument::OnRichPreviewSiteChanged	Nazývá se při změně formátu RTF náhled webu.
CDocument::OnRichPreviewTextColorChanged	Nazývá se při změně barvy textu formátovaného náhled.
CDocument::OnSaveDocument	Nazývá se dokument uložit na disk.
CDocument::OnUnloadHandler	Rámci vyvolána při uvolňování obslužná rutina náhledu.
CDocument::PreCloseFrame	Volána před zavřením okna rámce.
CDocument::ReadNextChunkValue	Přečte další hodnotu bloku.
CDocument::ReleaseFile	Vydání souboru, aby byla k dispozici pro použití jinými aplikacemi.
CDocument::RemoveChunk	Odebere shluk se zadaným identifikátorem GUID.
CDocument::RemoveView	Odpojí zobrazení dokumentu.
CDocument::ReportSaveLoadException	Rozšířené overridable; nazývá se při otevření nebo uložení operaci nelze dokončit z důvodu výjimky.
CDocument::SaveModified	Rozšířené overridable; nazývá požádat uživatele, zda se dokument uložit.
CDocument::SetChunkValue	Nastaví hodnotu bloku.
CDocument::SetModifiedFlag	Nastaví příznak označující, že jste změnili dokument od posledního uložení.
CDocument::SetPathName	Nastaví cestu k souboru dat používaných v dokumentu.
CDocument::SetTitle	Nastaví název dokumentu.
CDocument::UpdateAllViews	Upozorní všechny pohledy, které dokument byl změněn.

Chráněné metody

Název	Description
CDocument::OnFileSendMail	Odešle zprávu elektronické pošty s připojeným dokumentem.
CDocument::OnUpdateFileSendMail	Umožňuje odesílání pošty, pokud je k dispozici podpora pošty.

Veřejné datové členy

Název	Description
CDocument::m_bGetThumbnailMode	Určuje, že CDocument objekt byl vytvořen dllhost miniatur.Je třeba kontrolovat na CView::OnDraw .
CDocument::m_bPreviewHandlerMode	Určuje, že CDocument objekt byl vytvořen pro prevhost Rich Preview .Je třeba kontrolovat na CView::OnDraw .
CDocument::m_bSearchMode	Určuje, že CDocument objekt byl vytvořen indexer nebo jiné aplikace pro vyhledávání.
CDocument::m_clrRichPreviewBackColor	Určuje barvu pozadí náhledu ve formátu RTF.Tato barva je nastavena jako hostitele.
CDocument::m_clrRichPreviewTextColor	Určuje barvu popředí okna Náhled formátu RTF.Tato barva je nastavena jako hostitele.
CDocument::m_lfRichPreviewFont	Určuje písmo textu RTF náhled okna.Informace tohoto písma je nastavena jako hostitele.

Poznámky

Dokument představuje jednotku dat uživatele obvykle pomocí příkazu Otevřít soubor se otevře a uloží pomocí příkazu Uložit soubor.

CDocument podporuje standardní operace, například vytvoření dokumentu, jeho načítání a jeho uložení.Rámci zpracovává dokumenty pomocí rozhraní definované CDocument.

Aplikace podporuje více než jeden typ dokumentu. aplikace může například podporovat tabulek a textových dokumentů.Každý typ dokumentu má šablonu související dokument; Šablona dokumentu určuje, jaké prostředky (například tabulka nabídky, ikony nebo akcelerátor) jsou použity pro daný typ dokumentu.Každý dokument obsahuje ukazatel na jeho přidružený CDocTemplate objektu.

Uživatelé interaktivně pracovat s dokumentem až CView s ním spojené objekty.Vykreslí obraz dokumentu v rámci okna zobrazení a vstup uživatele jako operace v dokumentu.Dokument může obsahovat více zobrazení přidruženy.Při otevření okna dokumentu v rámci vytvoří zobrazení a připojí k dokumentu.Šablona dokumentu určuje, jaký typ zobrazení a rámeček okna slouží k zobrazení každého typu dokumentu.

Dokumenty jsou součástí rámci standardní příkaz Směrování a následně ze standardního uživatelského rozhraní komponenty (například soubor uložit položku nabídky) přijímat příkazy.Dokument obdrží příkazy předané aktivní zobrazení.Pokud dokument nemá popisovač daný příkaz, předává příkaz šablony dokumentu, který spravuje ji.

Při změně dat dokumentu každé jeho zobrazení musí odrážet tyto úpravy.CDocument poskytuje UpdateAllViews členské funkce můžete upozornit zobrazení takových změn, takže zobrazení lze překreslit sami podle potřeby.Rámci také výzvu před zavřením uložit upravený soubor.

Implementace dokumenty v typické aplikace, musíte provést následující:

Odvození třídy z CDocument pro každý typ dokumentu.
Přidáte členské proměnné pro uložení dat každého dokumentu.
Implementujte funkce členů pro čtení a změny dat dokumentu.Zobrazení dokumentu jsou nejdůležitější uživatelé tyto funkce členů.
Přepsat CObject::Serialize členské funkce ve své třídě dokumentu na zápis a čtení dat dokumentu a z disku.

CDocument podporuje odesílání dokumentu prostřednictvím pošty, pokud je k dispozici podpora pošty (MAPI).Naleznete v článcích rozhraní MAPI a Podpora MAPI v MFC.

Další informace o CDocument, viz serializace, Dokumentu zobrazit témata architektura, a Vytvoření dokumentu nebo zobrazení.