COleClientItem 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.

Meghatározza az OLE-elemek tárolófelületét.

Szemantika

class COleClientItem : public CDocItem

Tagok

Nyilvános konstruktorok

Név	Leírás
COleClientItem::COleClientItem	Egy COleClientItem objektumot hoz létre.

Nyilvános metódusok

Név	Leírás
COleClientItem::Activate	Megnyitja egy művelet OLE elemét, majd végrehajtja a megadott igét.
COleClientItem::ActivateAs	Az elemet más típusként aktiválja.
COleClientItem::AttachDataObject	Hozzáfér az OLE objektum adataihoz.
COleClientItem::CanCreateFromData	Azt jelzi, hogy egy tárolóalkalmazás létrehozhat-e beágyazott objektumot.
COleClientItem::CanCreateLinkFromData	Azt jelzi, hogy egy tárolóalkalmazás létrehozhat-e csatolt objektumot.
COleClientItem::CanPaste	Azt jelzi, hogy a vágólap beágyazható vagy statikus OLE-elemet tartalmaz-e.
COleClientItem::CanPasteLink	Azt jelzi, hogy a vágólap tartalmaz-e csatolható OLE-elemet.
COleClientItem::Close	Bezár egy kiszolgálóra mutató hivatkozást, de nem pusztítja el az OLE elemet.
COleClientItem::ConvertTo	Az elemet egy másik típussá alakítja át.
COleClientItem::CopyToClipboard	Másolja az OLE elemet a vágólapra.
COleClientItem::CreateCloneFrom	Egy meglévő elem másolatát hozza létre.
COleClientItem::CreateFromClipboard	Beágyazott elemet hoz létre a vágólapról.
COleClientItem::CreateFromData	Beágyazott elemet hoz létre egy adatobjektumból.
COleClientItem::CreateFromFile	Beágyazott elemet hoz létre egy fájlból.
COleClientItem::CreateLinkFromClipboard	Csatolt elemet hoz létre a vágólapról.
COleClientItem::CreateLinkFromData	Csatolt elemet hoz létre egy adatobjektumból.
COleClientItem::CreateLinkFromFile	Csatolt elemet hoz létre egy fájlból.
COleClientItem::CreateNewItem	Új beágyazott elemet hoz létre a kiszolgálóalkalmazás elindításával.
COleClientItem::CreateStaticFromClipboard	Statikus elemet hoz létre a vágólapról.
COleClientItem::CreateStaticFromData	Statikus elemet hoz létre egy adatobjektumból.
COleClientItem::D eactivate	Inaktiválja az elemet.
COleClientItem::D eactivateUI	Visszaállítja a tárolóalkalmazás felhasználói felületét az eredeti állapotára.
COleClientItem::D elete	Törli vagy bezárja az OLE elemet, ha csatolt elem volt.
COleClientItem::D oDragDrop	Húzási műveletet hajt végre.
COleClientItem::D oVerb	Végrehajtja a megadott igét.
COleClientItem::D raw	Az OLE elem rajzolása.
COleClientItem::GetActiveView	Lekéri azt a nézetet, amelyen az elem aktiválva van.
COleClientItem::GetCachedExtent	Az OLE-elem téglalapjának határait adja vissza.
COleClientItem::GetClassID	Lekéri a jelenlegi elem osztályazonosítóját.
COleClientItem::GetClipboardData	A tagfüggvény meghívásával CopyToClipboard lekéri a vágólapra helyezendő adatokat.
COleClientItem::GetDocument	COleDocument Az aktuális elemet tartalmazó objektumot adja vissza.
COleClientItem::GetDrawAspect	Lekéri az elem aktuális nézetét a rendereléshez.
COleClientItem::GetExtent	Az OLE-elem téglalapjának határait adja vissza.
COleClientItem::GetIconFromRegistry	Lekéri a leírót egy adott CLSID-kiszolgálóhoz társított ikonhoz.
COleClientItem::GetIconicMetafile	Lekéri az elem ikonjának rajzolásához használt metafájlt.
COleClientItem::GetInPlaceWindow	Egy mutatót ad vissza az elem helyszíni szerkesztési ablakához.
COleClientItem::GetItemState	Lekéri az elem aktuális állapotát.
COleClientItem::GetLastStatus	Az utolsó OLE művelet állapotát adja vissza.
COleClientItem::GetLinkUpdateOptions	Egy csatolt elem frissítési módját adja vissza (speciális funkció).
COleClientItem::GetType	Az OLE-elem típusát (beágyazott, csatolt vagy statikus) adja vissza.
COleClientItem::GetUserType	Lekéri az elem típusát leíró sztringet.
COleClientItem::IsInPlaceActive	IGAZ értéket ad vissza, ha az elem helyben aktív.
COleClientItem::IsLinkUpToDate	IGAZ értéket ad vissza, ha egy csatolt elem naprakész a forrásdokumentumával.
COleClientItem::IsModified	Igaz értéket ad vissza, ha az elemet a legutóbbi mentés óta módosították.
COleClientItem::IsOpen	IGAZ értéket ad vissza, ha az elem jelenleg meg van nyitva a kiszolgálóalkalmazásban.
COleClientItem::IsRunning	Igaz értéket ad vissza, ha az elem kiszolgálóalkalmazása fut.
COleClientItem::OnActivate	A keretrendszer meghívta, hogy értesítse az elemet az aktiválásáról.
COleClientItem::OnActivateUI	A keretrendszer meghívta, hogy értesítse az elemet arról, hogy aktiválva van, és meg kell jelenítenie a felhasználói felületét.
COleClientItem::OnChange	A kiszolgáló az OLE-elem módosításakor hívja meg. Implementálásra van szükség.
COleClientItem::OnDeactivate	A keretrendszer meghívja egy elem inaktiválásakor.
COleClientItem::OnDeactivateUI	A keretrendszer meghívta, amikor a kiszolgáló eltávolította a helyszíni felhasználói felületét.
COleClientItem::OnGetClipboardData	A keretrendszer meghívta, hogy lekérje a vágólapra másolandó adatokat.
COleClientItem::OnInsertMenus	A keretrendszer meghívta egy összetett menü létrehozásához.
COleClientItem::OnRemoveMenus	A keretrendszer meghívta, hogy távolítsa el a tároló menüit egy összetett menüből.
COleClientItem::OnSetMenu	A keretrendszer meghívta egy összetett menü telepítéséhez és eltávolításához.
COleClientItem::OnShowControlBars	A keretrendszer meghívta a vezérlősávok megjelenítésére és elrejtésére.
COleClientItem::OnUpdateFrameTitle	A keretrendszer meghívta, hogy frissítse a keretablak címsorát.
COleClientItem::ReactivateAndUndo	Újraaktiválja az elemet, és visszavonja az utolsó helyszíni szerkesztési műveletet.
COleClientItem::Release	Felszabadítja a kapcsolatot egy OLE csatolt elemhez, és bezárja, ha nyitva volt. Nem pusztítja el az ügyfélelemet.
COleClientItem::Reload	Újra betölti az elemet a hívás ActivateAsután.
COleClientItem::Futtatás	Futtatja az elemhez társított alkalmazást.
COleClientItem::SetDrawAspect	Beállítja az elem aktuális nézetét a rendereléshez.
COleClientItem::SetExtent	Beállítja az OLE elem határolókeretét.
COleClientItem::SetHostNames	Beállítja a kiszolgáló által az OLE elem szerkesztésekor megjelenített neveket.
COleClientItem::SetIconicMetafile	Gyorsítótárazza az elem ikonjának rajzolásához használt metafájlt.
COleClientItem::SetItemRects	Beállítja az elem határoló téglalapját.
COleClientItem::SetLinkUpdateOptions	Beállítja a csatolt elem frissítési módját (speciális funkció).
COleClientItem::SetPrintDevice	Beállítja az ügyfélelem nyomtatási céleszközét.
COleClientItem::UpdateLink	Frissíti egy elem bemutatógyorsítótárát.

Védett metódusok

Név	Leírás
COleClientItem::CanActivate	A keretrendszer meghívta, hogy megállapítsa, engedélyezve van-e a helyszíni aktiválás.
COleClientItem::OnChangeItemPosition	A keretrendszer meghívja, amikor egy elem pozíciója megváltozik.
COleClientItem::OnDeactivateAndUndo	A keretrendszer meghívta a visszavonásra az aktiválás után.
COleClientItem::OnDiscardUndoState	A keretrendszer meghívta az elem visszavonási állapotadatainak elvetésére.
COleClientItem::OnGetClipRect	A keretrendszer meghívta, hogy lekérje az elem vágó-téglalap koordinátáit.
COleClientItem::OnGetItemPosition	A keretrendszer meghívta az elem nézethez viszonyított pozíciójának lekéréséhez.
COleClientItem::OnGetWindowContext	A keretrendszer meghívja, amikor egy elem aktiválódik a helyén.
COleClientItem::OnScrollBy	A keretrendszer meghívta az elemet a nézetbe görgetéshez.
COleClientItem::OnShowItem	A keretrendszer meghívta az OLE-elem megjelenítésére.

Megjegyzések

Az OLE-elemek egy kiszolgálóalkalmazás által létrehozott és karbantartott adatokat jelölnek, amelyek "zökkenőmentesen" beilleszthetők egy dokumentumba, hogy a felhasználó egyetlen dokumentumként jelenjen meg. Az eredmény egy "összetett dokumentum", amely az OLE elemből és egy tartalmazó dokumentumból áll.

Az OLE-elemek beágyazhatók vagy csatolhatók. Ha beágyazott, az adatok az összetett dokumentum részeként lesznek tárolva. Ha csatolták, az adatok a kiszolgálóalkalmazás által létrehozott külön fájl részeként lesznek tárolva, és csak az adott fájlra mutató hivatkozás lesz tárolva az összetett dokumentumban. Minden OLE-elem tartalmazza a szerkesztésükhöz meghívandó kiszolgálóalkalmazást meghatározó információkat.

COleClientItem több felülírható függvényt határoz meg, amelyeket a kiszolgálóalkalmazás kéréseire válaszolva hív meg; ezek a felülírandók általában értesítésekként működnek. Ez lehetővé teszi a kiszolgálóalkalmazás számára, hogy tájékoztassa a tárolót az OLE-elem szerkesztésekor végrehajtott módosításokról, vagy lekérheti a szerkesztés során szükséges információkat.

