CDocument sınıfı

Makale
02/26/2013

Kullanıcı tanımlı belge sınıfları için temel işlevselliği sağlar.

class CDocument : public CCmdTarget

Üyeler

Ortak Oluşturucusu

Ad	Description
CDocument::CDocument	Yapıları bir CDocument nesnesi.

Public yöntemler

Ad	Description
CDocument::AddView	Bir görünüm belgeye ekler.
CDocument::BeginReadChunks	Başlatır okuma chunk.
CDocument::CanCloseFrame	Geçersiz kılınabilir Gelişmiş; Bu belge görüntüleme çerçeve penceresini kapatmadan önce denir.
CDocument::ClearChunkList	Öbek listesini temizler.
CDocument::ClearPathName	Belge nesnesinin yolunu temizler.
CDocument::DeleteContents	Belgenin temizleme gerçekleştirmek için çağrıldı.
CDocument::FindChunk	Belirtilen GUID'ye sahip bir öbek arar.
CDocument::GetAdapter	Nesneye uygulamak için bir işaretçi döndürür IDocument arabirimi.
CDocument::GetDocTemplate	Belge türünü açıklayan belge şablonu bir işaretçi döndürür.
CDocument::GetFile	İstenen bir işaretçi döndürür CFile nesnesi.
CDocument::GetFirstViewPosition	İlk konumunu verir; görünümler listesi Yineleme başlatmak için kullanılır.
CDocument::GetNextView	Belgeyle ilişkili görünümler listesi arasında dolaşır.
CDocument::GetPathName	Belgenin veri dosyasının yolunu döndürür.
CDocument::GetThumbnail	Minik resmini görüntülemek için minik resim sağlayıcı tarafından kullanılacak bir bitmap oluşturmak için çağrıldı.
CDocument::GetTitle	Belge başlığı döndürür.
CDocument::InitializeSearchContent	Arama içeriği arama işleyicisi başlatılamıyor denir.
CDocument::IsModified	En son kaydedilişinden sonra belgenin değiştirilmiş olduğunu gösterir.
CDocument::IsSearchAndOrganizeHandler	Söyler mi'nın bu örneğinin CDocument nesnesi için arama oluşturulduğu & İşleyici düzenler.
CDocument::LoadDocumentFromStream	Belge veri akışından yükleme olarak adlandırılır.
CDocument::OnBeforeRichPreviewFontChanged	Zengin Önizleme fontunu değiştirilmeden önce denir.
CDocument::OnChangedViewList	Bir görünüm için eklenen veya belgeden kaldırılır sonra denir.
CDocument::OnCloseDocument	Belgeyi kapatmak için çağrıldı.
CDocument::OnCreatePreviewFrame	Zengin Önizleme için bir önizleme çerçevesi oluşturmak gerektiğinde çerçevesi tarafından çağrıldı.
CDocument::OnDocumentEvent	Belge olayına yanıt olarak framework tarafından çağrıldı.
CDocument::OnDrawThumbnail	Minik resim içeriğini çizmek için türetilmiş bir sınıf içinde bu yöntem geçersiz kılar.
CDocument::OnLoadDocumentFromStream	Belge veri akışından yüklemek gerektiğinde çerçevesi tarafından çağrıldı.
CDocument::OnNewDocument	Yeni bir belge oluşturmak için çağrıldı.
CDocument::OnOpenDocument	Varolan bir belgeyi açmak için çağrıldı.
CDocument::OnPreviewHandlerQueryFocus	hwnd tıklatma işlevini çağırarak dönmek için Önizleme İşleyicisi yönlendirir.
CDocument::OnPreviewHandlerTranslateAccelerator	Önizleme İşleyicisi çalıştığı işlem mesaj pompasına ihtiyaç geçirilen bir tuş vuruşunun işlenmesi için Önizleme İşleyicisi yönlendirir.
CDocument::OnRichPreviewBackColorChanged	Zengin Önizleme arka plan rengine değiştiğinde denir.
CDocument::OnRichPreviewFontChanged	Zengin Önizleme yazı tipi değiştiğinde denir.
CDocument::OnRichPreviewSiteChanged	Zengin Önizleme sitesini değiştiğinde denir.
CDocument::OnRichPreviewTextColorChanged	Zengin Önizleme metin rengini değiştirdiğinizde denir.
CDocument::OnSaveDocument	Belgeyi diske kaydetmek için çağrıldı.
CDocument::OnUnloadHandler	Önizleme İşleyicisi kaldırıldı zaman çerçevesi tarafından çağrıldı.
CDocument::PreCloseFrame	Kare pencere kapatılmadan önce çağırılır.
CDocument::ReadNextChunkValue	Sonraki öbek değerini okur.
CDocument::ReleaseFile	Bir dosyayı başka bir uygulama tarafından kullanılmak üzere kullanılabilir yapmak için serbest bırakır.
CDocument::RemoveChunk	Belirtilen GUID'ye sahip bir öbek kaldırır.
CDocument::RemoveView	Belgeden bir görünüm çıkarır.
CDocument::ReportSaveLoadException	Geçersiz kılınabilir Gelişmiş; açık çaðrýldýðýnda ya da bir özel durum kayıt işlemi tamamlanamıyor.
CDocument::SaveModified	Geçersiz kılınabilir Gelişmiş; Kullanıcı belgeyi kaydedilmiş olup olmadığını sormak için çağrıldı.
CDocument::SetChunkValue	Yığında değer ayarlar.
CDocument::SetModifiedFlag	En son kaydedilişinden sonra belgeyi değiştirmiş olduğunuzu belirten bir bayrağı ayarlar.
CDocument::SetPathName	Belge tarafından kullanılan veri dosyasının yolunu ayarlar.
CDocument::SetTitle	Belgenin başlığını ayarlar.
CDocument::UpdateAllViews	Belgeyi tüm görünümlerde değiştirildi bildirir.

