COleDocObjectItem Sınıfı

Etkin belge kapsaması uygular.

Sözdizimi

class COleDocObjectItem : public COleClientItem

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
COleDocObjectItem::COleDocObjectItem	Bir COleDocObject öğe oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
COleDocObjectItem::D oDefaultPrinting	Varsayılan yazıcı ayarlarını kullanarak kapsayıcı uygulamasının belgesini yazdırır.
COleDocObjectItem::ExecCommand	Kullanıcı tarafından belirtilen komutu yürütür.
COleDocObjectItem::GetActiveView	Belgenin etkin görünümünü alır.
COleDocObjectItem::GetPageCount	Kapsayıcı uygulamasının belgesindeki sayfa sayısını alır.
COleDocObjectItem::OnPreparePrinting	Kapsayıcı uygulamasının belgesini yazdırmaya hazırlar.
COleDocObjectItem::OnPrint	Kapsayıcı uygulamasının belgesini yazdırır.
COleDocObjectItem::QueryCommand	Kullanıcı arabirimi olayları tarafından oluşturulan bir veya daha fazla komutun durumunu sorgular.
COleDocObjectItem::Release	OLE bağlantılı bir öğeye bağlantıyı serbest bırakır ve açıksa kapatır. İstemci öğesini yok etmez.

Açıklamalar

MFC'de, Etkin bir belge aşağıdaki farklarla normal, yerinde düzenlenebilir bir eklemeye benzer şekilde işlenir:

• COleDocument-derived sınıfı halen eklenmiş olan öğelerin listesini tutar; ancak bu öğeler türetilmiş öğeler olabilirCOleDocObjectItem.

• Etkin bir belge etkin olduğunda, yerinde etkin olduğunda görünümün tüm istemci alanını kaplar.

• Etkin belge kapsayıcısı, Yardım menüsünün tam denetimine sahiptir.

• Yardım menüsünde hem Etkin belge kapsayıcısı hem de sunucusu için menü öğeleri bulunur.

Etkin belge kapsayıcısı Yardım menüsüne sahip olduğundan, sunucu Yardım menüsü iletilerini sunucuya iletmek kapsayıcının sorumluluğundadır. Bu tümleştirme tarafından COleDocObjectItemişlenir.

Menü birleştirme ve Etkin belge etkinleştirme hakkında daha fazla bilgi için bkz. Etkin Belge Kapsamaya Genel Bakış.

Devralma Hiyerarşisi

CObject

CCmdTarget

CDocItem

COleClientItem

COleDocObjectItem

Gereksinimler

Üst bilgi: afxole.h

COleDocObjectItem::COleDocObjectItem

Nesneyi başlatmak için bu üye işlevini çağırın COleDocObjectItem .

COleDocObjectItem(COleDocument* pContainerDoc = NULL);

Parametreler

pContainerDoc
Etkin belge kapsayıcısı COleDocument olarak davranan nesnenin işaretçisi. IMPLEMENT_SERIALIZE etkinleştirmek için bu parametre NULL olmalıdır. Normalde OLE öğeleri NULL olmayan bir belge işaretçisiyle oluşturulur.

COleDocObjectItem::D oDefaultPrinting

Çerçeve tarafından varsayılan ayarları kullanarak bir belgeye çağrılır.

static HRESULT DoDefaultPrinting(
    CView* pCaller,
    CPrintInfo* pInfo);

Parametreler

pCaller
Yazdırma komutunu gönderen bir CView nesnesinin işaretçisi.

pInfo
Yazdırılacak işi açıklayan bir CPrintInfo nesnesi işaretçisi.

COleDocObjectItem::ExecCommand

Kullanıcı tarafından belirtilen komutu yürütmek için bu üye işlevini çağırın.

HRESULT ExecCommand(
    DWORD nCmdID,
    DWORD nCmdExecOpt = OLECMDEXECOPT_DONTPROMPTUSER,
    const GUID* pguidCmdGroup = NULL);

Parametreler

nCmdID
Yürütülecek komutun tanımlayıcısı. pguidCmdGroup tarafından tanımlanan grupta olmalıdır.

nCmdExecOpt
Komut yürütme seçeneklerini belirtir. Varsayılan olarak, kullanıcıya sormadan komutunu yürütecek şekilde ayarlayın. Değerlerin listesi için bkz . OLECMDEXECOPT .

pguidCmdGroup
Komut grubunun benzersiz tanımlayıcısı. Varsayılan olarak, standart grubu belirten NULL değeridir. nCmdID ile geçirilen komut gruba ait olmalıdır.

Dönüş Değeri

Başarılı olursa S_OK döndürür; aksi takdirde, aşağıdaki hata kodlarından birini döndürür.