COleClientItem A COleDocument, a COleLinkingDoc vagy a COleServerDoc osztályban használható. A használathoz COleClientItemszármaztathat belőle egy osztályt, és implementálhatja az OnChange tagfüggvényt, amely meghatározza, hogy a tároló hogyan reagál az elem módosításaira. A helyszíni aktiválás támogatásához felülbírálja az OnGetItemPosition tagfüggvényt. Ez a függvény az OLE elem megjelenített helyzetéről nyújt információt.

A tárolófelület használatáról további információt a Tárolók: Tárolók és aktiválás implementálása című cikkben talál.

Megjegyzés:

A Windows SDK a beágyazott és csatolt elemekre "objektumokként" hivatkozik, és az elemek típusaira "osztályokként" hivatkozik. Ez a hivatkozás az "elem" kifejezés használatával különbözteti meg az OLE entitást a megfelelő C++ objektumtól, a "típus" kifejezés pedig az OLE kategóriát a C++ osztálytól való megkülönböztetéséhez.

Öröklési hierarchia

CObject

CCmdTarget

CDocItem

COleClientItem

Követelmények

fejléc: afxole.h

COleClientItem::Activate

Hívja meg ezt a függvényt, hogy a DoVerb helyett hajtsa végre a megadott igét, hogy saját feldolgozást hajthass végre kivétel esetén.

void Activate(
    LONG nVerb,
    CView* pView,
    LPMSG lpMsg = NULL);

Paraméterek

nVerb
A végrehajtandó igét adja meg. A következők egyike lehet:

Érték	Értelmezés	Szimbólum
0-	Elsődleges ige	OLEIVERB_PRIMARY
- 1	Másodlagos ige	(Nincs)
- 1	Elem megjelenítése szerkesztéshez	OLEIVERB_SHOW
- 2	Elem szerkesztése külön ablakban	OLEIVERB_OPEN
- 3	Elem elrejtése	OLEIVERB_HIDE

A -1 érték általában egy másik ige aliasa. Ha a megnyitott szerkesztés nem támogatott, -2 hatása megegyezik a -1-ével. További értékekért lásd: IOleObject::D oVerb a Windows SDK-ban.

pView
Mutató az OLE elemet tartalmazó tárolónézet ablakára; ezt a kiszolgálóalkalmazás használja a helyszíni aktiváláshoz. Ennek a paraméternek NULL értékűnek kell lennie, ha a tároló nem támogatja a helyszíni aktiválást.

lpMsg
Mutasson arra az üzenetre, amely az elemet aktiválta.

Megjegyzések

Ha a kiszolgálóalkalmazás a Microsoft Foundation osztálykönyvtárával lett megírva, ez a függvény a megfelelő objektum COleServerItem tagfüggvényét hajtja végre.

Ha az elsődleges ige Szerkesztés, és nulla van megadva az nVerb paraméterben, a kiszolgálóalkalmazás elindul, hogy az OLE-elem szerkeszthető legyen. Ha a tárolóalkalmazás támogatja a helyszíni aktiválást, a szerkesztés helyben is elvégezhető. Ha a tároló nem támogatja a helyszíni aktiválást (vagy ha a Megnyitás parancs meg van adva), a kiszolgáló egy külön ablakban indul el, és ott lehet szerkeszteni. Amikor a tárolóalkalmazás felhasználója duplán kattint az OLE elemre, az nVerb paraméter elsődleges parancsának értéke határozza meg, hogy a felhasználó milyen műveletet hajthat végre. Ha azonban a kiszolgáló csak egy műveletet támogat, akkor ezt a műveletet hajtja végre, függetlenül attól, hogy melyik érték van megadva az nVerb paraméterben.

További információ: IOleObject::D oVerb a Windows SDK-ban.

COleClientItem::ActivateAs

Az OLE objektumkonvertálási eszközeivel úgy aktiválja az elemet, mintha a clsidNew által megadott típusú elem lenne.

virtual BOOL ActivateAs(
    LPCTSTR lpszUserType,
    REFCLSID clsidOld,
    REFCLSID clsidNew);

Paraméterek

lpszUserType
Mutasson a célfelhasználó típusát képviselő sztringre, például a "Word-dokumentumra".

clsidOld
Hivatkozás az elem aktuális osztályazonosítójára. Az osztályazonosítónak meg kell jelölnie a tényleges objektum típusát tároltként, kivéve, ha hivatkozásról van szó. Ebben az esetben annak az elemnek a CLSID-jének kell lennie, amelyre a hivatkozás hivatkozik. A COleConvertDialog automatikusan megadja az elem megfelelő osztályazonosítóját.

clsidNew
Hivatkozás a célosztály-azonosítóra.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ezt a COleConvertDialog::D oConvert automatikusan meghívja. Általában nem közvetlenül hívják.

COleClientItem::AttachDataObject

Hívja meg ezt a függvényt egy COleDataObject inicializálásához az OLE elem adatainak eléréséhez.

void AttachDataObject(COleDataObject& rDataObject) const;

Paraméterek

rDataObject
Hivatkozás egy COleDataObject inicializálandó objektumra, amely lehetővé teszi az OLE-elem adataihoz való hozzáférést.

COleClientItem::CanActivate

A keretrendszer meghívja, amikor a felhasználó az OLE-elem helyszíni aktiválását kéri; A függvény visszatérési értéke határozza meg, hogy engedélyezve van-e a helyszíni aktiválás.

virtual BOOL CanActivate();

Visszaadott érték

Nonzero, ha a helyszíni aktiválás engedélyezett; egyéb esetben 0.

Megjegyzések

Az alapértelmezett implementáció lehetővé teszi a helyszíni aktiválást, ha a tároló érvényes ablakkal rendelkezik. Felülbírálja ezt a függvényt, hogy speciális logikát implementáljon az aktiválási kérelem elfogadásához vagy elutasításához. Ha például az OLE-elem túl kicsi vagy jelenleg nem látható, az aktiválási kérelmet elutasíthatja.

További információ: IOleInPlaceSite::CanInPlaceActivate a Windows SDK-ban.

COleClientItem::CanCreateFromData

Ellenőrzi, hogy egy tárolóalkalmazás létrehozhat-e beágyazott objektumot az adott COleDataObject objektumból.

static BOOL PASCAL CanCreateFromData(const COleDataObject* pDataObject);

Paraméterek

pDataObject
Mutasson arra a COleDataObject objektumra, amelyből az OLE-elemet létre kívánja hozni.

Visszaadott érték

Nonzero, ha a tároló beágyazott objektumot tud létrehozni az COleDataObject objektumból, ellenkező esetben 0.

Megjegyzések

Az COleDataObject osztály a vágólapról, húzással vagy beágyazott OLE-elemből különböző formátumú adatok átvitelére szolgál.

A tárolók ezzel a függvénnyel dönthetnek úgy, hogy engedélyezik vagy letiltják a Beillesztés szerkesztése és a Beillesztés szerkesztése speciális parancsait.

További információ: Data Objects and Data Sources (OLE) (Data Objects and Data Sources, OLE).

COleClientItem::CanCreateLinkFromData

Ellenőrzi, hogy egy tárolóalkalmazás létrehozhat-e csatolt objektumot az adott COleDataObject objektumból.

static BOOL PASCAL CanCreateLinkFromData(const COleDataObject* pDataObject);

Paraméterek

pDataObject
Mutasson arra a COleDataObject objektumra, amelyből az OLE-elemet létre kívánja hozni.

Visszaadott érték

Nem, ha a tároló létre tud hozni egy csatolt objektumot az COleDataObject objektumból.

Megjegyzések

Az COleDataObject osztály a vágólapról, húzással vagy beágyazott OLE-elemből különböző formátumú adatok átvitelére szolgál.

A tárolók ezzel a függvénnyel dönthetnek úgy, hogy engedélyezik vagy letiltják az Edit Paste Special és a Edit Paste Link parancsokat.

További információ: Data Objects and Data Sources (OLE) (Data Objects and Data Sources, OLE).

COleClientItem::CanPaste

Hívja meg ezt a függvényt, hogy lássa, beilleszthető-e beágyazott OLE-elem a vágólapról.

static BOOL PASCAL CanPaste();

Visszaadott érték

Nem kötelező, ha egy beágyazott OLE-elem beilleszthető a vágólapról; egyéb esetben 0.

Megjegyzések

További információ: OleGetClipboard és OleQueryCreateFromData a Windows SDK-ban.

COleClientItem::CanPasteLink

Hívja meg ezt a függvényt annak megállapításához, hogy egy csatolt OLE-elem beilleszthető-e a vágólapról.

static BOOL PASCAL CanPasteLink();

Visszaadott érték

Nem kötelező, ha egy csatolt OLE-elem beilleszthető a vágólapról; egyéb esetben 0.

Megjegyzések

További információ: OleGetClipboard és OleQueryLinkFromData a Windows SDK-ban.

COleClientItem::Close

Hívja meg ezt a függvényt, hogy módosítsa az OLE-elem állapotát a futó állapotról a betöltött állapotra, azaz a memóriában lévő kezelővel betöltve, de a kiszolgáló nem fut.

void Close(OLECLOSE dwCloseOption = OLECLOSE_SAVEIFDIRTY);

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 következő értékek egyikével rendelkezhet:

• OLECLOSE_SAVEIFDIRTY Mentse az OLE elemet.

• OLECLOSE_NOSAVE Ne mentse az OLE elemet.

• OLECLOSE_PROMPTSAVE Kérje meg a felhasználót, hogy mentse-e az OLE elemet.

Megjegyzések

Ennek a függvénynek nincs hatása, ha az OLE elem nem fut.

További információ: IOleObject::Close in the Windows SDK.

COleClientItem::COleClientItem

Létrehoz egy COleClientItem objektumot, és hozzáadja azt a tárolódokumentum dokumentumelem-gyűjteményéhez, amely csak a C++ objektumot hozza létre, és nem végez OLE-inicializálást.

COleClientItem(COleDocument* pContainerDoc = NULL);

Paraméterek

pContainerDoc
Mutasson az elemet tartalmazó tárolódokumentumra. Ez bármilyen COleDocument-származék lehet.

Megjegyzések

Ha NULL mutatót ad át, a tárolódokumentum nem lesz hozzávéve. Explicit módon kell meghívnia a COleDocument::AddItem parancsot.

Az OLE elem használata előtt az alábbi létrehozási tagfüggvények egyikét kell meghívnia:

• CreateFromClipboard

• CreateFromData

• CreateFromFile

• CreateStaticFromClipboard

• CreateStaticFromData

• CreateLinkFromClipboard

• CreateLinkFromData

• CreateLinkFromFile

• CreateNewItem

• CreateCloneFrom

COleClientItem::ConvertTo

Ennek a tagfüggvénynek a meghívásával konvertálja az elemet a clsidNew által megadott típusra.

