COleDocObjectItem osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Aktív dokumentum-elszigetelés implementálása.

Szemantika

class COleDocObjectItem : public COleClientItem

Tagok

Nyilvános konstruktorok

Név	Description
COleDocObjectItem::COleDocObjectItem	COleDocObject Elem létrehozása.

Nyilvános metódusok

Név	Description
COleDocObjectItem::D oDefaultPrinting	A tárolóalkalmazás dokumentumát az alapértelmezett nyomtatóbeállítások használatával nyomtatja ki.
COleDocObjectItem::ExecCommand	Végrehajtja a felhasználó által megadott parancsot.
COleDocObjectItem::GetActiveView	Lekéri a dokumentum aktív nézetét.
COleDocObjectItem::GetPageCount	Lekéri a tárolóalkalmazás dokumentumában lévő lapok számát.
COleDocObjectItem::OnPreparePrinting	Előkészíti a tárolóalkalmazás dokumentumát nyomtatásra.
COleDocObjectItem::OnPrint	Kinyomtatja a tárolóalkalmazás dokumentumát.
COleDocObjectItem::QueryCommand	A felhasználói felület eseményei által létrehozott egy vagy több parancs állapotának lekérdezése.
COleDocObjectItem::Release	Felszabadítja a kapcsolatot egy OLE csatolt elemhez, és bezárja, ha nyitva volt. Nem pusztítja el az ügyfélelemet.

Megjegyzések

Az MFC-ben az aktív dokumentumokat a szokásos, helyben szerkeszthető beágyazásokhoz hasonlóan kezeli a következő különbségekkel:

• A COleDocument-derived osztály továbbra is megőrzi a jelenleg beágyazott elemek listáját, azonban ezek az elemek lehetnek COleDocObjectItem-származtatott elemek.

• Ha egy aktív dokumentum aktív, akkor a nézet teljes ügyfélterületét elfoglalja, amikor aktív a helyén.

• Az Aktív dokumentumtárolók teljes mértékben szabályozva vannak a Súgó menüben.

• A Súgó menü az Aktív dokumentumtároló és a kiszolgáló menüelemeit tartalmazza.

Mivel az Aktív dokumentum tárolója a Súgó menü tulajdonosa, a tároló feladata a kiszolgáló súgómenüüzeneteinek továbbítása a kiszolgálóra. Ezt az integrációt a következő kezeli COleDocObjectItem: .

A menüegyesítéssel és az aktív dokumentum aktiválásával kapcsolatos további információkért tekintse meg az Aktív dokumentumtár áttekintése című témakört.

Öröklési hierarchia

CObject

CCmdTarget

CDocItem

COleClientItem

COleDocObjectItem

Requirements

Fejléc: afxole.h

COleDocObjectItem::COleDocObjectItem

Hívja meg ezt a tagfüggvényt az objektum inicializálásához COleDocObjectItem .

COleDocObjectItem(COleDocument* pContainerDoc = NULL);

Paraméterek

pContainerDoc
Az aktív dokumentumtárolóként működő objektumra mutató mutató COleDocument . Ennek a paraméternek NULL értékűnek kell lennie a IMPLEMENT_SERIALIZE engedélyezéséhez. Az OLE-elemek általában nem NULL értékű dokumentummutatóval vannak létrehozva.

COleDocObjectItem::D oDefaultPrinting

A keretrendszer meghívja egy dokumentumra az alapértelmezett beállításokat használva.

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

Paraméterek

pCaller
A nyomtatási parancsot küldő CView-objektumra mutató mutató.

pInfo
A nyomtatandó feladatot leíró CPrintInfo-objektumra mutató mutató.

COleDocObjectItem::ExecCommand

Hívja meg ezt a tagfüggvényt a felhasználó által megadott parancs végrehajtásához.

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

Paraméterek

nCmdID
A végrehajtandó parancs azonosítója. A pguidCmdGroup által azonosított csoportban kell lennie.

nCmdExecOpt
Parancsvégrehajtási beállításokat ad meg. Alapértelmezés szerint úgy állítsa be, hogy a felhasználó kérése nélkül hajtsa végre a parancsot. Az értékek listáját lásd: OLECMDEXECOPT .

pguidCmdGroup
A parancscsoport egyedi azonosítója. Alapértelmezés szerint NULL, amely a standard csoportot adja meg. Az nCmdID-ben átadott parancsnak a csoporthoz kell tartoznia.

Visszaadott érték

Sikeres S_OK ad vissza; ellenkező esetben a következő hibakódok egyikét adja vissza.

