COlePropertiesDialog – třída
Zapouzdřuje společné dialogové okno Vlastnosti objektu OLE systému Windows.
Syntaxe
class COlePropertiesDialog : public COleDialog
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| COlePropertiesDialog::COlePropertiesDialog | COlePropertiesDialog Vytvoří objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| COlePropertiesDialog::D oModal | Zobrazí dialogové okno a umožní uživateli provést výběr. |
| COlePropertiesDialog::OnApplyScale | Volá se rozhraním při změně měřítka položky dokumentu. |
Veřejné datové členy
| Název | Popis |
|---|---|
| COlePropertiesDialog::m_gp | Struktura použitá k inicializaci stránky "Obecné" objektu COlePropertiesDialog . |
| COlePropertiesDialog::m_lp | Struktura použitá k inicializaci stránky "Odkaz" objektu COlePropertiesDialog . |
| COlePropertiesDialog::m_op | Struktura použitá k inicializaci objektu COlePropertiesDialog . |
| COlePropertiesDialog::m_psh | Struktura používaná k přidání dalších stránek vlastních vlastností. |
| COlePropertiesDialog::m_vp | Struktura použitá k přizpůsobení stránky Zobrazení objektu COlePropertiesDialog . |
Poznámky
Společná dialogová okna Vlastnosti objektu OLE poskytují snadný způsob, jak zobrazit a upravit vlastnosti položky dokumentu OLE způsobem konzistentním se standardy Systému Windows. Mezi tyto vlastnosti patří mimo jiné informace o souboru reprezentovaného položkou dokumentu, možnosti zobrazení ikony a měřítka obrázku a informace o odkazu na položku (pokud je položka propojená).
Chcete-li použít COlePropertiesDialog objekt, nejprve vytvořte objekt pomocí konstruktoru COlePropertiesDialog . Po vytvoření dialogového okna zavolejte DoModal členovou funkci, která zobrazí dialogové okno a umožní uživateli upravit všechny vlastnosti položky. DoModal vrátí, zda uživatel vybral tlačítko OK (IDOK) nebo zrušit (IDCANCEL). Kromě tlačítek OK a Zrušit je k dispozici tlačítko Použít. Když uživatel vybere možnost Použít, všechny změny vlastností položky dokumentu se u položky použijí a její obrázek se automaticky aktualizuje, ale zůstane aktivní.
Datový člen m_psh je ukazatel na PROPSHEETHEADER strukturu a ve většině případů k němu nebudete muset explicitně přistupovat. Jednou z výjimek je, že potřebujete další stránky vlastností nad rámec výchozí stránky Obecné, Zobrazení a Odkaz. V takovém případě můžete upravit m_psh datový člen tak, aby zahrnoval vaše vlastní stránky před voláním DoModal členské funkce.
Další informace o dialogových oknech OLE naleznete v článku Dialogová okna v OLE.
Hierarchie dědičnosti
COlePropertiesDialog
Požadavky
Hlavička: afxodlgs.h
COlePropertiesDialog::COlePropertiesDialog
COlePropertiesDialog Vytvoří objekt.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
Parametry
pItem
Ukazatel na položku dokumentu, jejíž vlastnosti jsou přístupné.
nScaleMin
Minimální procento škálování obrázku položky dokumentu
nScaleMax
Maximální procento škálování obrázku položky dokumentu
pParentWnd
Ukazatel na nadřazený nebo vlastník dialogového okna
Poznámky
Odvodit společnou třídu vlastností objektu OLE z COlePropertiesDialog důvodu implementace škálování pro položky dokumentu. Všechna dialogová okna implementovaná instancí této třídy nebudou podporovat škálování položky dokumentu.
Ve výchozím nastavení má společné dialogové okno Vlastnosti objektu OLE tři výchozí stránky:
OBECNÉ
Tato stránka obsahuje systémové informace pro soubor reprezentovaný vybranou položkou dokumentu. Na této stránce může uživatel převést vybranou položku na jiný typ.
Zobrazení
Tato stránka obsahuje možnosti pro zobrazení položky, změnu ikony a změnu měřítka obrázku.
Odkaz
Tato stránka obsahuje možnosti pro změnu umístění propojené položky a aktualizaci propojené položky. Na této stránce může uživatel přerušit propojení vybrané položky.
Chcete-li přidat stránky nad rámec těch, které jsou ve výchozím nastavení, upravte před ukončením konstruktoru -COlePropertiesDialogodvozené třídy m_psh členské proměnné. Jedná se o pokročilou implementaci konstruktoru COlePropertiesDialog .
COlePropertiesDialog::D oModal
Voláním této členské funkce zobrazíte dialogové okno Společné vlastnosti objektu OLE systému Windows a umožníte uživateli zobrazit nebo změnit různé vlastnosti položky dokumentu.
virtual INT_PTR DoModal();
Návratová hodnota
IDOK nebo IDCANCEL v případě úspěchu; jinak 0. IDOK a IDCANCEL jsou konstanty, které označují, zda uživatel vybral tlačítko OK nebo Zrušit.
Pokud je vrácena funkce IDCANCEL, můžete volat funkci CommDlgExtendedError systému Windows a zjistit, zda došlo k chybě.
COlePropertiesDialog::m_gp
Struktura typu OLEUIGNRLPROPS, která slouží k inicializaci stránky Obecné v dialogovém okně Vlastnosti objektu OLE.
OLEUIGNRLPROPS m_gp;
Poznámky
Tato stránka zobrazuje typ a velikost vkládání a umožňuje uživateli přístup k dialogovému okně Převést. Tato stránka také zobrazuje cíl odkazu, pokud je objekt odkazem.
Další informace o struktuře OLEUIGNRLPROPS najdete v sadě Windows SDK.
COlePropertiesDialog::m_lp
Struktura typu OLEUILINKPROPS, která slouží k inicializaci stránky Propojení v dialogovém okně Vlastnosti objektu OLE.
OLEUILINKPROPS m_lp;
Poznámky
Tato stránka zobrazuje umístění propojené položky a umožňuje uživateli aktualizovat nebo přerušit odkaz na položku.
Další informace o struktuře OLEUILINKPROPS najdete v sadě Windows SDK.
COlePropertiesDialog::m_op
Struktura typu OLEUIOBJECTPROPS, která slouží k inicializaci společného dialogového okna Vlastnosti objektu OLE.
OLEUIOBJECTPROPS m_op;
Poznámky
Tato struktura obsahuje členy používané k inicializaci stránek Obecné, Odkaz a Zobrazit.
Další informace naleznete v OLEUIOBJECTPROPS a OLEUILINKPROPS struktury v sadě Windows SDK.
COlePropertiesDialog::m_psh
Struktura typu PROPSHEETHEADER, jejíž členové ukládají vlastnosti dialogového okna objektu.
PROPSHEETHEADER m_psh;
Poznámky
Po vytvoření objektu COlePropertiesDialog můžete před voláním DoModal členské funkce nastavit m_psh různé aspekty dialogového okna.
Pokud datový člen upravíte m_psh přímo, přepíšete veškeré výchozí chování.
Další informace o struktuře PROPSHEETHEADER najdete v sadě Windows SDK.
COlePropertiesDialog::m_vp
Struktura typu OLEUIVIEWPROPS, která slouží k inicializaci stránky Zobrazení dialogového okna Vlastnosti objektu OLE.
OLEUIVIEWPROPS m_vp;
Poznámky
Tato stránka umožňuje uživateli přepínat mezi "obsahem" a "ikonickými" zobrazeními objektu a měnit jeho škálování v rámci kontejneru. Umožňuje také uživateli přístup k dialogovému okně Změnit ikonu, když se objekt zobrazí jako ikona.
Další informace o struktuře OLEUIVIEWPROPS najdete v sadě Windows SDK.
COlePropertiesDialog::OnApplyScale
Volá se architekturou, když se změnila hodnota škálování a byla vybrána možnost OK nebo Použít.
virtual BOOL OnApplyScale(
COleClientItem* pItem,
int nCurrentScale,
BOOL bRelativeToOrig);
Parametry
pItem
Ukazatel na položku dokumentu, jejíž vlastnosti jsou přístupné.
nCurrentScale
Číselná hodnota měřítka dialogového okna
bRelativeToOrig
Určuje, jestli se měřítko vztahuje na původní velikost položky dokumentu.
Návratová hodnota
Nenulové, pokud je zpracováno; jinak 0.
Poznámky
Výchozí implementace nic nedělá. Chcete-li povolit ovládací prvky škálování, musíte tuto funkci přepsat.
Poznámka:
Před zobrazením společného dialogového okna Vlastnosti objektu OLE volá architektura tuto funkci s hodnotou NULL pro pItem a a - 1 pro nCurrentScale. Tím se určí, jestli se mají povolit ovládací prvky škálování.
Viz také
MFC – ukázka CIRC
COleDialog – třída
Graf hierarchie
COleDialog – třída
CPropertyPage – třída