COlePropertyPage – třída

Používá se k zobrazení vlastností vlastního ovládacího prvku v grafickém rozhraní, podobně jako dialogové okno.

Syntaxe

class AFX_NOVTABLE COlePropertyPage : public CDialog

Členové

Veřejné konstruktory

Název	Popis
COlePropertyPage::COlePropertyPage	COlePropertyPage Vytvoří objekt.

Veřejné metody

Název	Popis
COlePropertyPage::GetControlStatus	Určuje, zda uživatel upravil hodnotu v ovládacím prvku.
COlePropertyPage::GetObjectArray	Vrátí pole objektů, které upravuje stránka vlastností.
COlePropertyPage::GetPageSite	Vrátí ukazatel na rozhraní stránky IPropertyPageSite vlastností.
COlePropertyPage::IgnoreApply	Určuje, které ovládací prvky nepovolují tlačítko Použít.
COlePropertyPage::IsModified	Určuje, zda uživatel upravil stránku vlastností.
COlePropertyPage::OnEditProperty	Volá se rozhraním, když uživatel upraví vlastnost.
COlePropertyPage::OnHelp	Volá se rozhraním, když uživatel vyvolá nápovědu.
COlePropertyPage::OnInitDialog	Volá se rozhraním při inicializaci stránky vlastností.
COlePropertyPage::OnObjectsChanged	Volá se rozhraním, pokud je vybrán jiný ovládací prvek OLE s novými vlastnostmi.
COlePropertyPage::OnSetPageSite	Volá se architekturou, když rámec vlastnosti poskytuje web stránky.
COlePropertyPage::SetControlStatus	Nastaví příznak označující, jestli uživatel upravil hodnotu v ovládacím prvku.
COlePropertyPage::SetDialogResource	Nastaví prostředek dialogového okna stránky vlastností.
COlePropertyPage::SetHelpInfo	Nastaví krátký text nápovědy stránky vlastnosti, název souboru nápovědy a kontext nápovědy.
COlePropertyPage::SetModifiedFlag	Nastaví příznak označující, jestli uživatel upravil stránku vlastností.
COlePropertyPage::SetPageName	Nastaví název stránky vlastnosti (titulek).

Poznámky

Stránka vlastností může například obsahovat ovládací prvek pro úpravy, který uživateli umožňuje zobrazit a upravit vlastnost titulku ovládacího prvku.

Každá vlastní vlastnost nebo vlastnost ovládacího prvku stock může mít ovládací prvek dialogového okna, který umožňuje uživateli ovládacího prvku zobrazit aktuální hodnotu vlastnosti a v případě potřeby tuto hodnotu upravit.

Další informace o použití COlePropertyPagenaleznete v článku Ovládací prvky ActiveX: Stránky vlastností.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CDialog

COlePropertyPage

Požadavky

Záhlaví: afxctl.h

COlePropertyPage::COlePropertyPage

COlePropertyPage Vytvoří objekt.

COlePropertyPage(
    UINT idDlg,
    UINT idCaption);

Parametry

idDlg
ID prostředku šablony dialogového okna

idCaption
ID prostředku titulku stránky vlastností

Poznámky

Když implementujete podtřídu COlePropertyPage, konstruktor podtřídy by měl použít COlePropertyPage konstruktor k identifikaci prostředku šablony dialogového okna, na kterém je stránka vlastností založena, a prostředek řetězce obsahující jeho titulek.

COlePropertyPage::GetControlStatus

Určuje, zda uživatel upravil hodnotu ovládacího prvku stránky vlastností pomocí zadaného ID prostředku.

BOOL GetControlStatus(UINT nID);

Parametry

Nid
ID prostředku ovládacího prvku stránky vlastností

Návratová hodnota

TRUE, pokud byla hodnota ovládacího prvku změněna; jinak NEPRAVDA.

COlePropertyPage::GetObjectArray

Vrátí pole objektů, které upravuje stránka vlastností.

LPDISPATCH* GetObjectArray(ULONG* pnObjects);

Parametry

Objekty pnObjects
Ukazatel na celé celé číslo bez znaménka, které obdrží počet objektů upravovaných stránkou.

Návratová hodnota

Ukazatel na pole IDispatch ukazatelů, které se používají pro přístup k vlastnostem každého ovládacího prvku na stránce vlastností. Volající nesmí tyto ukazatele rozhraní uvolnit.

Poznámky

Každý objekt stránky vlastností udržuje pole ukazatelů na IDispatch rozhraní objektů upravovaných stránkou. Tato funkce nastaví argument pnObjects na počet prvků v dané matici a vrátí ukazatel na první prvek pole.

COlePropertyPage::GetPageSite

Získá ukazatel na rozhraní stránky IPropertyPageSite vlastností.

LPPROPERTYPAGESITE GetPageSite();

Návratová hodnota

Ukazatel na rozhraní stránky IPropertyPageSite vlastností.

Poznámky

Ovládací prvky a kontejnery spolupracují, aby uživatelé mohli procházet a upravovat vlastnosti ovládacího prvku. Ovládací prvek poskytuje stránky vlastností, z nichž každý je objekt OLE, který umožňuje uživateli upravit související sadu vlastností. Kontejner poskytuje rámec vlastnosti, který zobrazuje stránky vlastností. Pro každou stránku poskytuje rámec vlastnosti web stránky, který podporuje IPropertyPageSite rozhraní.

COlePropertyPage::IgnoreApply

Určuje, které ovládací prvky nepovolují tlačítko Použít.

void IgnoreApply(UINT nID);

Parametry

Nid
ID ovládacího prvku, který se má ignorovat.

Poznámky

