Sdílet prostřednictvím

COleInsertDialog – třída

  • Článek

Používá se pro dialogové okno OLE Vložit objekt.

Syntaxe

class COleInsertDialog : public COleDialog

Členové

Veřejné konstruktory

Název Popis
COleInsertDialog::COleInsertDialog COleInsertDialog Vytvoří objekt.

Veřejné metody

Název Popis
COleInsertDialog::CreateItem Vytvoří položku vybranou v dialogovém okně.
COleInsertDialog::D oModal Zobrazí dialogové okno OLE Vložit objekt.
COleInsertDialog::GetClassID Získá CLSID přidružené k vybrané položce.
COleInsertDialog::GetDrawAspect Určuje, jestli má být položka nakreslená jako ikona.
COleInsertDialog::GetIconicMetafile Získá popisovač metasouboru asociované s ikonickou formou této položky.
COleInsertDialog::GetPathName Získá úplnou cestu k souboru vybranému v dialogovém okně.
COleInsertDialog::GetSelectionType Získá typ vybraného objektu.

Veřejné datové členy

Název Popis
COleInsertDialog::m_io Struktura typu OLEUIINSERTOBJECT, která řídí chování dialogového okna.

Poznámky

Pokud chcete volat toto dialogové okno, vytvořte objekt třídy COleInsertDialog . COleInsertDialog Po vytvoření objektu můžete pomocí struktury m_io inicializovat hodnoty nebo stavy ovládacích prvků v dialogovém okně. Struktura m_io je typu OLEUIINSERTOBJECT. Další informace o použití této třídy dialogového okna naleznete v části DoModal členské funkce.

Poznámka:

Tento kód kontejneru vygenerovaný Průvodce aplikací používá tuto třídu.

Další informace naleznete v OLEUIINSERTOBJECT struktury v sadě Windows SDK.

Další informace o dialogových oknech specifických pro OLE naleznete v článku Dialogová okna v OLE.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleInsertDialog

Požadavky

Hlavička: afxodlgs.h

COleInsertDialog::COleInsertDialog

Tato funkce vytváří pouze COleInsertDialog objekt.

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

Parametry

dwFlags
Příznak vytvoření, který obsahuje libovolný počet následujících hodnot, které se mají zkombinovat pomocí bitového operátoru OR:

  • IOF_SHOWHELP Určuje, že se při zavolání dialogového okna zobrazí tlačítko Nápověda.

  • IOF_SELECTCREATENEW Určuje, že při zavolání dialogového okna bude vybráno přepínač Vytvořit nový. Toto je výchozí hodnota a nelze ji použít s IOF_SELECTCREATEFROMFILE.

  • IOF_SELECTCREATEFROMFILE Určuje, že při zavolání dialogového okna se na začátku vybere přepínač Vytvořit ze souboru. Nelze použít s IOF_SELECTCREATENEW.

  • IOF_CHECKLINK Určuje, že při zavolání dialogového okna bude zaškrtnuto políčko Propojit.

  • IOF_DISABLELINK Určuje, že po zavolání dialogového okna bude zaškrtávací políčko Propojení zakázáno.

  • IOF_CHECKDISPLAYASICON Určuje, že se na začátku zaškrtne políčko Zobrazit jako ikonu, zobrazí se aktuální ikona a po zavolání dialogového okna se povolí tlačítko Změnit ikonu.

  • IOF_VERIFYSERVERSEXIST Určuje, že dialogové okno by mělo ověřit třídy, které přidá do seznamu, tím, že zajistí, aby servery zadané v registrační databázi existovaly před zobrazením dialogového okna. Nastavení tohoto příznaku může výrazně ovlivnit výkon.

pParentWnd
Odkazuje na objekt okna nadřazeného nebo vlastníka (typu CWnd), do kterého objekt dialogového okna patří. Pokud má hodnotu NULL, nadřazené okno objektu dialogového okna je nastaveno na hlavní okno aplikace.

Poznámky

Dialogové okno zobrazíte voláním funkce DoModal .

COleInsertDialog::CreateItem

Voláním této funkce vytvořte objekt typu COleClientItem pouze v případě, že DoModal vrátí IDOK.

BOOL CreateItem(COleClientItem* pItem);

Parametry

pItem
Odkazuje na položku, která se má vytvořit.

Návratová hodnota

Nenulové, pokud byla vytvořena položka; jinak 0.

Poznámky

Před voláním COleClientItem této funkce musíte objekt přidělit.

COleInsertDialog::D oModal

Voláním této funkce zobrazíte dialogové okno OLE Vložit objekt.

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parametry

