COleChangeIconDialog – třída

Používá se pro dialogové okno OLE Změnit ikonu.

Syntaxe

class COleChangeIconDialog : public COleDialog

Členové

Veřejné konstruktory

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

Veřejné metody

Jméno	popis
COleChangeIconDialog::D oChangeIcon	Provede změnu zadanou v dialogovém okně.
COleChangeIconDialog::D oModal	Zobrazí dialogové okno OLE 2 Změnit ikonu.
COleChangeIconDialog::GetIconicMetafile	Získá popisovač metasouboru asociované s ikonickou formou této položky.

Veřejné datové členy

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

Poznámky

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

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

Další informace o dialogovýchoch

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

Cdialog

CCommonDialog

COleDialog

COleChangeIconDialog

Požadavky

Hlavička: afxodlgs.h

COleChangeIconDialog::COleChangeIconDialog

Tato funkce vytváří pouze COleChangeIconDialog objekt.

explicit COleChangeIconDialog(
    COleClientItem* pItem,
    DWORD dwFlags = CIF_SELECTCURRENT,
    CWnd* pParentWnd = NULL);

Parametry

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

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:

• CIF_SELECTCURRENT Určuje, že při zavolání dialogového okna bude vybráno tlačítko Aktuální přepínač. Tato možnost je výchozí.

• CIF_SELECTDEFAULT Určuje, že při zavolání dialogového okna bude vybráno výchozí přepínač.

• CIF_SELECTFROMFILE Určuje, že při zavolání dialogového okna se na začátku vybere přepínač Ze souboru.

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

• CIF_USEICONEXE Určuje, že ikona se má extrahovat ze spustitelného souboru zadaného v szIconExe poli m_ci místo načtení z typu. To je užitečné pro vkládání nebo propojení se soubory jiného typu než OLE.

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 bude nastaveno na hlavní okno aplikace.

Poznámky

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

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

COleChangeIconDialog::D oChangeIcon

Voláním této funkce změníte ikonu představující položku na položku vybranou v dialogovém okně poté, co DoModal vrátí IDOK.

BOOL DoChangeIcon(COleClientItem* pItem);

Parametry

pItem
Odkazuje na položku, jejíž ikona se mění.

Vrácená hodnota

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

COleChangeIconDialog::D oModal

Voláním této funkce zobrazíte dialogové okno Ole Change Icon.

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 COleDialog::GetLastError členovu funkci a získejte další informace o typu chyby, ke které došlo. Seznam možných chyb naleznete v oleUIChangeIcon funkce v sadě Windows SDK.

Poznámky

Pokud chcete inicializovat různé ovládací prvky dialogového okna nastavením členů struktury m_ci , 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.

COleChangeIconDialog::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, který obsahuje ikonický aspekt nové ikony, pokud bylo dialogové okno zamítnuto, zvolte OK. V opačném případě se ikona zobrazovala před zobrazením dialogového okna.

COleChangeIconDialog::m_ci

Struktura typu OLEUICHANGEICON použitá k řízení chování dialogového okna Změnit ikonu.

OLEUICHANGEICON m_ci;

Poznámky

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

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

Viz také

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