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

Objekt CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

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