Sdílet prostřednictvím

COleConvertDialog – třída

  • Článek

Další informace naleznete ve struktuře OLEUICONVERT v sadě Windows SDK.

Syntaxe

class COleConvertDialog : public COleDialog

Členové

Veřejné konstruktory

Jméno popis
COleConvertDialog::COleConvertDialog COleConvertDialog Vytvoří objekt.

Veřejné metody

Jméno popis
COleConvertDialog::D oConvert Provede převod zadaný v dialogovém okně.
COleConvertDialog::D oModal Zobrazí dialogové okno OLE Změnit položku.
COleConvertDialog::GetClassID Získá CLSID přidružené k vybrané položce.
COleConvertDialog::GetDrawAspect Určuje, jestli se má položka kreslit jako ikona.
COleConvertDialog::GetIconicMetafile Získá popisovač metasouboru asociované s ikonickou formou této položky.
COleConvertDialog::GetSelectionType Získá vybraný typ výběru.

Veřejné datové členy

Jméno popis
COleConvertDialog::m_cv Struktura, která řídí chování dialogového okna.

Poznámky

Poznámka

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

Další informace o dialogovýchoch

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

Cdialog

CCommonDialog

COleDialog

COleConvertDialog

Požadavky

Hlavička: afxodlgs.h

COleConvertDialog::COleConvertDialog

Vytvoří pouze COleConvertDialog objekt.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Parametry

pItem
Odkazuje na položku, která se má převést nebo aktivovat.

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

  • CF_SELECTCONVERTTO Určuje, že při zavolání dialogového okna bude vybráno přepínač Převést na. Tato možnost je výchozí.

  • CF_SELECTACTIVATEAS Určuje, že při zavolání dialogového okna bude vybráno přepínač Aktivovat jako.

  • CF_SETCONVERTDEFAULT Určuje, že třída, jejíž CLSID je určen clsidConvertDefault členem m_cv struktury, bude použita jako výchozí výběr v seznamu tříd, když je vybrán přepínač Převést na.

  • CF_SETACTIVATEDEFAULT Určuje, že třída, jejíž CLSID je určen clsidActivateDefault členem m_cv struktury, bude použita jako výchozí výběr v seznamu tříd, když je vybrán přepínač Aktivovat jako.

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

pClassID
Odkazuje na CLSID položky, která se má převést nebo aktivovat. Pokud má hodnotu NULL, použije se CLSID přidružené k pItem .

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

Poznámky

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

Další informace naleznete v tématu CLSID Klíč a OLEUICONVERT struktury.

COleConvertDialog::D oConvert

Volání této funkce po úspěšném vrácení z DoModal, buď převést nebo aktivovat objekt typu COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Parametry

pItem
Odkazuje na položku, která se má převést nebo aktivovat. Nesmí mít hodnotu NULL.

Vrácená hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Položka je převedena nebo aktivována podle informací vybraných uživatelem v dialogovém okně Převést.

COleConvertDialog::D oModal

Voláním této funkce zobrazíte dialogové okno Převést OLE.

virtual INT_PTR DoModal();

Vrácená 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_cv , 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, které uživatel zadal do dialogového okna.

COleConvertDialog::GetClassID

Voláním této funkce získáte CLSID přidružené k položce, kterou uživatel vybral v dialogovém okně Převést.

REFCLSID GetClassID() const;

Vrácená hodnota

CLSID přidružené k položce, která byla vybrána v dialogovém okně Převést.

Poznámky

Volání této funkce pouze po doModal vrátí IDOK.

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

COleConvertDialog::GetDrawAspect

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

DVASPECT GetDrawAspect() const;

Vrácená 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 po doModal vrátí IDOK.

Další informace o aspektu výkresu naleznete v datové struktuře FORMATETC v sadě Windows SDK.

COleConvertDialog::GetIconicMetafile

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

HGLOBAL GetIconicMetafile() const;

Vrácená 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.

COleConvertDialog::GetSelectionType

Voláním této funkce určíte typ převodu vybraný v dialogovém okně Převést.

UINT GetSelectionType() const;

Vrácená hodnota

Typ výběru.

Poznámky

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

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Stručný popis těchto hodnot:

  • COleConvertDialog::noConversion Vrátí se, pokud bylo dialogové okno zrušeno nebo uživatel vybral žádný převod. Pokud COleConvertDialog::DoModal se vrátí idOK, je možné, že uživatel vybral jinou ikonu než dříve vybranou.

  • COleConvertDialog::convertItem Vrátí se, pokud bylo zaškrtnuto přepínač Převést na, uživatel vybral jinou položku, na kterou se má převést, a DoModal vrátil IDOK.

  • COleConvertDialog::activateAs Vráceno, pokud bylo zaškrtnuto přepínač Aktivovat jako, uživatel vybral jinou položku k aktivaci a DoModal vrátil IDOK.

COleConvertDialog::m_cv

Struktura typu OLEUICONVERT použitá k řízení chování dialogového okna Převést.

OLEUICONVERT m_cv;

Poznámky

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

Další informace naleznete ve struktuře OLEUICONVERT v sadě Windows SDK.

Viz také

COleDialog – třída
Graf hierarchie
COleDialog – třída