Érték	Description
E_UNEXPECTED	Váratlan hiba történt.
E_FAIL	Hiba történt.
E_NOTIMPL	Azt jelzi, hogy az MFC-nek meg kell kísérelnie lefordítani és elküldeni a parancsot.
OLECMDERR_E_UNKNOWNGROUP	A pguidCmdGroup nem NULL értékű, de nem ad meg felismert parancscsoportot.
OLECMDERR_E_NOTSUPPORTED	Az nCmdID nem ismerhető fel érvényes parancsként a pGroup csoportban.
OLECMDERR_DISABLED	Az nCmdID által azonosított parancs le van tiltva, és nem hajtható végre.
OLECMDERR_NOHELP	A hívó segítséget kért az nCmdID által azonosított parancshoz, de nem áll rendelkezésre súgó.
OLECMDERR_CANCELLED	A felhasználó megszakította a végrehajtást.

Megjegyzések

A pguidCmdGroup és az nCmdID paraméterek együttesen egyedileg azonosítják a meghívandó parancsot. Az nCmdExecOpt paraméter pontosan meghatározza a végrehajtandó műveletet.

COleDocObjectItem::GetActiveView

Hívja meg ezt a tagfüggvényt, hogy az aktuálisan aktív nézet felületére mutató mutatót IOleDocumentView kapjon.

LPOLEDOCUMENTVIEW GetActiveView() const;

Visszaadott érték

Az aktuálisan aktív nézet IOleDocumentView felületére mutató mutató. Ha nincs aktuális nézet, null értéket ad vissza.

Megjegyzések

A visszaadott IOleDocumentView mutató hivatkozási száma nem növekszik, mielőtt a függvény visszaadja.

COleDocObjectItem::GetPageCount

Hívja meg ezt a tagfüggvényt a dokumentum oldalainak számának lekéréséhez.

BOOL GetPageCount(
    LPLONG pnFirstPage,
    LPLONG pcPages);

Paraméterek

pnFirstPage
Mutató a dokumentum első oldalának számára. Null értékű lehet, ami azt jelzi, hogy a hívónak nincs szüksége erre a számra.

pcPages
Mutató a dokumentum oldalainak teljes számára. Null értékű lehet, ami azt jelzi, hogy a hívónak nincs szüksége erre a számra.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

COleDocObjectItem::OnPreparePrinting

Ezt a tagfüggvényt a keretrendszer meghívja egy dokumentum nyomtatásra való előkészítéséhez.

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

Paraméterek

pCaller
A nyomtatási parancsot küldő CView-objektumra mutató mutató.

pInfo
A nyomtatandó feladatot leíró CPrintInfo-objektumra mutató mutató.

bPrintAll
Megadja, hogy a teljes dokumentumot ki kell-e nyomtatni.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

COleDocObjectItem::OnPrint

Ezt a tagfüggvényt a keretrendszer meghívja egy dokumentum nyomtatásához.

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

Paraméterek

pCaller
A nyomtatási parancsot küldő CView-objektumra mutató mutató.

pInfo
A nyomtatandó feladatot leíró CPrintInfo-objektumra mutató mutató.

bPrintAll
Megadja, hogy a teljes dokumentumot ki kell-e nyomtatni.

COleDocObjectItem::QueryCommand

A felhasználói felület eseményei által létrehozott egy vagy több parancs állapotának lekérdezése.

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

Paraméterek

nCmdID
a lekérdezett parancs azonosítója.

pdwStatus
A lekérdezés eredményeként visszaadott jelzőkre mutató mutató. A lehetséges értékek listáját az OLECMDF-ben találja.

pCmdText
Mutasson egy OLECMDTEXT-struktúrára , amelyben egyetlen parancs nevét és állapotadatait adja vissza. Null értékű lehet, ha azt jelzi, hogy a hívónak nincs szüksége ezekre az információkra.

pguidCmdGroup
A parancscsoport egyedi azonosítója; A standard csoport megadása null értékű lehet.

Visszaadott érték

A visszatérési értékek teljes listáját lásd: IOleCommandTarget::QueryStatus a Windows SDK-ban.

Megjegyzések

Ez a tagfüggvény az IOleCommandTarget::QueryStatus metódus működését emulálja a Windows SDK-ban leírtak szerint.

COleDocObjectItem::Release

Felszabadítja a kapcsolatot egy OLE csatolt elemhez, és bezárja, ha nyitva volt. Nem pusztítja el az ügyfélelemet.

virtual void Release(OLECLOSE dwCloseOption = OLECLOSE_NOSAVE);

Paraméterek

dwCloseOption
Jelölő, amely megadja, hogy milyen körülmények között menti az OLE-elemet, amikor visszatér a betöltött állapotba. A lehetséges értékek listáját a COleClientItem::Close című témakörben találja.

Megjegyzések

Nem pusztítja el az ügyfélelemet.

Lásd még

MFC-minta MFCBIND
COleClientItem osztály
hierarchiadiagram
COleClientItem osztály
CDocObjectServerItem osztály