Megosztás a következőn keresztül:

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

Az OLE Objektum beszúrása párbeszédpanelhez használható.

Szemantika

class COleInsertDialog : public COleDialog

Tagok

Nyilvános konstruktorok

Név Description
COleInsertDialog::COleInsertDialog Egy COleInsertDialog objektumot hoz létre.

Nyilvános metódusok

Név Description
COleInsertDialog::CreateItem Létrehozza a párbeszédpanelen kijelölt elemet.
COleInsertDialog::D oModal Megjeleníti az OLE Objektum beszúrása párbeszédpanelt.
COleInsertDialog::GetClassID Lekéri a kiválasztott elemhez társított CLSID azonosítót.
COleInsertDialog::GetDrawAspect Jelzi, hogy az elemet ikonként kell-e rajzolni.
COleInsertDialog::GetIconicMetafile Lekéri az elem ikonikus formájához társított metafájl leíróját.
COleInsertDialog::GetPathName Lekéri a párbeszédpanelen kiválasztott fájl teljes elérési útját.
COleInsertDialog::GetSelectionType Kiválasztja az objektum típusát.

Nyilvános adatok tagjai

Név Description
COleInsertDialog::m_io Az OLEUIINSERTOBJECT típusú struktúra, amely szabályozza a párbeszédpanel működését.

Megjegyzések

Hozzon létre egy osztályobjektumot COleInsertDialog , amikor meg szeretné hívni ezt a párbeszédpanelt. Az COleInsertDialog objektum létrehozása után a m_io szerkezettel inicializálhatja a párbeszédpanel vezérlőinek értékeit vagy állapotát. A m_io struktúra OLEUIINSERTOBJECT típusú. A párbeszédpanel-osztály használatáról további információt a DoModal tagfüggvényben talál.

Megjegyzés:

Az alkalmazásvarázsló által létrehozott tárolókód ezt az osztályt használja.

További információ: OLEUIINSERTOBJECT struktúra a Windows SDK-ban.

Az OLE-specifikus párbeszédpanelekkel kapcsolatos további információkért lásd az OLE párbeszédpanelek című cikket.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleInsertDialog

Requirements

Fejléc: afxodlgs.h

COleInsertDialog::COleInsertDialog

Ez a függvény csak egy objektumot COleInsertDialog hoz létre.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Paraméterek

dwFlags
A bitenkénti VAGY operátorral kombinálandó alábbi értékek tetszőleges számát tartalmazó létrehozási jelző:

  • IOF_SHOWHELP Megadja, hogy a párbeszédpanel meghívásakor a Súgó gomb jelenik meg.

  • IOF_SELECTCREATENEW Megadja, hogy a párbeszédpanel meghívásakor először az Új választógomb legyen kiválasztva. Ez az alapértelmezett beállítás, és nem használható IOF_SELECTCREATEFROMFILE.

  • IOF_SELECTCREATEFROMFILE Megadja, hogy a párbeszédpanel meghívásakor először a Create From File választógomb legyen kiválasztva. A IOF_SELECTCREATENEW nem használható.

  • IOF_CHECKLINK Megadja, hogy a hivatkozás jelölőnégyzet kezdetben be legyen jelölve a párbeszédpanel meghívásakor.

  • IOF_DISABLELINK Megadja, hogy a párbeszédpanel meghívásakor a Hivatkozás jelölőnégyzet le lesz tiltva.

  • IOF_CHECKDISPLAYASICON Megadja, hogy a Megjelenítés ikonként jelölőnégyzet kezdetben be legyen jelölve, megjelenik az aktuális ikon, és a párbeszédpanel meghívásakor engedélyezve lesz az Ikon módosítása gomb.

  • IOF_VERIFYSERVERSEXIST Azt határozza meg, hogy a párbeszédpanelnek ellenőriznie kell a listamezőbe felvett osztályokat, és győződjön meg arról, hogy a regisztrációs adatbázisban megadott kiszolgálók léteznek a párbeszédpanel megjelenése előtt. A jelző beállítása jelentősen ronthatja a teljesítményt.

pParentWnd
Arra a szülő- vagy tulajdonosablak-objektumra mutat (típus CWnd), amelyhez a párbeszédpanel-objektum tartozik. Null érték esetén a párbeszédpanel-objektum szülőablaka a fő alkalmazásablakra van állítva.

Megjegyzések

A párbeszédpanel megjelenítéséhez hívja meg a DoModal függvényt.

COleInsertDialog::CreateItem

A függvény meghívásával csak akkor hozzon létre egy COleClientItem típusú objektumot, ha a DoModal idOK-ot ad vissza.

BOOL CreateItem(COleClientItem* pItem);

Paraméterek

pItem
A létrehozandó elemre mutat.

Visszaadott érték

Nemzero, ha az elem létrejött; egyéb esetben 0.

Megjegyzések

A függvény meghívása előtt le kell foglalnia az COleClientItem objektumot.

COleInsertDialog::D oModal

Hívja meg ezt a függvényt az OLE Objektum beszúrása párbeszédpanel megjelenítéséhez.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Paraméterek

