Klasa CDocument

Artykuł
02/27/2013

Zapewnia podstawowe funkcje dla klas zdefiniowanych przez użytkownika dokumentu.

class CDocument : public CCmdTarget

Członkowie

Publiczne konstruktory

Nazwa	Opis
CDocument::CDocument	Konstrukcje CDocument obiektu.

Metody publiczne

Nazwa	Opis
CDocument::AddView	Dołącza widoku dokumentu.
CDocument::BeginReadChunks	Inicjuje w bryłkach czytania.
CDocument::CanCloseFrame	Zaawansowane NotOverridable; wywoływane przed zamknięciem okna ramki, wyświetlanie tego dokumentu.
CDocument::ClearChunkList	Czyści listę fragmentu.
CDocument::ClearPathName	Czyści ścieżkę obiektu dokumentu.
CDocument::DeleteContents	Wywołana, aby wykonać oczyszczanie dokumentu.
CDocument::FindChunk	Szuka fragmentów z określonym identyfikatorem GUID.
CDocument::GetAdapter	Zwraca wskaźnik do obiektu wykonawczych IDocument interfejsu.
CDocument::GetDocTemplate	Zwraca wskaźnik do szablonu dokumentu, który opisuje typ dokumentu.
CDocument::GetFile	Zwraca wskaźnik do żądanego CFile obiektu.
CDocument::GetFirstViewPosition	Zwraca pozycję pierwsze na liście widoków; można rozpocząć iteracji.
CDocument::GetNextView	Iteracja listy widoków skojarzonych z dokumentu.
CDocument::GetPathName	Zwraca ścieżkę pliku danych do dokumentu.
CDocument::GetThumbnail	Wywołana bitmapy, aby być używane przez dostawcę miniatury, aby wyświetlić miniaturę.
CDocument::GetTitle	Zwraca tytuł dokumentu.
CDocument::InitializeSearchContent	Nazywane zainicjować wyszukiwania zawartości w celu obsługi wyszukiwania.
CDocument::IsModified	Wskazuje, czy dokument został zmieniony od ostatniego zapisu.
CDocument::IsSearchAndOrganizeHandler	Informuje, czy to wystąpienie CDocument obiekt został utworzony dla wyszukiwania & Organizowanie obsługi.
CDocument::LoadDocumentFromStream	Nazywane załadować ze strumienia danych dokumentu.
CDocument::OnBeforeRichPreviewFontChanged	Wywołana przed zmianą Rich Podgląd czcionki.
CDocument::OnChangedViewList	Wywoływana po widoku jest dodane lub usunięte z dokumentu.
CDocument::OnCloseDocument	Wywołana, aby zamknąć dokument.
CDocument::OnCreatePreviewFrame	Nazywane ramy podczas potrzebuje utworzyć ramkę Podgląd Rich podglądu.
CDocument::OnDocumentEvent	Wywołana przez ramy w odpowiedzi na zdarzenie dokumentu.
CDocument::OnDrawThumbnail	Zastąpienie tej metody w klasie pochodnej rysowanie zawartości miniaturę.
CDocument::OnLoadDocumentFromStream	Wywoływane w ramach, gdy konieczne jest załadowanie danych dokumentu ze strumienia.
CDocument::OnNewDocument	Wywołana, aby utworzyć nowy dokument.
CDocument::OnOpenDocument	Wywoływana Otwórz istniejący dokument.
CDocument::OnPreviewHandlerQueryFocus	Kieruje obsługi podglądu zwrócić HWND wywołanie funkcji przy uzyskaniu fokusu.
CDocument::OnPreviewHandlerTranslateAccelerator	Kieruje obsługi podglądu obsługi klawiszy, przekazywane wiadomości pompy procesu, w którym uruchomiony jest program obsługi podglądu.
CDocument::OnRichPreviewBackColorChanged	Wywołana po zmianie koloru tła podglądu RTF.
CDocument::OnRichPreviewFontChanged	Wywołana po zmianie Rich Podgląd czcionki.
CDocument::OnRichPreviewSiteChanged	Wywołana po zmianie Rich podglądu witryny.
CDocument::OnRichPreviewTextColorChanged	Wywołana po zmianie koloru tekstu sformatowanego podglądu.
CDocument::OnSaveDocument	Wywołana, aby zapisać dokument na dysku.
CDocument::OnUnloadHandler	Wywołana w ramach podczas wyładowywania obsługi podglądu.
CDocument::PreCloseFrame	Wywołana przed zamknięciem okna ramki.
CDocument::ReadNextChunkValue	Odczytuje wartość następnego fragmentu.
CDocument::ReleaseFile	Zwalnia pliku, aby był dostępny do użytku przez inne aplikacje.
CDocument::RemoveChunk	Usuwa fragmentu z określonym identyfikatorem GUID.
CDocument::RemoveView	Odłącza widoku z dokumentu.
CDocument::ReportSaveLoadException	Zaawansowane NotOverridable; wywoływany, gdy otwarty lub operacja zapisywania nie można ukończyć z powodu wyjątku.
CDocument::SaveModified	Zaawansowane NotOverridable; wywoływana poproś użytkownika, czy zapisać dokumentu.
CDocument::SetChunkValue	Ustawia wartość fragmentu.
CDocument::SetModifiedFlag	Ustawia flagę wskazującą, że dokumentu zostały zmodyfikowane od ostatniego zapisu.
CDocument::SetPathName	Ustawia ścieżkę pliku danych używanego w dokumencie.
CDocument::SetTitle	Ustawia tytuł dokumentu.
CDocument::UpdateAllViews	Powiadamia wszystkie widoki, które dokument został zmodyfikowany.