dwFlags
Jedna z následujících hodnot:

COleInsertDialog::DocObjectsOnly vloží jenom Objekty DocObject.

COleInsertDialog::ControlsOnly vloží pouze ovládací prvky ActiveX.

Nula nevloží žádný objekt DocObject ani ovládací prvek ActiveX. Výsledkem této hodnoty je stejná implementace jako první prototyp uvedený výše.

Návratová hodnota

Stav dokončení dialogového okna Jedna z následujících hodnot:

  • IdOK, pokud se dialogové okno úspěšně zobrazilo.

  • IDCANCEL pokud uživatel zrušil dialogové okno.

  • IDABORT, pokud došlo k chybě. Pokud se vrátí funkce IDABORT, zavolejte funkci člena COleDialog::GetLastError a získejte další informace o typu chyby, ke které došlo. Seznammožnýchch

Poznámky

Pokud chcete inicializovat různé ovládací prvky dialogového okna nastavením členů struktury m_io , měli byste to udělat před voláním DoModal, ale po vytvoření objektu dialogového okna.

Pokud DoModal vrátí idOK, můžete volat další členské funkce, které načtou nastavení nebo informace zadané do dialogového okna uživatelem.

COleInsertDialog::GetClassID

Voláním této funkce získáte CLSID přidružené k vybrané položce pouze v případě, že DoModal vrátí IDOK a typ výběru je COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Návratová hodnota

Vrátí CLSID přidružené k vybrané položce.

Poznámky

Další informace najdete v tématu KLÍČ CLSID v sadě Windows SDK.

COleInsertDialog::GetDrawAspect

Voláním této funkce určíte, jestli se uživatel rozhodl zobrazit vybranou položku jako ikonu.

DVASPECT GetDrawAspect() const;

Návratová hodnota

Metoda potřebná k vykreslení objektu.

  • DVASPECT_CONTENT Vráceno, pokud není zaškrtnuté políčko Zobrazit jako ikonu.

  • DVASPECT_ICON Vráceno, pokud bylo zaškrtnuto políčko Zobrazit jako ikonu.

Poznámky

Volání této funkce pouze v případě, že DoModal vrátí IDOK.

Další informace o aspektu výkresu naleznete v tématu FORMATETC datové struktury v sadě Windows SDK.

COleInsertDialog::GetIconicMetafile

Voláním této funkce získáte popisovač metasouboru, který obsahuje ikonický aspekt vybrané položky.

HGLOBAL GetIconicMetafile() const;

Návratová hodnota

Popisovač metasouboru obsahující ikonický aspekt vybrané položky, pokud bylo při zavření dialogového okna zaškrtnuté políčko Zobrazit jako ikonu; jinak NULL.

COleInsertDialog::GetPathName

Voláním této funkce získáte úplnou cestu k vybranému souboru pouze v případě, že DoModal vrátí IDOK a typ výběru není COleInsertDialog::createNewItem.

CString GetPathName() const;

Návratová hodnota

Úplná cesta k souboru vybranému v dialogovém okně. Pokud je createNewItemtyp výběru, vrátí tato funkce v režimu vydání smysl nebo CString způsobí kontrolní výraz v režimu ladění.

COleInsertDialog::GetSelectionType

Voláním této funkce získáte typ výběru vybraný při zavření dialogového okna Vložit objekt výběrem tlačítka OK.

UINT GetSelectionType() const;

Návratová hodnota

Typ výběru.

Poznámky

Hodnoty návratového typu jsou určeny typem výčtu Selection deklarovaným ve COleInsertDialog třídě.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Stručný popis těchto hodnot:

  • COleInsertDialog::createNewItem Bylo vybráno přepínač Vytvořit nový.

  • COleInsertDialog::insertFromFile Přepínač Vytvořit ze souboru byl vybrán a políčko Propojit nebylo zaškrtnuté.

  • COleInsertDialog::linkToFile Přepínač Vytvořit ze souboru byl vybrán a políčko Propojit bylo zaškrtnuto.

COleInsertDialog::m_io

Struktura typu OLEUIINSERTOBJECT použitá k řízení chování dialogového okna Vložit objekt.

OLEUIINSERTOBJECT m_io;

Poznámky

Členy této struktury lze upravit buď přímo, nebo prostřednictvím členských funkcí.

Další informace naleznete v OLEUIINSERTOBJECT struktury v sadě Windows SDK.

Viz také

MFC – ukázka OCLIENT
COleDialog – třída
Graf hierarchie
COleDialog – třída