dwFlags
Az alábbi értékek egyike:

COleInsertDialog::DocObjectsOnly csak DocObject-eket szúr be.

COleInsertDialog::ControlsOnly csak ActiveX-vezérlőket szúr be.

A Nulla nem szúr be sem DocObjectet, sem ActiveX-vezérlőt. Ez az érték ugyanazt a megvalósítást eredményezi, mint a fent felsorolt első prototípus.

Visszaadott érték

A párbeszédpanel befejezési állapota. Az alábbi értékek egyike:

  • IDOK, ha a párbeszédpanel sikeresen megjelent.

  • IDCANCEL, ha a felhasználó megszakította a párbeszédpanelt.

  • IDABORT, ha hiba történt. Ha IDABORT-t ad vissza, hívja meg a COleDialog::GetLastError tagfüggvényt, hogy további információt kapjon a hiba típusáról. A lehetséges hibák listáját a Windows SDK OleUIInsertObject függvényében talál.

Megjegyzések

Ha a m_io szerkezet tagjainak beállításával szeretné inicializálni a különböző párbeszédpanel-vezérlőket, ezt a hívás DoModalelőtt, de a párbeszédpanel-objektum létrehozása után kell elvégeznie.

Ha DoModal IDOK-t ad vissza, meghívhat más tagfüggvényeket, hogy lekérje a beállításokat vagy az információbevitelt a párbeszédpanelen a felhasználó által.

COleInsertDialog::GetClassID

Hívja meg ezt a függvényt, hogy csak akkor kérje le a kijelölt elemhez társított CLSID-t, ha a DoModal idOK-ot ad vissza, a kijelölés típusa pedig az COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Visszaadott érték

A kijelölt elemhez társított CLSID-t adja vissza.

Megjegyzések

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

COleInsertDialog::GetDrawAspect

Hívja meg ezt a függvényt annak megállapításához, hogy a felhasználó a kijelölt elem ikonként való megjelenítését választotta-e.

DVASPECT GetDrawAspect() const;

Visszaadott érték

Az objektum megjelenítéséhez szükséges metódus.

  • DVASPECT_CONTENT Vissza, ha a Megjelenítés ikonként jelölőnégyzet nincs bejelölve.

  • DVASPECT_ICON Vissza lett adva, ha a Megjelenítés ikonként jelölőnégyzet be van jelölve.

Megjegyzések

Ezt a függvényt csak akkor hívja meg, ha a DoModal idOK-ot ad vissza.

A rajz aspektusával kapcsolatos további információkért lásd: FORMATETC adatstruktúra a Windows SDK-ban.

COleInsertDialog::GetIconicMetafile

Hívja meg ezt a függvényt, hogy lekérje a kijelölt elem ikonikus elemét tartalmazó metafájl leíróját.

HGLOBAL GetIconicMetafile() const;

Visszaadott érték

A kijelölt elem ikonikus elemét tartalmazó metafájlhoz tartozó fogópont, ha a párbeszédpanel bezárásakor a Megjelenítés ikonként jelölőnégyzet be van jelölve az OK gombra kattintva; ellenkező esetben NULL.

COleInsertDialog::GetPathName

Hívja meg ezt a függvényt, hogy csak akkor kérje le a kijelölt fájl teljes elérési útját, ha a DoModal idOK-ot ad vissza, és a kijelölés típusa nem COleInsertDialog::createNewItem.

CString GetPathName() const;

Visszaadott érték

A párbeszédpanelen kijelölt fájl teljes elérési útja. Ha a kijelölés típusa az createNewItem, akkor ez a függvény a kiadási módban értelmetlen CString értéket ad vissza, vagy hibakeresési módban állít elő állítást.

COleInsertDialog::GetSelectionType

Hívja meg ezt a függvényt, hogy az OK gombra kattintva kérje le az Objektum beszúrása párbeszédpanel bezárásakor kiválasztott kijelöléstípust.

UINT GetSelectionType() const;

Visszaadott érték

A kiválasztott elem típusa.

Megjegyzések

A visszatérési típus értékeit az Selection osztályban deklarált enumerálási COleInsertDialog típus adja meg.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Az értékek rövid leírása a következő:

  • COleInsertDialog::createNewItem Ki lett jelölve az Új választógomb.

  • COleInsertDialog::insertFromFile A Létrehozás fájlból választógomb be van jelölve, és a Hivatkozás jelölőnégyzet nincs bejelölve.

  • COleInsertDialog::linkToFile Be van jelölve a Létrehozás fájlból választógomb, és be van jelölve a Hivatkozás jelölőnégyzet.

COleInsertDialog::m_io

Az Objektum beszúrása párbeszédpanel viselkedésének szabályozásához használt OLEUIINSERTOBJECT típusú struktúra.

OLEUIINSERTOBJECT m_io;

Megjegyzések

A struktúra tagjai közvetlenül vagy tagfüggvényekkel módosíthatók.

További információ: OLEUIINSERTOBJECT struktúra a Windows SDK-ban.

Lásd még

MFC-minta OCLIENT
COleDialog osztály
hierarchiadiagram
COleDialog osztály

  • Last updated on