COleChangeIconDialog – třída
Používá se pro dialogové okno OLE Změnit ikonu.
Syntaxe
class COleChangeIconDialog : public COleDialog
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| COleChangeIconDialog::COleChangeIconDialog | COleChangeIconDialog Vytvoří objekt. |
Veřejné metody
| Název | 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
| Název | 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
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
szIconExepoli 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í.
Návratová 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();
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
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;
Návratová 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.