virtual BOOL ConvertTo(REFCLSID clsidNew);

Paraméterek

clsidNew
A céltípus osztályazonosítója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ezt a COleConvertDialog automatikusan meghívja. Nem szükséges közvetlenül meghívni.

COleClientItem::CopyToClipboard

Hívja meg ezt a függvényt az OLE elem vágólapra másolásához.

void CopyToClipboard(BOOL bIncludeLink = FALSE);

Paraméterek

bIncludeLink
IGAZ, ha a csatolási adatokat a vágólapra kell másolni, lehetővé téve a csatolt elemek beillesztését; egyéb esetben HAMIS.

Megjegyzések

Ezt a függvényt általában akkor hívja meg, amikor a Szerkesztés menü Másolás vagy Kivágás parancsainak üzenetkezelőihez ír. Ha a Másolás vagy a Kivágás parancsot szeretné implementálni, akkor az elemkijelölést a tárolóalkalmazásban kell implementálnia.

További információ: OleSetClipboard a Windows SDK-ban.

COleClientItem::CreateCloneFrom

Hívja meg ezt a függvényt a megadott OLE-elem másolatának létrehozásához.

BOOL CreateCloneFrom(const COleClientItem* pSrcItem);

Paraméterek

pSrcItem
Mutasson a duplikálni kívánt OLE-elemre.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A másolat megegyezik a forráselemével. Ezzel a függvénnyel támogathatja a visszavonási műveleteket.

COleClientItem::CreateFromClipboard

A függvény meghívásával hozzon létre beágyazott elemet a vágólap tartalmából.