Metody chronione

Nazwa	Opis
CDocument::OnFileSendMail	Wysyła wiadomość z dołączonym dokumentem.
CDocument::OnUpdateFileSendMail	Jeśli obsługa poczty jest obecny, umożliwia polecenia Wyślij pocztę.

Publiczne danych członków

Nazwa	Opis
CDocument::m_bGetThumbnailMode	Określa, że CDocument obiekt został utworzony przez dllhost miniatur.Należy sprawdzić CView::OnDraw.
CDocument::m_bPreviewHandlerMode	Określa, że CDocument obiekt został utworzony przez prevhost dla Rich Preview.Należy sprawdzić CView::OnDraw.
CDocument::m_bSearchMode	Określa, że CDocument obiekt został utworzony przez indeksatora lub innych aplikacji wyszukiwania.
CDocument::m_clrRichPreviewBackColor	Określa kolor tła okna Podgląd RTF.Ten kolor jest ustawiany przez hosta.
CDocument::m_clrRichPreviewTextColor	Określa kolor pierwszego planu okna Podgląd RTF.Ten kolor jest ustawiany przez hosta.
CDocument::m_lfRichPreviewFont	Określa czcionkę tekstu sformatowanego podglądu okna.Informacje te czcionki jest ustawiany przez hosta.

Uwagi

Dokument reprezentuje jednostkę danych, które użytkownik zazwyczaj zostanie otwarty za pomocą polecenia Otwórz plik i zapisuje za pomocą polecenia Zapisz plik.

CDocument obsługuje standardowych operacji tworzenia dokumentu, załadowywanie i zapisywania go.Ramy manipuluje dokumentów przy użyciu interfejsu zdefiniowane przez CDocument.

Aplikacja może obsługiwać więcej niż jeden typ dokumentu; na przykład aplikacja może obsługiwać dokumentów tekstowych i arkuszy kalkulacyjnych.Każdy typ dokumentu ma szablonu skojarzonego dokumentu; Szablon dokumentu określa, jakie zasoby (na przykład tabela menu, ikon lub accelerator) są używane dla tego typu dokumentu.Każdy dokument zawiera wskaźnik do jego skojarzony CDocTemplate obiektu.

Interakcji użytkowników z dokumentu poprzez CView skojarzony z nim obiekty.Widok renderuje obrazu dokumentu w oknie ramki i interpretuje dane wejściowe użytkownika jako operacje w dokumencie.Dokument może posiadać wiele widoków skojarzonych z nim.Gdy użytkownik otwiera okno dokumentu, ramy tworzy widok i dołącza go do dokumentu.Szablon dokumentu określa, jaki typ okna widoku i ramki są używane do wyświetlania każdego typu dokumentu.

Dokumenty są częścią ram standardowe polecenia routingu i w konsekwencji otrzymywać poleceń standardowy interfejs użytkownika składniki (element menu Zapisz plik).Dokument odbiera przekazywane przez widoku aktywnego polecenia.Dokument nie obsługuje danego polecenia, przesyła dalej polecenia do szablonu dokumentu, który zarządza go.

Podczas modyfikacji danych dokumentu każdej jego widoków musi odzwierciedlać te zmiany.CDocument zawiera UpdateAllViews Członkowskich funkcji można powiadomić widoki takich zmian, więc widoków można sobie odświeżenia jako niezbędne.Ramy również monituje użytkownika, aby zapisać zmodyfikowany plik przed jego zamknięciem.

Aby zaimplementować dokumentów w typowych aplikacji, wykonaj następujące czynności:

Pochodzić od klasy CDocument dla każdego typu dokumentu.
Dodawanie zmiennych do przechowywania danych każdego dokumentu.
Wdrożenie funkcji elementów członkowskich do czytania i modyfikowania danych dokumentu.Widoki dokumentu są najważniejsze użytkowników tych funkcji elementów członkowskich.
Zastąpić CObject::Serialize Członkowskich funkcji w klasie dokumentu do zapisywania i odczytywania danych z dokumentu i z dysku.

CDocument obsługuje wysyłanie dokumentu pocztą, jeśli jest obecny obsługi poczty (MAPI).Zobacz artykuły MAPI i Obsługa MAPI w MFC.

Aby uzyskać więcej informacji na CDocument, zobacz serializacji, /Widok dokumentu architektury tematy, i Tworzenia widokudokumentu/.