Value	Açıklama
E_UNEXPECTED	Beklenmeyen bir hata oluştu.
E_FAIL	Hata oluştu.
E_NOTIMPL	MFC'nin komutunu çevirmeye ve göndermeye çalışması gerektiğini gösterir.
OLECMDERR_E_UNKNOWNGROUP	pguidCmdGroup NULL değil, ancak tanınan bir komut grubu belirtmez.
OLECMDERR_E_NOTSUPPORTED	nCmdID , pGroup grubunda geçerli bir komut olarak tanınmıyor.
OLECMDERR_DISABLED	nCmdID tarafından tanımlanan komut devre dışı bırakıldı ve yürütülemiyor.
OLECMDERR_NOHELP	Çağıran, nCmdID tarafından tanımlanan komutla ilgili yardım istedi, ancak yardım yok.
OLECMDERR_CANCELLED	Kullanıcı yürütmeyi iptal etti.

Açıklamalar

pguidCmdGroup ve nCmdID parametreleri birlikte çağrılacak komutu benzersiz olarak tanımlar. nCmdExecOpt parametresi, gerçekleştirilmesi gereken eylemi belirtir.

COleDocObjectItem::GetActiveView

Şu anda etkin olan görünümün IOleDocumentView arabirimine bir işaretçi almak için bu üye işlevini çağırın.

LPOLEDOCUMENTVIEW GetActiveView() const;

Dönüş Değeri

Şu anda etkin olan görünümün IOleDocumentView arabirimine bir işaretçi. Geçerli görünüm yoksa NULL döndürür.

Açıklamalar

Döndürülen IOleDocumentView işaretçideki başvuru sayısı, bu işlev tarafından döndürülmeden önce artırılmaz.

COleDocObjectItem::GetPageCount

Belgedeki sayfa sayısını almak için bu üye işlevini çağırın.

BOOL GetPageCount(
    LPLONG pnFirstPage,
    LPLONG pcPages);

Parametreler

pnFirstPage
Belgenin ilk sayfasının numarasının işaretçisi. Çağıranın bu numaraya ihtiyacı olmadığını gösteren NULL olabilir.

pcPages
Belgedeki toplam sayfa sayısına ilişkin bir işaretçi. Çağıranın bu numaraya ihtiyacı olmadığını gösteren NULL olabilir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

COleDocObjectItem::OnPreparePrinting

Bu üye işlevi, belgeyi yazdırmaya hazırlamak için çerçeve tarafından çağrılır.

static BOOL OnPreparePrinting(
    CView* pCaller,
    CPrintInfo* pInfo,
    BOOL bPrintAll = TRUE);

Parametreler

pCaller
Yazdırma komutunu gönderen bir CView nesnesinin işaretçisi.

pInfo
Yazdırılacak işi açıklayan bir CPrintInfo nesnesi işaretçisi.

bPrintAll
Belgenin tamamının yazdırılıp yazdırılmayacağını belirtir.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

COleDocObjectItem::OnPrint

Bu üye işlevi, belgeyi yazdırmak için çerçeve tarafından çağrılır.

static void OnPrint(
    CView* pCaller,
    CPrintInfo* pInfo,
    BOOL bPrintAll = TRUE);

Parametreler

pCaller
Yazdırma komutunu gönderen bir CView nesnesinin işaretçisi.

pInfo
Yazdırılacak işi açıklayan bir CPrintInfo nesnesi işaretçisi.

bPrintAll
Belgenin tamamının yazdırılıp yazdırılmayacağını belirtir.

COleDocObjectItem::QueryCommand

Kullanıcı arabirimi olayları tarafından oluşturulan bir veya daha fazla komutun durumunu sorgular.

HRESULT QueryCommand(
    ULONG nCmdID,
    DWORD* pdwStatus,
    OLECMDTEXT* pCmdText =NULL,
    const GUID* pguidCmdGroup =NULL);

Parametreler

nCmdID
sorgulanan komutun tanımlayıcısı.

pdwStatus
Sorgunun sonucu olarak döndürülen bayrakların işaretçisi. Olası değerlerin listesi için bkz . OLECMDF.

pCmdText
Tek bir komut için ad ve durum bilgilerinin döndürüleceği OLECMDTEXT yapısının işaretçisi. Çağıranın bu bilgilere ihtiyacı olmadığını belirtmek için NULL olabilir.

pguidCmdGroup
Komut grubunun benzersiz tanımlayıcısı; standart grubu belirtmek için NULL olabilir.

Dönüş Değeri

Dönüş değerlerinin tam listesi için bkz . Windows SDK'sında IOleCommandTarget::QueryStatus .

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi IOleCommandTarget::QueryStatus yönteminin işlevselliğini öykünmektedir.

COleDocObjectItem::Release

OLE bağlantılı bir öğeye bağlantıyı serbest bırakır ve açıksa kapatır. İstemci öğesini yok etmez.

virtual void Release(OLECLOSE dwCloseOption = OLECLOSE_NOSAVE);

Parametreler

dwCloseOption
Ole öğesinin yüklenen duruma geri döndüğünde hangi koşullarda kaydedileceğini belirten bayrak. Olası değerlerin listesi için bkz . COleClientItem::Close.

Açıklamalar

İstemci öğesini yok etmez.

Ayrıca bkz.

MFC Örnek MFCBIND
COleClientItem Sınıfı
Hiyerarşi Grafiği
COleClientItem Sınıfı
CDocObjectServerItem Sınıfı