Korumalı yöntemleri

Ad	Description
CDocument::OnFileSendMail	İliştirilmiş bir belgesi olan bir posta iletisi gönderir.
CDocument::OnUpdateFileSendMail	Posta desteği varsa Posta Gönder komutunu etkinleştirir.

Ortak veri üyeleri

Ad	Description
CDocument::m_bGetThumbnailMode	Belirleyen bir CDocument nesne minik resimler için dllhost oluşturuldu. Denetlenmesi gereken CView::OnDraw.
CDocument::m_bPreviewHandlerMode	Belirleyen bir CDocument nesnenin oluşturulduğu için prevhost tarafından Rich Preview. Denetlenmesi gereken CView::OnDraw.
CDocument::m_bSearchMode	Belirleyen bir CDocument nesnesi dizin oluşturucu veya başka bir arama uygulaması tarafından oluşturuldu.
CDocument::m_clrRichPreviewBackColor	Zengin Önizleme penceresinin arka plan rengini belirtir. Bu rengi, ana bilgisayar tarafından ayarlanır.
CDocument::m_clrRichPreviewTextColor	Zengin Önizleme penceresi ön plan rengini belirtir. Bu rengi, ana bilgisayar tarafından ayarlanır.
CDocument::m_lfRichPreviewFont	Zengin Önizleme penceresi için metnin yazı tipini belirtir. Bu yazı tipi bilgileri ana bilgisayar tarafından ayarlanır.

Notlar

Bir belgenin kullanıcı genellikle Dosya Aç komutu ile açar ve dosyayı Kaydet komutuyla kaydeden veri birimini temsil eder.

CDocument bir belge oluşturma, yükleme ve kaydederek gibi standart işlemlerini destekler. Framework tarafından tanımlanan arabirimi kullanarak belgeleri işleyen CDocument.

Bir uygulamanın birden çok belge türünü destekler; Örneğin, bir uygulama elektronik tablo ve metin belgeleri desteklemiyor olabilir. Her belgenin türünü ilişkili belge şablonu vardır; hangi kaynaklara (örneğin, menü, simge veya Hızlandırıcı tablosu) bu tür bir belge için kullanılan belge şablonu belirtir. Her belge için onunla ilişkili bir işaretçi içerir CDocTemplate nesnesi.

Kullanıcılar bir belgeyi etkileşimde CView nesnesi ile ilişkilendirilmiş. Bir görünüm çerçeve penceresinde belge görüntüsünü çizer ve kullanıcı girişini belge üzerinde işlem olarak yorumlar. Bir belgenin kendisiyle ilişkilendirilmiş birden çok görünüm sağlayabilirsiniz. Kullanıcı bir belge penceresi açıldığında, çerçeve bir görünüm oluşturur ve belgeye ekler. Ne tür bir görünüm ve çerçeve penceresi her tür belgeyi görüntülemek için kullanılan belge şablonu belirtir.

Belgelerin standart framework'ün bir parçası olan komut Yönlendirme ve buna bağlı olarak standart kullanıcı arabirimi bileşenlerinin (örneğin, Dosya Kaydet menü öğesi) komutlarını almak. Bir belgeyi etkin görünüm tarafından iletilen komutları alır. Belgenin belirli bir komutu işleyemez, yönettiği belge şablonuna komut iletir.

Bir belgenin veri değiştirildiğinde, bu görünümlerin her birinden bu değişiklikleri yansıtması gerekir. CDocument sağlayan UpdateAllViews üye işlevi, bu tür değişiklikleri görünümlerini yeniden görünümleri kendilerini gerektiği gibi boyamak böylece bildirmek için. Çerçeve ayrıca değiştirilmiş dosyayı kapatmadan önce kaydetmek için kullanıcıya sorar.

Normal bir uygulama olarak belgelere uygulamak için aşağıdakileri yapmalısınız:

Bir sınıftan türer CDocument her belge türü için.
Her belgenin veri depolamak için üye değişken ekleyin.
Okuma ve belgenin veri değiştirmek için üye işlevlerini uygular. Belgenin en önemli kullanıcıları bu üye işlevlerin görünümlerdir.
Geçersiz kılma CObject::Serialize yazmak ve disk belgenin veriyi okumak için belge sınıfındaki üye işlevi.

CDocument posta desteği (MAPI) varsa, belgenizi mail üzerinden gönderilmesini destekler. Makalelere bakın MAPI ve mfc MAPI desteği.

Hakkında daha fazla bilgi için CDocument, bkz: seri hale getirme, Belge/View mimari konular, ve Belge/görünümü oluşturma.