Tlačítko Použít na stránce vlastností je povoleno pouze v případech, kdy byly změněny hodnoty ovládacích prvků stránky vlastností. Pomocí této funkce můžete určit ovládací prvky, které nezpůsobují povolení tlačítka Použít při změně jejich hodnot.

COlePropertyPage::IsModified

Určuje, zda uživatel změnil jakékoli hodnoty na stránce vlastností.

BOOL IsModified();

Návratová hodnota

TRUE, pokud byla stránka vlastnosti změněna.

COlePropertyPage::OnEditProperty

Architektura volá tuto funkci, pokud je třeba upravit konkrétní vlastnost.

virtual BOOL OnEditProperty(DISPID dispid);

Parametry

dispid
ID odeslání vlastnosti, která se upravuje.

Návratová hodnota

Výchozí implementace vrátí hodnotu FALSE. Přepsání této funkce by mělo vrátit hodnotu PRAVDA.

Poznámky

Můžete ho přepsat a nastavit fokus na příslušný ovládací prvek na stránce. Výchozí implementace nic nedělá a vrací hodnotu FALSE.

COlePropertyPage::OnHelp

Architektura tuto funkci volá, když uživatel požádá o online nápovědu.

virtual BOOL OnHelp(LPCTSTR lpszHelpDir);

Parametry

lpszHelpDir
Adresář obsahující soubor nápovědy stránky vlastností.

Návratová hodnota

Výchozí implementace vrátí hodnotu FALSE.

Poznámky

Přepsat, pokud vaše stránka vlastností musí provést jakoukoli zvláštní akci, když uživatel přistupuje k nápovědě. Výchozí implementace nic nevrací a vrací hodnotu FALSE, která dává rozhraní pokyn k volání WinHelp.

COlePropertyPage::OnInitDialog

Architektura volá tuto funkci při inicializaci dialogového okna stránky vlastností.

virtual BOOL OnInitDialog();

Návratová hodnota

Výchozí implementace vrátí hodnotu FALSE.

Poznámky

Pokud se při inicializaci dialogového okna vyžaduje nějaká zvláštní akce, přepište ji. Výchozí volání CDialog::OnInitDialog implementace a vrátí hodnotu FALSE.

COlePropertyPage::OnObjectsChanged

Volá se rozhraním, pokud je vybrán jiný ovládací prvek OLE s novými vlastnostmi.

virtual void OnObjectsChanged();

Poznámky

Při zobrazení vlastností ovládacího prvku OLE ve vývojářském prostředí se k zobrazení stránek vlastností používá dialogové okno bez režimu. Pokud je vybrán jiný ovládací prvek, musí být pro novou sadu vlastností zobrazena jiná sada stránek vlastností. Architektura volá tuto funkci, která upozorní stránku vlastností na změnu.

Tuto funkci přepište tak, aby dostávala oznámení o této akci a prováděla všechny zvláštní akce.

COlePropertyPage::OnSetPageSite

Architektura volá tuto funkci, pokud rámec vlastnosti poskytuje stránku stránky vlastností stránky.

virtual void OnSetPageSite();

Poznámky

Výchozí implementace načte titulek stránky a pokusí se určit velikost stránky z prostředku dialogového okna. Tuto funkci přepsat, pokud stránka vlastností vyžaduje jakoukoli další akci; přepsání by mělo volat implementaci základní třídy.

COlePropertyPage::SetControlStatus

Změní stav ovládacího prvku stránky vlastností.

BOOL SetControlStatus(
    UINT nID,
    BOOL bDirty);

Parametry

Nid
Obsahuje ID ovládacího prvku stránky vlastností.

bDirty
Určuje, zda bylo změněno pole stránky vlastností. Pokud bylo pole změněno, nastavte na hodnotu TRUE, nePRAVDA, pokud nebyla změněna.

Návratová hodnota

TRUE, pokud byl zadaný ovládací prvek nastaven; jinak NEPRAVDA.

Poznámky

Pokud je stav ovládacího prvku stránky vlastností při zavření stránky vlastnosti nebo zvolen tlačítko Použít, vlastnost ovládacího prvku se aktualizuje o příslušnou hodnotu.

COlePropertyPage::SetDialogResource

Nastaví prostředek dialogového okna stránky vlastností.

void SetDialogResource(HGLOBAL hDialog);

Parametry

hDialog
Popisovač prostředku dialogového okna stránky vlastností

COlePropertyPage::SetHelpInfo

Určuje informace o popisu, název souboru nápovědy a kontext nápovědy pro stránku vlastností.

void SetHelpInfo(
    LPCTSTR lpszDocString,
    LPCTSTR lpszHelpFile = NULL,
    DWORD dwHelpContext = 0);

Parametry

lpszDocString
Řetězec obsahující stručné informace nápovědy pro zobrazení na stavovém řádku nebo na jiném místě.

lpszHelpFile
Název souboru nápovědy stránky vlastností

dwHelpContext
Kontext nápovědy pro stránku vlastností

COlePropertyPage::SetModifiedFlag

Určuje, zda uživatel upravil stránku vlastností.

void SetModifiedFlag(BOOL bModified = TRUE);

Parametry

bModified
Určuje novou hodnotu upraveného příznaku stránky vlastností.

COlePropertyPage::SetPageName

Nastaví název stránky vlastností, který bude rámeček vlastnosti obvykle zobrazovat na kartě stránky.

void SetPageName(LPCTSTR lpszPageName);

Parametry

lpszPageName
Ukazatel na řetězec obsahující název stránky vlastností

Viz také

MFC – ukázka CIRC3
MFC Sample TESTHELP
CDialog – třída
Graf hierarchie
CDialog – třída