BOOL CreateFromClipboard(
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ezt a függvényt általában a Szerkesztés menü Beillesztés parancsának üzenetkezelőjében hívhatja meg. (A Beillesztés parancsot a keretrendszer engedélyezi, ha a CanPaste tagfüggvény nemzero értéket ad vissza.)

További információ: OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateFromData

A függvény meghívása beágyazott elem objektumból való COleDataObject létrehozásához.

BOOL CreateFromData(
    COleDataObject* pDataObject,
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

pDataObject
Mutasson arra a COleDataObject objektumra, amelyből az OLE-elemet létre kívánja hozni.

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Az adatátviteli műveletek, például a vágólapról történő beillesztés vagy a húzási műveletek olyan objektumokat biztosítanak COleDataObject , amelyek tartalmazzák a kiszolgálóalkalmazás által kínált információkat. Általában a CView::OnDrop felülbírálásához használják.

További információ: OleCreateFromData, OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateFromFile

A függvény meghívásával hozzon létre beágyazott OLE-elemet egy fájlból.

BOOL CreateFromFile(
    LPCTSTR lpszFileName,
    REFCLSID clsid = CLSID_NULL,
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

lpszFileName
Mutasson annak a fájlnak a nevére, amelyből az OLE-elemet létre kívánja hozni.

clsid
Jövőbeli használatra fenntartva.

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A keretrendszer meghívja ezt a függvényt a COleInsertDialog::CreateItem függvényből, ha a felhasználó az Ok gombot választja az Objektum beszúrása párbeszédpanelen, amikor a Létrehozás fájlból gomb be van jelölve.

További információ: OleCreateFromFile, OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateLinkFromClipboard

A függvény meghívásával hozzon létre egy csatolt elemet a vágólap tartalmából.

BOOL CreateLinkFromClipboard(
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ezt a függvényt általában a Szerkesztés menü Hivatkozás beillesztése parancsának üzenetkezelője hívja meg. (A Hivatkozás beillesztése parancs engedélyezve van a COleDocument alapértelmezett implementációjában, ha a vágólap tartalmaz egy OLE elemet, amelyhez csatolható.)

További információ: OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateLinkFromData

A függvény meghívása csatolt elem objektumból való COleDataObject létrehozásához.

BOOL CreateLinkFromData(
    COleDataObject* pDataObject,
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

pDataObject
Mutasson arra a COleDataObject objektumra, amelyből az OLE-elemet létre kívánja hozni.

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Hívja meg ezt egy legördülő művelet során, amikor a felhasználó azt jelzi, hogy létre kell hozni egy hivatkozást. A Beillesztés szerkesztése parancs kezelésére is használható. Ezt a keretrendszer COleClientItem::CreateLinkFromClipboard hívja meg a COlePasteSpecialDialog::CreateItem fájlban a Hivatkozás lehetőség kiválasztásakor.

További információ: OleCreateLinkFromData, OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateLinkFromFile

A függvény meghívásával hozzon létre egy csatolt OLE-elemet egy fájlból.

BOOL CreateLinkFromFile(
    LPCTSTR lpszFileName,
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

lpszFileName
Mutasson annak a fájlnak a nevére, amelyből az OLE-elemet létre kívánja hozni.

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A keretrendszer akkor hívja meg ezt a függvényt, ha a felhasználó az Ok gombot választja az Objektum beszúrása párbeszédpanelen, amikor a Létrehozás fájlból gomb be van jelölve, és be van jelölve a Hivatkozás jelölőnégyzet. A hívás a COleInsertDialog::CreateItem fájlból történik.

További információ: OleCreateLinkToFile, OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateNewItem

A függvény meghívása beágyazott elem létrehozásához; ez a függvény elindítja a kiszolgálóalkalmazást, amely lehetővé teszi a felhasználó számára az OLE-elem létrehozását.

BOOL CreateNewItem(
    REFCLSID clsid,
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

clsid
Azonosító, amely egyedileg azonosítja a létrehozandó OLE-elem típusát.

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A keretrendszer meghívja ezt a függvényt, ha a felhasználó az Új létrehozása gomb kiválasztásakor az Objektum beszúrása párbeszédpanelen az OK gombot választja.

További információ: OleCreate, OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateStaticFromClipboard

A függvény meghívásával statikus elemet hozhat létre a vágólap tartalmából.

BOOL CreateStaticFromClipboard(
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A statikus elemek a bemutató adatait tartalmazzák, a natív adatokat nem; ezért nem szerkeszthető. Ezt a függvényt általában akkor hívja meg, ha a CreateFromClipboard tagfüggvény meghiúsul.

További információ: OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::CreateStaticFromData

Hívja meg ezt a függvényt, hogy statikus elemet hozzon létre egy COleDataObject objektumból.

BOOL CreateStaticFromData(
    COleDataObject* pDataObject,
    OLERENDER render = OLERENDER_DRAW,
    CLIPFORMAT cfFormat = 0,
    LPFORMATETC lpFormatEtc = NULL);

Paraméterek

pDataObject
Mutasson arra a COleDataObject objektumra, amelyből az OLE-elemet létre kívánja hozni.

megjelenít
Az OLE-elem megjelenítésének módját jelző jelölő. A lehetséges értékekért tekintse meg az OLERENDERt a Windows SDK-ban.

cfFormat
Megadja az OLE-elem létrehozásakor gyorsítótárazandó vágólap adatformátumát.

lpFormatEtc
A renderelés OLERENDER_FORMAT vagy OLERENDER_DRAW esetén használt FORMATETC-struktúrára mutat. Csak akkor adjon meg értéket ehhez a paraméterhez, ha a cfFormat által megadott vágólapformátumon túl további formázási információkat szeretne megadni. Ha kihagyja ezt a paramétert, a rendszer az alapértelmezett értékeket használja a FORMATETC struktúra többi mezőjéhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A statikus elemek a bemutató adatait tartalmazzák, a natív adatokat nem; következésképpen nem szerkeszthető. Ez lényegében ugyanaz, mint a CreateStaticFromClipboard , azzal a kivétellel, hogy egy statikus elem tetszőleges , nem csak a vágólapról hozható létre COleDataObject.

A COlePasteSpecialDialog::CreateItem függvényben használatos, ha a Statikus elem van kiválasztva.

További információ: OleCreateStaticFromData, OLERENDER és FORMATETC a Windows SDK-ban.

COleClientItem::D eactivate

Hívja meg ezt a függvényt az OLE elem inaktiválásához és a társított erőforrások felszabadításához.

void Deactivate();

Megjegyzések

Általában inaktivál egy helyi aktív OLE-elemet, amikor a felhasználó az egeret az ügyfélterületen az elem határain kívülre kattintja. Vegye figyelembe, hogy az OLE elem inaktiválása elveti a visszavonási állapotát, így nem lehet meghívni az ÚjraaktiválásAndUndo tagfüggvényt.

Ha az alkalmazás támogatja a visszavonást, ne hívja Deactivatemeg; ehelyett hívja meg az DeactivateUI-t.

További információ: IOleInPlaceObject::InPlaceDeactivate a Windows SDK-ban.

COleClientItem::D eactivateUI

Hívja meg ezt a függvényt, ha a felhasználó inaktivál egy aktivált elemet.

void DeactivateUI();

Megjegyzések

Ez a függvény visszaállítja a tárolóalkalmazás felhasználói felületét az eredeti állapotára, elrejtve a helyi aktiváláshoz létrehozott menüket és egyéb vezérlőket.

Ez a függvény nem üríti ki az elem visszavonási állapotadatait. Ez az információ megmarad, így az ÚjraaktiválásAndUndo később felhasználható visszavonási parancs végrehajtására a kiszolgálóalkalmazásban, ha a tároló visszavonási parancsát közvetlenül az elem inaktiválása után választja ki.

További információ: IOleInPlaceObject::InPlaceDeactivate a Windows SDK-ban.

COleClientItem::D elete

Hívja meg ezt a függvényt, hogy törölje az OLE elemet a tárolódokumentumból.

void Delete(BOOL bAutoDelete = TRUE);

Paraméterek

bAutoDelete
Megadja, hogy az elemet el kell-e távolítani a dokumentumból.

Megjegyzések

Ez a függvény meghívja a Release tag függvényt, amely viszont törli az elem C++ objektumát, és véglegesen eltávolítja az OLE elemet a dokumentumból. Ha az OLE elem beágyazva van, az elem natív adatai törlődnek. Mindig bezár egy futó kiszolgálót; ezért ha az elem nyitott hivatkozás, ez a függvény bezárja azt.

COleClientItem::D oDragDrop

Hívja meg a DoDragDrop tagfüggvényt húzási művelet végrehajtásához.

DROPEFFECT DoDragDrop(
    LPCRECT lpItemRect,
    CPoint ptOffset,
    BOOL bIncludeLink = FALSE,
    DWORD dwEffects = DROPEFFECT_COPY | DROPEFFECT_MOVE,
    LPCRECT lpRectStartDrag = NULL);

Paraméterek

lpItemRect
Az elem téglalapja a képernyőn ügyfélkoordinátákban (képpontokban).

ptOffset
A lpItemRect eltolása, ahol az egér pozíciója a húzás idején volt.

bIncludeLink
Állítsa ezt IGAZ értékre, ha a csatolási adatokat a vágólapra kell másolni. Állítsa HAMIS értékre, ha a kiszolgálóalkalmazás nem támogatja a hivatkozásokat.

dwEffects
Meghatározza azokat az effektusokat, amelyeket a húzási forrás a húzási művelet során engedélyez.

lpRectStartDrag
Mutasson arra a téglalapra, amely meghatározza a húzás tényleges indításának helyét. További információkért lásd a következő Megjegyzések szakaszt.

Visszaadott érték

DROPEFFECT érték. Ha DROPEFFECT_MOVE, az eredeti adatokat el kell távolítani.

Megjegyzések

A húzási művelet nem indul el azonnal. Megvárja, amíg az egérmutató elhagyja az lpRectStartDrag által megadott téglalapot, vagy amíg egy megadott számú ezredmásodperc el nem telik. Ha az lpRectStartDrag értéke NULL, a téglalap mérete egy képpont.

A késleltetési időt egy beállításkulcs-beállítás határozza meg. A késleltetési időt a CWinApp::WriteProfileString vagy a CWinApp::WriteProfileInt meghívásával módosíthatja. Ha nem adja meg a késleltetési időt, a rendszer 200 ezredmásodperc alapértelmezett értéket használ. Az húzási késleltetési idő a következőképpen lesz tárolva:

• A Windows NT húzási késleltetési ideje a \Windows\DragDelay HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\NT\CurrentVersion\IniFileMapping\win.initárolja.

• A Windows 3.x húzási késleltetési ideje a WIN-ben van tárolva. INI-fájl, a [Windows} szakasz alatt.

• A Windows 95/98 húzza a késleltetési időt a WIN gyorsítótárazott verziójában tárolja. INI.

További információ az húzással kapcsolatos késleltetési információk beállításjegyzékben vagy a beállításjegyzékben való tárolásáról. INI-fájl: WriteProfileString a Windows SDK-ban.

COleClientItem::D oVerb

Hívás DoVerb a megadott ige végrehajtására.

virtual BOOL DoVerb(
    LONG nVerb,
    CView* pView,
    LPMSG lpMsg = NULL);

Paraméterek

nVerb
A végrehajtandó igét adja meg. A következő lehetőségek közül választhat:

Érték	Értelmezés	Szimbólum
0-	Elsődleges ige	OLEIVERB_PRIMARY
- 1	Másodlagos ige	(Nincs)
- 1	Elem megjelenítése szerkesztéshez	OLEIVERB_SHOW
- 2	Elem szerkesztése külön ablakban	OLEIVERB_OPEN
- 3	Elem elrejtése	OLEIVERB_HIDE

A -1 érték általában egy másik ige aliasa. Ha a megnyitott szerkesztés nem támogatott, -2 hatása megegyezik a -1-ével. További értékekért lásd: IOleObject::D oVerb a Windows SDK-ban.

pView
Mutató a nézetablakra; ezt a kiszolgáló használja a helyszíni aktiváláshoz. Ennek a paraméternek NULL értékűnek kell lennie, ha a tárolóalkalmazás nem engedélyezi a helyszíni aktiválást.

lpMsg
Mutasson arra az üzenetre, amely az elemet aktiválta.

Visszaadott érték

Nonzero, ha az igét sikeresen végrehajtották; egyéb esetben 0.

Megjegyzések

Ez a függvény meghívja a Tag aktiválása függvényt az ige végrehajtásához. A kivételeket is kiszűri, és egy üzenetmezőt jelenít meg a felhasználónak, ha van ilyen.

Ha az elsődleges ige Szerkesztés, és nulla van megadva az nVerb paraméterben, a kiszolgálóalkalmazás elindul, hogy az OLE-elem szerkeszthető legyen. Ha a tárolóalkalmazás támogatja a helyszíni aktiválást, a szerkesztés helyben is elvégezhető. Ha a tároló nem támogatja a helyszíni aktiválást (vagy ha a Megnyitás parancs meg van adva), a kiszolgáló egy külön ablakban indul el, és ott lehet szerkeszteni. Amikor a tárolóalkalmazás felhasználója duplán kattint az OLE elemre, az nVerb paraméter elsődleges parancsának értéke határozza meg, hogy a felhasználó milyen műveletet hajthat végre. Ha azonban a kiszolgáló csak egy műveletet támogat, akkor ezt a műveletet hajtja végre, függetlenül attól, hogy melyik érték van megadva az nVerb paraméterben.

COleClientItem::D raw

Hívja meg ezt a függvényt, hogy az OLE elemet a megadott határolókeretbe húzza a megadott eszközkörnyezet használatával.

BOOL Draw(
    CDC* pDC,
    LPCRECT lpBounds,
    DVASPECT nDrawAspect = (DVASPECT)-1);

Paraméterek

pDC
Mutató az OLE elem rajzolásához használt CDC-objektumra .

lpBounds
Mutasson egy CRect objektumra vagy RECT szerkezetre, amely meghatározza azt a határoló téglalapot, amelyben meg kell rajzolni az OLE elemet (az eszközkörnyezet által meghatározott logikai egységekben).

nDrawAspect
Megadja az OLE elem aspektusát, vagyis azt, hogy hogyan jelenjen meg. Ha az nDrawAspect értéke -1, akkor a Rendszer a SetDrawAspect használatával beállított utolsó szempontot használja. A jelző lehetséges értékeivel kapcsolatos további információkért lásd: SetDrawAspect.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A függvény az OnDraw tagfüggvénye által létrehozott OLE elem metafájl-ábrázolását használhatja COleServerItem.

Általában képernyőmegjelenítéshez használja Draw , és pDC-ként adja át a képernyőeszköz környezetét. Ebben az esetben csak az első két paramétert kell megadnia.

Az lpBounds paraméter azonosítja a téglalapot a céleszköz környezetében (az aktuális leképezési módhoz képest). A renderelés magában foglalhatja a kép skálázását, és tárolóalkalmazások használhatják a megjelenített nézet és a végső nyomtatott kép közötti skálázást.

További információ: IViewObject::D raw a Windows SDK-ban.

COleClientItem::GetActiveView

Azt a nézetet adja vissza, amelyen az elem aktiválva van.

CView* GetActiveView() const;

Visszaadott érték

Mutató a nézetre; ellenkező esetben NULL értékű, ha az elem nincs aktiválva a helyén.

COleClientItem::GetCachedExtent

Hívja meg ezt a függvényt az OLE-elem méretének lekéréséhez.

BOOL GetCachedExtent(
    LPSIZE lpSize,
    DVASPECT nDrawAspect = (DVASPECT)-1);

Paraméterek

lpSize
Mutasson egy SIZE szerkezetre vagy egy CSize objektumra, amely megkapja a méretadatokat.

nDrawAspect
Annak az OLE-elemnek a aspektusát adja meg, amelynek a határait le kell kérni. A lehetséges értékekért lásd: SetDrawAspect.

Visszaadott érték

Nonzero, ha sikeres; 0, ha az OLE elem üres.

Megjegyzések

Ez a függvény ugyanazokat az információkat biztosítja, mint a GetExtent. A többi OLE-kezelő, például az GetCachedExtent feldolgozása során azonban meghívhatja a mértékinformációk lekérését. A méretek MM_HIMETRIC egységekben találhatók.

Ez azért lehetséges, mert GetCachedExtent az IViewObject2 interfészt használja az IOleObject interfész helyett az elem mértékének lekéréséhez. A IViewObject2 COM-objektum gyorsítótárazza az előző IViewObject::D raw hívásban használt mértékadatokat.

További információ: IViewObject2::GetExtent a Windows SDK-ban.

COleClientItem::GetClassID

Az elem osztályazonosítóját adja vissza a pClassID által mutatott memóriába.

void GetClassID(CLSID* pClassID) const;

Paraméterek

pClassID
Az osztályazonosító lekéréséhez mutasson egy CLSID típusú azonosítóra. A CLSID-ről a Windows SDK-ról olvashat.

Megjegyzések

Az osztályazonosító egy 128 bites szám, amely egyedileg azonosítja az elemet szerkesztő alkalmazást.

További információ: IPersist::GetClassID a Windows SDK-ban.

COleClientItem::GetClipboardData

Hívja meg ezt a függvényt, COleDataSource hogy a CopyToClipboard tagfüggvény hívásával lekérje a vágólapra helyezendő összes adatot tartalmazó objektumot.

void GetClipboardData(
    COleDataSource* pDataSource,
    BOOL bIncludeLink = FALSE,
    LPPOINT lpOffset = NULL,
    LPSIZE lpSize = NULL);

Paraméterek

pDataSource
Mutasson egy COleDataSource-objektumra , amely megkapja az OLE elemben található adatokat.

bIncludeLink
IGAZ, ha csatolási adatokat kell tartalmaznia; egyéb esetben HAMIS.

lpOffset
Az egérmutató eltolása az objektum forrásától képpontban.

lpSize
Az objektum mérete képpontban.

Megjegyzések

GetClipboardData az OnGetClipboardData alapértelmezett implementációjaként van meghívva. Csak akkor bírálja felül OnGetClipboardData , ha az általuk kínáltakon kívül adatformátumokat is szeretne CopyToClipboardkínálni. Ezeket a formátumokat a hívás COleDataSourceelőtt vagy után helyezze el az CopyToClipboard objektumban, majd adja át az COleDataSource objektumot a COleDataSource::SetClipboard függvénynek. Ha például azt szeretné, hogy az OLE-elem helye a tárolódokumentumban a vágólapra kerüljön, saját formátumot kell megadnia az információk átadásához, és a hívás COleDataSourceelőtt helyezze el.CopyToClipboard

COleClientItem::GetDocument

Hívja meg ezt a függvényt, hogy az OLE elemet tartalmazó dokumentumra mutató mutatót kapjon.

COleDocument* GetDocument() const;

Visszaadott érték

Mutató az OLE elemet tartalmazó dokumentumra. NULL érték, ha az elem nem része a dokumentumnak.

Megjegyzések

Ez a mutató lehetővé teszi a COleDocument konstruktor számára argumentumként COleClientItem átadott objektum elérését.

COleClientItem::GetDrawAspect

Hívja meg a GetDrawAspect tagfüggvényt az elem aktuális "aspektusának" vagy nézetének meghatározásához.

DVASPECT GetDrawAspect() const;

Visszaadott érték

A DVASPECT enumerálásából származó érték, amelynek értékei a SetDrawAspect hivatkozásában szerepelnek.

Megjegyzések

A szempont határozza meg az elem megjelenítésének módját.

COleClientItem::GetExtent

Hívja meg ezt a függvényt az OLE-elem méretének lekéréséhez.

BOOL GetExtent(
    LPSIZE lpSize,
    DVASPECT nDrawAspect = (DVASPECT)- 1);

Paraméterek

lpSize
Mutasson egy SIZE olyan struktúrára vagy objektumra CSize , amely megkapja a méretadatokat.

nDrawAspect
Annak az OLE-elemnek a aspektusát adja meg, amelynek a határait le kell kérni. A lehetséges értékekért lásd: SetDrawAspect.

Visszaadott érték

Nonzero, ha sikeres; 0, ha az OLE elem üres.

Megjegyzések

Ha a kiszolgálóalkalmazás a Microsoft Foundation osztálykönyvtárával lett megírva, ez a függvény a megfelelő objektum COleServerItem tagfüggvényének meghívását eredményezi. Vegye figyelembe, hogy a beolvasott méret eltérhet a SetExtent tagfüggvény által legutóbb beállított mérettől; a megadott SetExtent méret javaslatként lesz kezelve. A méretek MM_HIMETRIC egységekben találhatók.

Megjegyzés:

Ne hívjon GetExtent az OLE-kezelők, például az OnChange feldolgozása során. Ehelyett hívja meg a GetCachedExtent parancsot.

További információ: IOleObject:GetExtent a Windows SDK-ban.

COleClientItem::GetIconFromRegistry

Hívja meg ezt a tagfüggvényt, hogy lekérjen egy leírót egy adott CLSID-kiszolgálóhoz társított ikonerőforráshoz.

HICON GetIconFromRegistry() const;

static HICON GetIconFromRegistry(CLSID& clsid);

Paraméterek

clsid
Hivatkozás az ikonnal társított kiszolgáló CLSID azonosítóra.

Visszaadott érték

Érvényes fogópont az ikonerőforráshoz, vagy null értékű, ha a kiszolgáló ikonja vagy alapértelmezett ikonja nem található.

Megjegyzések

Ez a tagfüggvény nem indítja el a kiszolgálót, és nem szerez be dinamikusan ikont, még akkor sem, ha a kiszolgáló már fut. Ez a tagfüggvény ehelyett megnyitja a kiszolgáló végrehajtható rendszerképét, és beolvassa a kiszolgálóhoz társított statikus ikont a regisztráció során.

COleClientItem::GetIconicMetafile

Lekéri az elem ikonjának rajzolásához használt metafájlt.

HGLOBAL GetIconicMetafile();

Visszaadott érték

A metafájl leírója, ha sikeres; ellenkező esetben NULL.

Megjegyzések

Ha nincs aktuális ikon, a rendszer egy alapértelmezett ikont ad vissza. Ezt az MFC/OLE párbeszédpanelek automatikusan meghívják, és általában nem közvetlenül hívják meg.

Ez a függvény a SetIconicMetafile-t is meghívja , hogy gyorsítótárazza a metafájlt későbbi használatra.

COleClientItem::GetInPlaceWindow

Hívja meg a GetInPlaceWindow tagfüggvényt, hogy mutasson arra az ablakra, amelyben az elemet megnyitották helyben történő szerkesztésre.

CWnd* GetInPlaceWindow();

Visszaadott érték

Mutató az elem helyszíni szerkesztési ablakára; NULL érték, ha az elem nem aktív, vagy a kiszolgáló nem érhető el.

Megjegyzések

Ezt a függvényt csak olyan elemekhez kell meghívni, amelyek helyben aktívak.

COleClientItem::GetItemState

Hívja meg ezt a függvényt az OLE-elem aktuális állapotának lekéréséhez.

UINT GetItemState() const;

Visszaadott érték

Számba COleClientItem::ItemState vehető érték, amely a következők egyike lehet: emptyState, loadedState, , openState, activeStateactiveUIState. Ezekről az állapotokról további információt a Tárolók: Client-Item állapotok című cikkben talál.

Megjegyzések

Ha értesítést szeretne kapni az OLE-elem állapotának változásairól, használja az OnChange tagfüggvényt.

További információt a Tárolók: Client-Item állapotok című cikkben talál.

COleClientItem::GetLastStatus

Az utolsó OLE művelet állapotkódját adja vissza.

SCODE GetLastStatus() const;

Visszaadott érték

SCODE-érték.

Megjegyzések

Azon tagfüggvények esetében, amelyek HAMIS BOOL-értéket adnak vissza, vagy más, NULL értéket visszaadó tagfüggvények, GetLastStatus részletesebb hibainformációkat ad vissza. Vegye figyelembe, hogy a legtöbb OLE-tagfüggvény kivételeket ad a súlyosabb hibákhoz. Az SCODE értelmezésére vonatkozó konkrét információk az alapul szolgáló OLE-hívástól függenek, amely legutóbb egy SCODE-értéket adott vissza.

Az SCODE-val kapcsolatos további információkért tekintse meg a COM-hibakódok szerkezetét a Windows SDK dokumentációjában.

COleClientItem::GetLinkUpdateOptions

Hívja meg ezt a függvényt az OLE elem hivatkozásfrissítési beállításának aktuális értékének lekéréséhez.

OLEUPDATE GetLinkUpdateOptions();

Visszaadott érték

Az alábbi értékek egyike:

• OLEUPDATE_ALWAYS Frissítse a csatolt elemet, amikor csak lehetséges. Ez a beállítás a Hivatkozások párbeszédpanel Automatikus hivatkozásfrissítés választógombjának használatát támogatja.

• OLEUPDATE_ONCALL Csak a tárolóalkalmazás kérése alapján frissítse a csatolt elemet (amikor az UpdateLink tagfüggvényt meghívja). Ez a beállítás támogatja a Kézi hivatkozásfrissítés választógombot a Hivatkozások párbeszédpanelen.

Megjegyzések

Ez egy speciális művelet.

Ezt a függvényt a COleLinksDialog osztály automatikusan meghívja.

További információ : IOleLink::GetUpdateOptions a Windows SDK-ban.

COleClientItem::GetType

Hívja meg ezt a függvényt annak meghatározásához, hogy az OLE-elem beágyazott vagy csatolt vagy statikus-e.

OLE_OBJTYPE GetType() const;

Visszaadott érték

Egy aláíratlan egész szám az alábbi értékek egyikével:

• OT_LINK Az OLE elem egy hivatkozás.

• OT_EMBEDDED Az OLE elem beágyazva van.

• OT_STATIC Az OLE elem statikus, azaz csak bemutatóadatokat tartalmaz, natív adatokat nem, ezért nem szerkeszthető.

COleClientItem::GetUserType

A függvény meghívásával lekérheti az OLE-elem típusát leíró, felhasználó által látható sztringet, például a "Word-dokumentumot".

void GetUserType(
    USERCLASSTYPE nUserClassType,
    CString& rString);

Paraméterek

nUserClassType
Az OLE-elem típusát leíró sztring kívánt variánsát jelző érték. Ez a következő értékek egyikével rendelkezhet:

• USERCLASSTYPE_FULL A felhasználó számára megjelenített teljes típusnév.

• USERCLASSTYPE_SHORT Előugró menükben és a Hivatkozások szerkesztése párbeszédpanelen használható rövid név (legfeljebb 15 karakter).

• USERCLASSTYPE_APPNAME Osztályt karbantartó alkalmazás neve.

rString
Egy olyan CString-objektumra mutató hivatkozás, amelyhez az OLE-elem típusát leíró sztringet kell visszaadni.

Megjegyzések

Ez gyakran a rendszerregisztrációs adatbázis bejegyzése.

Ha a teljes típusnevet kéri, de nem érhető el, a rövid nevet használja a rendszer. Ha nem található bejegyzés az OLE-elem típusához a regisztrációs adatbázisban, vagy ha az OLE-elem típusához nincs regisztrálva felhasználói típus, akkor a rendszer az OLE elemben jelenleg tárolt felhasználói típust használja. Ha ez a felhasználónév egy üres sztring, a rendszer az "Ismeretlen objektum" kifejezést használja.

További információ: IOleObject::GetUserType a Windows SDK-ban.

COleClientItem::IsInPlaceActive

Hívja meg ezt a függvényt, és ellenőrizze, hogy az OLE elem aktív-e.

BOOL IsInPlaceActive() const;

Visszaadott érték

Nonzero, ha az OLE elem helyben aktív; egyéb esetben 0.

Megjegyzések

Gyakori, hogy különböző logikát hajtanak végre attól függően, hogy az elemet a helyén szerkesztik-e. A függvény ellenőrzi, hogy az aktuális elem állapota megegyezik-e a vagy a activeStateactiveUIState.

COleClientItem::IsLinkUpToDate

Hívja meg ezt a függvényt annak megállapításához, hogy az OLE elem naprakész-e.

BOOL IsLinkUpToDate() const;

Visszaadott érték

Nem érvényes, ha az OLE elem naprakész; egyéb esetben 0.

Megjegyzések

A csatolt elemek elavultak lehetnek, ha a forrásdokumentuma frissült. A benne lévő hivatkozásokat tartalmazó beágyazott elemek szintén elavulttá válhatnak. A függvény elvégzi az OLE elem rekurzív ellenőrzését. Vegye figyelembe, hogy annak meghatározása, hogy egy OLE-elem elavult-e, olyan költséges lehet, mint a frissítés tényleges végrehajtása.

Ezt a COleLinksDialog implementáció automatikusan meghívja.

További információ: IOleObject::IsUpToDate a Windows SDK-ban.

COleClientItem::IsModified

Hívja meg ezt a függvényt annak megállapításához, hogy az OLE-elem piszkos-e (a legutóbbi mentés óta módosult).

BOOL IsModified() const;

Visszaadott érték

Nonzero, ha az OLE elem piszkos; egyéb esetben 0.

Megjegyzések

További információ: IPersistStorage::IsDirty a Windows SDK-ban.

COleClientItem::IsOpen

Hívja meg ezt a függvényt annak megtekintéséhez, hogy az OLE elem nyitva van-e; vagyis a kiszolgálóalkalmazás egy külön ablakban futó példányában nyílik meg.

BOOL IsOpen() const;

Visszaadott érték

Nonzero, ha az OLE elem nyitva van; egyéb esetben 0.

Megjegyzések

Annak meghatározására szolgál, hogy mikor kell keltetőmintával rajzolni az objektumot. A nyitott objektumoknak az objektum tetején ferde mintával kell rendelkezniük. Ehhez használhat CRectTracker objektumot.

COleClientItem::IsRunning

Hívja meg ezt a függvényt annak ellenőrzéséhez, hogy az OLE-elem fut-e; vagyis azt, hogy az elem be van-e töltve és fut-e a kiszolgálóalkalmazásban.

BOOL IsRunning() const;

Visszaadott érték

Nonzero, ha az OLE elem fut; egyéb esetben 0.

Megjegyzések

További információ: OleIsRunning a Windows SDK-ban.

COleClientItem::OnActivate

A keretrendszer meghívta, hogy értesítse az elemet, hogy az éppen aktiválódott.

virtual void OnActivate();

Megjegyzések

Vegye figyelembe, hogy ez a függvény azt jelzi, hogy a kiszolgáló fut, nem pedig annak jelzésére, hogy a felhasználói felülete telepítve van a tárolóalkalmazásban. Ezen a ponton az objektum nem rendelkezik aktív felhasználói felülettel (nem activeUIState). Nem telepítette a menüit vagy az eszköztárát. Ekkor a függvény meghívja az OnActivateUI tagfüggvényt.

Az alapértelmezett implementáció meghívja az OnChange tagfüggvényt OLE_CHANGEDSTATE paraméterként. Felülbírálja ezt a függvényt az egyéni feldolgozás végrehajtásához, amikor egy elem aktívvá válik.

COleClientItem::OnActivateUI

A keretrendszer meghívja OnActivateUI , ha az objektum aktív felhasználói felületi állapotba lépett.

virtual void OnActivateUI();

Megjegyzések

Az objektum most telepítette az eszközsávját és a menüit.

Az alapértelmezett implementáció megjegyzi a kiszolgáló HWND-jét a későbbi GetServerWindow hívásokhoz.

COleClientItem::OnChange

A keretrendszer meghívja, amikor a felhasználó módosítja, menti vagy bezárja az OLE-elemet.

virtual void OnChange(
    OLE_NOTIFICATION nCode,
    DWORD dwParam);

Paraméterek

nCode
A kiszolgáló azért módosította ezt az elemet. A következő értékek egyikével rendelkezhet:

• OLE_CHANGED Az OLE-elem megjelenése megváltozott.

• OLE_SAVED Az OLE elem mentése megtörtént.

• OLE_CLOSED Az OLE elem bezárult.

• OLE_CHANGED_STATE Az OLE elem egyik állapotról a másikra módosult.

dwParam
Ha az nCode OLE_SAVED vagy OLE_CLOSED, a rendszer nem használja ezt a paramétert. Ha az nCode OLE_CHANGED, ez a paraméter a módosított OLE elem aspektusát adja meg. A lehetséges értékekért tekintse meg a COleClientItem::D rawdwParam paraméterét. Ha az nCode OLE_CHANGED_STATE, ez a paraméter számbavételes COleClientItem::ItemState érték, és a beírt állapotot írja le. A következő értékek egyikével rendelkezhet: emptyState, loadedState, openState, activeStatevagy activeUIState.

Megjegyzések

(Ha a kiszolgálóalkalmazás a Microsoft Foundation osztálykönyvtárával van megírva, akkor a rendszer ezt a függvényt hívja meg a Notify függvény tagfüggvényeinek COleServerDoc vagy COleServerItem.) Az alapértelmezett implementáció módosítottként jelöli meg a tárolódokumentumot, ha az nCode OLE_CHANGED vagy OLE_SAVED.

Az OLE_CHANGED_STATE esetében a GetItemState-ből visszaadott aktuális állapot továbbra is a régi állapot lesz, ami azt jelenti, hogy az állapotváltás előtt aktuális állapot volt.

A függvény felülbírálása az OLE-elem állapotának változásaira való reagáláshoz. Általában azzal frissíti az elem megjelenését, hogy érvényteleníti az elem megjelenítésének területét. Hívja meg az alaposztály implementációját a felülbírálás elején.

COleClientItem::OnChangeItemPosition

A keretrendszer meghívta, hogy értesítse a tárolót arról, hogy az OLE-elem mértéke megváltozott a helyszíni aktiválás során.

virtual BOOL OnChangeItemPosition(const CRect& rectPos);

Paraméterek

rectPos
Az elem pozícióját jelzi a tárolóalkalmazás ügyfélterületéhez viszonyítva.

Visszaadott érték

Nonzero, ha az elem pozíciója sikeresen módosult; egyéb esetben 0.

Megjegyzések

Az alapértelmezett implementáció határozza meg az OLE elem új látható téglalapját, és meghívja a SetItemRects függvényt az új értékekkel. Az alapértelmezett implementáció kiszámítja az elem látható téglalapjait, és átadja az adatokat a kiszolgálónak.

Felülbírálja ezt a függvényt, hogy speciális szabályokat alkalmazzon az átméretezési/áthelyezési műveletre. Ha az alkalmazás MFC-ben van megírva, ez a hívás a COleServerDoc::RequestPositionChange nevű kiszolgáló miatt jön eredményül.

COleClientItem::OnDeactivate

A keretrendszer meghívja, amikor az OLE-elem a helyi aktív állapotról (activeState) a betöltött állapotra vált, ami azt jelenti, hogy a rendszer inaktiválja azt egy helyszíni aktiválás után.

virtual void OnDeactivate();

Megjegyzések

Vegye figyelembe, hogy ez a függvény azt jelzi, hogy az OLE elem bezárult, nem pedig azt, hogy a felhasználói felület el lett távolítva a tárolóalkalmazásból. Ilyen esetben a függvény meghívja az OnDeactivateUI tagfüggvényt.

Az alapértelmezett implementáció meghívja az OnChange tagfüggvényt OLE_CHANGEDSTATE paraméterként. Felülbírálja ezt a függvényt, hogy egyéni feldolgozást végezzen egy helyi aktív elem inaktiválásakor. Ha például támogatja a visszavonási parancsot a tárolóalkalmazásban, felülbírálhatja ezt a függvényt a visszavonási állapot elvetéséhez, ami azt jelzi, hogy az OLE elemen végrehajtott utolsó művelet nem vonható vissza az elem inaktiválása után.

COleClientItem::OnDeactivateAndUndo

A keretrendszer meghívja, amikor a felhasználó meghívja a visszavonási parancsot az OLE elem aktiválása után.

virtual void OnDeactivateAndUndo();

Megjegyzések

Az alapértelmezett implementáció meghívja az DeactivateUI-t a kiszolgáló felhasználói felületének inaktiválására. Bírálja felül ezt a függvényt, ha a visszavonási parancsot implementálja a tárolóalkalmazásban. A felülbírálás során hívja meg a függvény alaposztály-verzióját, majd vonja vissza az alkalmazásban végrehajtott utolsó parancsot.

További információ: IOleInPlaceSite::D eactivateAndUndo a Windows SDK-ban.

COleClientItem::OnDeactivateUI

Akkor hívható meg, amikor a felhasználó inaktivál egy aktivált elemet.

virtual void OnDeactivateUI(BOOL bUndoable);

Paraméterek

bUndoable
Megadja, hogy a szerkesztési módosítások visszavonhatók-e.

Megjegyzések

Ez a függvény visszaállítja a tárolóalkalmazás felhasználói felületét az eredeti állapotára, elrejtve a helyi aktiváláshoz létrehozott menüket és egyéb vezérlőket.

Ha a bUndoable ÉRTÉKE HAMIS, a tárolónak le kell tiltania a visszavonási parancsot, ami lényegében elveti a tároló visszavonási állapotát, mert azt jelzi, hogy a kiszolgáló által végrehajtott utolsó művelet nem vonható vissza.

COleClientItem::OnDiscardUndoState

A keretrendszer meghívja, amikor a felhasználó olyan műveletet hajt végre, amely elveti a visszavonási állapotot az OLE elem szerkesztésekor.

virtual void OnDiscardUndoState();

Megjegyzések

Az alapértelmezett implementáció nem végez semmit. Bírálja felül ezt a függvényt, ha a visszavonási parancsot implementálja a tárolóalkalmazásban. A felülbírálás során elvetheti a tárolóalkalmazás visszavonási állapotát.

Ha a kiszolgáló a Microsoft Foundation osztálykönyvtárával lett megírva, a kiszolgáló a COleServerDoc::D iscardUndoState meghívásával okozhatja a függvény meghívását.

További információ: IOleInPlaceSite::D iscardUndoState a Windows SDK-ban.

COleClientItem::OnGetClipboardData

A keretrendszer meghívta, COleDataSource hogy a CopyToClipboard vagy a DoDragDrop tagfüggvény hívásával lekérje a vágólapra helyezendő összes adatot tartalmazó objektumot.

virtual COleDataSource* OnGetClipboardData(
    BOOL bIncludeLink,
    LPPOINT lpOffset,
    LPSIZE lpSize);

Paraméterek

bIncludeLink
Állítsa ezt IGAZ értékre, ha a csatolási adatokat a vágólapra kell másolni. Állítsa ezt HAMIS értékre, ha a kiszolgálóalkalmazás nem támogatja a hivatkozásokat.

lpOffset
Mutasson az egérmutató eltolására az objektum forrásától képpontban.

lpSize
Mutasson az objektum méretére képpontban.

Visszaadott érték

Mutató a vágólap adatait tartalmazó COleDataSource-objektumra .

Megjegyzések

A függvény alapértelmezett implementációja a GetClipboardData meghívása.

COleClientItem::OnGetClipRect

A keretrendszer meghívja a OnGetClipRect tagfüggvényt, hogy lekérje a helyben szerkesztett elem kivágási-téglalap koordinátáit.

virtual void OnGetClipRect(CRect& rClipRect);

Paraméterek

rClipRect
Mutasson a CRect osztály egyik objektumára, amely az elem vágó-téglalap koordinátáit fogja tárolni.

Megjegyzések

A koordináták képpontban vannak a tárolóalkalmazás ablakának ügyfélterületéhez képest.

Az alapértelmezett implementáció egyszerűen visszaadja annak a nézetnek az ügyfél téglalapját, amelyen az elem aktív.

COleClientItem::OnGetItemPosition

A keretrendszer meghívja a OnGetItemPosition tagfüggvényt a helyben szerkesztett elem koordinátáinak lekéréséhez.

virtual void OnGetItemPosition(CRect& rPosition);

Paraméterek

rPosition
Hivatkozás az elem pozíciókoordinátáit tartalmazó CRect objektumra.

Megjegyzések

A koordináták képpontban vannak a tárolóalkalmazás ablakának ügyfélterületéhez képest.

A függvény alapértelmezett implementációja nem végez semmit. A helyszíni szerkesztést támogató alkalmazások implementálására van szükség.

COleClientItem::OnGetWindowContext

A keretrendszer meghívja, amikor egy elem aktiválódik a helyén.

virtual BOOL OnGetWindowContext(
    CFrameWnd** ppMainFrame,
    CFrameWnd** ppDocFrame,
    LPOLEINPLACEFRAMEINFO lpFrameInfo);

Paraméterek

ppMainFrame
Mutasson a fő keretablakra mutató mutatóra.

ppDocFrame
Mutasson a dokumentumkeret ablakára mutató mutatóra.

lpFrameInfo
Mutasson egy OLEINPLACEFRAMEINFO szerkezetre, amely keretablak-információkat fog kapni.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ez a függvény az OLE-elem szülőablakával kapcsolatos információk lekérésére szolgál.

Ha a tároló MDI-alkalmazás, az alapértelmezett implementáció egy mutatót ad vissza a ppMainFrameCMDIFrameWnd objektumához, és egy mutatót a ppDocFrame aktív CMDIChildWnd objektumához. Ha a tároló SDI-alkalmazás, az alapértelmezett implementáció a ppMainFrameCFrameWnd objektumára mutató mutatót ad vissza, és null értéket ad vissza a ppDocFrame-ben. Az alapértelmezett implementáció az lpFrameInfo tagjait is kitölti.

Ezt a függvényt csak akkor bírálja felül, ha az alapértelmezett implementáció nem felel meg az alkalmazásnak; Ha például az alkalmazás olyan felhasználói felületi paradigmával rendelkezik, amely különbözik az SDI-től vagy az MDI-től. Ez egy speciális felülírható.

További információ: IOleInPlaceSite::GetWindowContext és az OLEINPLACEFRAMEINFO struktúra a Windows SDK-ban.

COleClientItem::OnInsertMenus

A keretrendszer meghívta a helyi aktiválás során, hogy beszúrja a tárolóalkalmazás menüit egy üres menübe.

virtual void OnInsertMenus(
    CMenu* pMenuShared,
    LPOLEMENUGROUPWIDTHS lpMenuWidths);

Paraméterek

pMenuShared
Egy üres menüre mutat.

lpMenuWidths
Hat LONG értékből álló tömbre mutat, amely jelzi, hogy hány menü található az alábbi menücsoportokban: Fájl, Szerkesztés, Tároló, Objektum, Ablak, Súgó. A tárolóalkalmazás felelős a tömb 0., 2. és 4. elemeinek megfelelő Fájl, Tároló és Ablak menücsoportokért.

Megjegyzések

Ezt a menüt ezután átadja a kiszolgálónak, amely beszúrja a saját menüit, létrehozva egy összetett menüt. Ez a függvény többször is meghívható több összetett menü létrehozásához.

Az alapértelmezett implementáció beszúrja a helyi tárolómenüket a pMenuShared fájlba; vagyis a Fájl, a Tároló és az Ablak menücsoportot. CDocTemplate::A SetContainerInfo a menüerőforrás beállítására szolgál. Az alapértelmezett implementáció az lpMenuWidths 0, 2 és 4 elemeihez is hozzárendeli a megfelelő értékeket a menüerőforrástól függően. Bírálja felül ezt a függvényt, ha az alapértelmezett implementáció nem megfelelő az alkalmazáshoz; Ha például az alkalmazás nem használ dokumentumsablonokat az erőforrások dokumentumtípusokhoz való társítására. Ha felülbírálja ezt a függvényt, felül kell bírálnia az OnSetMenu és az OnRemoveMenus parancsot is. Ez egy speciális felülírható.

További információ: IOleInPlaceFrame::InsertMenus a Windows SDK-ban.

COleClientItem::OnRemoveMenus

A keretrendszer meghívta, hogy távolítsa el a tároló menüit a megadott összetett menüből, amikor a helyi aktiválás véget ér.

virtual void OnRemoveMenus(CMenu* pMenuShared);

Paraméterek

pMenuShared
Az OnInsertMenus tagfüggvény hívásai által létrehozott összetett menüre mutat.

Megjegyzések

Az alapértelmezett implementáció eltávolítja a pMenuShared a helyi tárolómenüket, azaz a Fájl, a Tároló és az Ablak menücsoportokat. Bírálja felül ezt a függvényt, ha az alapértelmezett implementáció nem megfelelő az alkalmazáshoz; Ha például az alkalmazás nem használ dokumentumsablonokat az erőforrások dokumentumtípusokhoz való társítására. Ha felülbírálja ezt a függvényt, valószínűleg felül kell bírálnia az OnInsertMenus és az OnSetMenu parancsot is. Ez egy speciális felülírható.

A pMenuShared almenüit több összetett menü is megoszthatja, ha a kiszolgáló többször is meghívta OnInsertMenus. Ezért ne törölje a felülbírálás almenüinek egyikét OnRemoveMenussem; csak le kell választania őket.

További információ: IOleInPlaceFrame::RemoveMenus a Windows SDK-ban.

COleClientItem::OnScrollBy

A keretrendszer meghívta az OLE-elem görgetését a kiszolgálótól érkező kérésekre válaszul.

virtual BOOL OnScrollBy(CSize sizeExtent);

Paraméterek

sizeExtent
A képpontokban megadott távolságokat adja meg az x és az y irányba görgetéshez.

Visszaadott érték

Nonzero, ha az elemet görgették; 0, ha az elemet nem lehetett görgetni.

Megjegyzések

Ha például az OLE elem részlegesen látható, és a felhasználó a helyszíni szerkesztés közben a látható régión kívülre kerül, a program ezt a függvényt úgy hívja meg, hogy a kurzor látható maradjon. Az alapértelmezett implementáció nem végez semmit. A függvény felülbírálásával görgetheti az elemet a megadott mennyiség szerint. Vegye figyelembe, hogy a görgetés eredményeként az OLE elem látható része megváltozhat. Hívja meg a SetItemRects parancsot az elem látható téglalapjának frissítéséhez.

További információ: IOleInPlaceSite::Scroll in the Windows SDK.

COleClientItem::OnSetMenu

A keretrendszer két alkalommal hívja meg, amikor a helyszíni aktiválás megkezdődik és véget ér; az összetett menü első telepítéséhez, a második alkalommal pedig (null értékű holemenu-val ) az eltávolításhoz.

virtual void OnSetMenu(
    CMenu* pMenuShared,
    HOLEMENU holemenu,
    HWND hwndActiveObject);

Paraméterek

pMenuShared
Mutasson az OnInsertMenus tagfüggvény és a függvény hívásai által létrehozott összetett menüre InsertMenu .

holemenu
Kezelje a függvény által OleCreateMenuDescriptor visszaadott menüleírót, vagy null értéket, ha a küldő kódot el szeretné távolítani.

hwndActiveObject
Az OLE elem szerkesztési ablakának kezelése. Ez az az ablak, amely szerkesztési parancsokat fog kapni az OLE-től.

Megjegyzések

Az alapértelmezett implementáció telepíti vagy eltávolítja az összetett menüt, majd meghívja az OleSetMenuDescriptor függvényt a küldő kód telepítéséhez vagy eltávolításához. Bírálja felül ezt a függvényt, ha az alapértelmezett implementáció nem felel meg az alkalmazásnak. Ha felülbírálja ezt a függvényt, valószínűleg felül kell bírálnia az OnInsertMenus és az OnRemoveMenus parancsot is. Ez egy speciális felülírható.

További információ: OleCreateMenuDescriptor, OleSetMenuDescriptor és IOleInPlaceFrame:SetMenu a Windows SDK-ban.

COleClientItem::OnShowControlBars

A keretrendszer meghívta a tárolóalkalmazás vezérlősávjainak megjelenítésére és elrejtésére.

virtual BOOL OnShowControlBars(
    CFrameWnd* pFrameWnd,
    BOOL bShow);

Paraméterek

pFrameWnd
Mutasson a tárolóalkalmazás keretablakára. Ez lehet fő keretablak vagy MDI gyermekablak.

bShow
Meghatározza, hogy a vezérlősávok megjelenjenek vagy rejtve legyenek-e.

Visszaadott érték

Nonzero, ha a függvényhívás változást okoz a vezérlősávok állapotában; 0, ha a hívás nem okoz változást, vagy ha a pFrameWnd nem mutat a tároló keretablakára.

Megjegyzések

Ez a függvény 0 értéket ad vissza, ha a vezérlősávok már a bShow által megadott állapotban vannak. Ez például akkor fordul elő, ha a vezérlősávok rejtettek, a bShow pedig HAMIS.

Az alapértelmezett implementáció eltávolítja az eszköztárat a felső szintű keretablakból.

COleClientItem::OnShowItem

A keretrendszer meghívta az OLE-elem megjelenítésére, így teljesen láthatóvá vált a szerkesztés során.

virtual void OnShowItem();

Megjegyzések

Akkor használatos, ha a tárolóalkalmazás támogatja a beágyazott elemekre mutató hivatkozásokat (vagyis ha a dokumentumosztályt a COleLinkingDoc-ból származtatja). Ezt a függvényt a rendszer a helyszíni aktiválás során hívja meg, vagy ha az OLE-elem hivatkozásforrás, és a felhasználó szerkeszteni szeretné. Az alapértelmezett implementáció aktiválja a tárolódokumentum első nézetét. A függvény felülbírálása a dokumentum görgetéséhez, hogy az OLE elem látható legyen.

COleClientItem::OnUpdateFrameTitle

A keretrendszer a helyszíni aktiválás során hívja meg a keretablak címsorának frissítéséhez.

virtual BOOL OnUpdateFrameTitle();

Visszaadott érték

Nonzero, ha ez a függvény sikeresen frissítette a keret címét, egyébként nulla.

Megjegyzések

Az alapértelmezett implementáció nem módosítja a keretablak címét. Bírálja felül ezt a függvényt, ha egy másik keretcímet szeretne használni az alkalmazáshoz, például " kiszolgálóalkalmazás-elem - a docname-ben" (a "Microsoft Excel - spreadsheet in REPORT.DOC"). Ez egy speciális felülírható.

COleClientItem::ReactivateAndUndo

Hívja meg ezt a függvényt az OLE elem újraaktiválásához, és vonja vissza a felhasználó által a helyszíni szerkesztés során végrehajtott utolsó műveletet.

BOOL ReactivateAndUndo();

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ha a tárolóalkalmazás támogatja a visszavonási parancsot, hívja meg ezt a függvényt, ha a felhasználó közvetlenül az OLE elem inaktiválása után választja ki a visszavonási parancsot.

Ha a kiszolgálóalkalmazás a Microsoft Foundation osztálykódtárakkal van megírva, a függvény hatására a kiszolgáló meghívja a COleServerDoc::OnReactivateAndUndo parancsot.

További információ: IOleInPlaceObject::ReactivateAndUndo a Windows SDK-ban.

COleClientItem::Release

Hívja meg ezt a függvényt az OLE elem által használt erőforrások törléséhez.

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

Release a destruktor hívja COleClientItem meg.

További információ: IUnknown::Release in the Windows SDK.

COleClientItem::Reload

Bezárja és újra betölti az elemet.

BOOL Reload();

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Hívja meg a függvényt, Reload miután aktiválta az elemet egy másik típusú elemként az ActivateAs hívásával.

COleClientItem::Futtatás

Futtatja az elemhez társított alkalmazást.

void Run();

Megjegyzések

Az elem aktiválása előtt hívja meg a Run tagfüggvényt a kiszolgálóalkalmazás elindításához. Ezt automatikusan az Aktiválás és a DoVerb végzi, ezért általában nem szükséges meghívni ezt a függvényt. Hívja meg ezt a függvényt, ha a DoVerb végrehajtása előtt szükség van a kiszolgáló futtatására egy elemattribútum (például SetExtent) beállításához.

COleClientItem::SetDrawAspect

Hívja meg a SetDrawAspect tagfüggvényt az elem "aspektusának" vagy nézetének beállításához.

virtual void SetDrawAspect(DVASPECT nDrawAspect);

Paraméterek

nDrawAspect
A DVASPECT enumerálásából származó érték. Ez a paraméter a következő értékek egyikével rendelkezhet:

• DVASPECT_CONTENT Elem úgy van ábrázolva, hogy beágyazott objektumként jelenjen meg a tárolóban.

• DVASPECT_THUMBNAIL Elem "miniatűr" ábrázolásban jelenik meg, hogy megjeleníthető legyen egy böngészési eszközben.

• DVASPECT_ICON elemet egy ikon jelöli.

• DVASPECT_DOCPRINT Elem úgy jelenik meg, mintha a Fájl menü Nyomtatás parancsával lett volna kinyomtatva.

Megjegyzések

A szempont azt határozza meg, hogyan jelenik meg az elem a Rajzolással , ha a függvény nDrawAspect argumentumának alapértelmezett értéke van használatban.

Ezt a függvényt automatikusan meghívja a Change Icon (és más párbeszédpanelek, amelyek közvetlenül a Change Icon párbeszédpanelt hívják), hogy engedélyezze az ikonikus megjelenítési szempontot, amikor a felhasználó kéri.

COleClientItem::SetExtent

A függvény meghívásával megadhatja, hogy mennyi hely áll rendelkezésre az OLE elem számára.

void SetExtent(
    const CSize& size,
    DVASPECT nDrawAspect = DVASPECT_CONTENT);

Paraméterek

méret
A méretadatokat tartalmazó CSize objektum.

nDrawAspect
Annak az OLE-elemnek a aspektusát adja meg, amelynek a határait be kell állítani. A lehetséges értékekért lásd: SetDrawAspect.

Megjegyzések

Ha a kiszolgálóalkalmazás a Microsoft Foundation osztálykönyvtárával lett megírva, a rendszer meghívja a megfelelő objektum COleServerItem tagfüggvényét. Az OLE elem ezután ennek megfelelően módosíthatja a megjelenítést. A méreteknek MM_HIMETRIC egységekben kell lenniük. Hívja meg ezt a függvényt, ha a felhasználó átméretezi az OLE elemet, vagy ha támogatja az elrendezés egyeztetésének valamilyen formáját.

További információ: IOleObject::SetExtent a Windows SDK-ban.

COleClientItem::SetHostNames

A függvény meghívásával adja meg a tárolóalkalmazás nevét és egy beágyazott OLE-elem tárolónevét.

void SetHostNames(
    LPCTSTR lpszHost,
    LPCTSTR lpszHostObj);

Paraméterek

lpszHost
Mutasson a tárolóalkalmazás felhasználó által látható nevére.

lpszHostObj
Mutasson az OLE elemet tartalmazó tároló azonosító sztringére.

Megjegyzések

Ha a kiszolgálóalkalmazás a Microsoft Foundation osztálytárával lett megírva, ez a függvény meghívja az OLE elemet tartalmazó dokumentum OnSetHostNames tagfüggvényét COleServerDoc . Ezt az információt az OLE-elem szerkesztésekor használják az ablakcímekben. A tárolódokumentum minden betöltésekor a keretrendszer meghívja ezt a függvényt a dokumentum összes OLE-eleméhez. SetHostNames csak beágyazott elemekre vonatkozik. Nem szükséges meghívni ezt a függvényt minden alkalommal, amikor egy beágyazott OLE-elem aktiválódik szerkesztésre.

Ezt a rendszer automatikusan meghívja az alkalmazás nevével és a dokumentum nevével, amikor egy objektum betöltődik, vagy ha egy fájl más néven van mentve. Ennek megfelelően általában nem szükséges közvetlenül meghívni ezt a függvényt.

További információ: IOleObject::SetHostNames a Windows SDK-ban.

COleClientItem::SetIconicMetafile

Gyorsítótárazza az elem ikonjának rajzolásához használt metafájlt.

BOOL SetIconicMetafile(HGLOBAL hMetaPict);

Paraméterek

hMetaPict
Az elem ikonjának rajzolásához használt metafájl leírója.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

A metafájl lekéréséhez használja a GetIconicMetafile fájlt .

A hMetaPict paramétert a rendszer az elembe másolja; ezért a hMetaPict-et a hívónak kell felszabadítania.

COleClientItem::SetItemRects

Hívja meg ezt a függvényt az OLE elem határolókeretének vagy látható téglalapjának beállításához.

BOOL SetItemRects(
    LPCRECT lpPosRect = NULL,
    LPCRECT lpClipRect = NULL);

Paraméterek

lprcPosRect
Mutasson arra a téglalapra, amely az OLE elemnek a szülőablakhoz viszonyított határait tartalmazza ügyfélkoordinátákban.

lprcClipRect
Mutasson arra a téglalapra, amely az OLE elem látható részének a szülőablakhoz viszonyított határait tartalmazza ügyfélkoordinátákban.

Visszaadott érték

Nonzero, ha sikeres; ellenkező esetben 0.

Megjegyzések

Ezt a függvényt az OnChangeItemPosition tagfüggvény alapértelmezett implementációja hívja meg. Ezt a függvényt akkor kell meghívni, amikor az OLE-elem pozíciója vagy látható része megváltozik. Ez általában azt jelenti, hogy a nézet OnSize és OnScrollBy tagfüggvényeiből hívja meg.

További információ: IOleInPlaceObject::SetObjectRects a Windows SDK-ban.

COleClientItem::SetLinkUpdateOptions

Hívja meg ezt a függvényt a megadott csatolt elem bemutatójának hivatkozásfrissítési beállításának beállításához.

void SetLinkUpdateOptions(OLEUPDATE dwUpdateOpt);

Paraméterek

dwUpdateOpt
Az elem hivatkozásfrissítési lehetőségének értéke. Ennek az értéknek a következők egyikének kell lennie:

• OLEUPDATE_ALWAYS Frissítse a csatolt elemet, amikor csak lehetséges. Ez a beállítás a Hivatkozások párbeszédpanel Automatikus hivatkozásfrissítés választógombjának használatát támogatja.

• OLEUPDATE_ONCALL Csak a tárolóalkalmazás kérése alapján frissítse a csatolt elemet (amikor az UpdateLink tagfüggvényt meghívja). Ez a beállítás támogatja a Kézi hivatkozásfrissítés választógombot a Hivatkozások párbeszédpanelen.

Megjegyzések

A Hivatkozások párbeszédpanelen általában nem szabad módosítania a felhasználó által választott frissítési beállításokat.

További információ: IOleLink::SetUpdateOptions a Windows SDK-ban.

COleClientItem::SetPrintDevice

Hívja meg ezt a függvényt az elem nyomtatási céleszközének módosításához.

BOOL SetPrintDevice(const DVTARGETDEVICE* ptd);
BOOL SetPrintDevice(const PRINTDLG* ppd);

Paraméterek

ptd
Mutasson egy DVTARGETDEVICE adatstruktúrára, amely az új nyomtatási céleszköz adatait tartalmazza. Null érték is lehet.

Ppd
Mutasson egy PRINTDLG adatstruktúrára, amely az új nyomtatási céleszközre vonatkozó információkat tartalmazza. Null érték is lehet.

Visszaadott érték

Nonzero, ha a függvény sikeres volt; egyéb esetben 0.

Megjegyzések

Ez a függvény frissíti az elem nyomtatási céleszközét, de nem frissíti a bemutató gyorsítótárát. Egy elem bemutató-gyorsítótárának frissítéséhez hívja meg az UpdateLinket.

A függvény argumentumai olyan információkat tartalmaznak, amelyeket az OLE rendszer a céleszköz azonosítására használ. A PRINTDLG struktúra olyan információkat tartalmaz, amelyeket a Windows a közös Nyomtatás párbeszédpanel inicializálásához használ. Miután a felhasználó bezárta a párbeszédpanelt, a Windows visszaadja az ebben a struktúrában kijelölt felhasználó adatait. A m_pd objektum tagja egy PRINTDLG szerkezet.

Erről a struktúráról a Windows SDK PRINTDLG-jében talál további információt.

További információ: DVTARGETDEVICE a Windows SDK-ban.

COleClientItem::UpdateLink

Hívja meg ezt a függvényt az OLE-elem bemutatóadatainak azonnali frissítéséhez.

BOOL UpdateLink();

Visszaadott érték

Nonzero a siker; egyéb esetben 0.

Megjegyzések

Csatolt elemek esetén a függvény megkeresi a hivatkozás forrását, hogy beolvasson egy új bemutatót az OLE-elemhez. Ez a folyamat egy vagy több kiszolgálóalkalmazás futtatásával járhat, ami időigényes lehet. Beágyazott elemek esetén a függvény rekurzív módon működik, és ellenőrzi, hogy a beágyazott elem tartalmaz-e elavult hivatkozásokat, és frissíti őket. A felhasználó manuálisan is frissítheti az egyes hivatkozásokat a Hivatkozások párbeszédpanelen.

További információ: IOleLink::Update a Windows SDK-ban.

Lásd még

MFC-minta MFCBIND
MFC-minta OCLIENT
CDocItem osztály
hierarchiadiagram
COleServerItem osztály