Sdílet prostřednictvím

CMFCPropertySheet – třída

  • Článek

Třída CMFCPropertySheet podporuje seznam vlastností, kde každá stránka vlastností je označena kartou stránky, tlačítkem panelu nástrojů, uzlem ovládacího prvku stromu nebo položkou seznamu.

Syntaxe

class CMFCPropertySheet : public CPropertySheet

Členové

Veřejné konstruktory

Jméno popis
CMFCPropertySheet::CMFCPropertySheet CMFCPropertySheet Vytvoří objekt.
CMFCPropertySheet::~CMFCPropertySheet Destruktor.

Veřejné metody

Jméno popis
CMFCPropertySheet::AddPage Přidá stránku do seznamu vlastností.
CMFCPropertySheet::AddPageToTree Přidá do ovládacího prvku strom novou stránku vlastností.
CMFCPropertySheet::AddTreeCategory Přidá do ovládacího prvku strom nový uzel.
CMFCPropertySheet::EnablePageHeader Zarezervuje místo v horní části každé stránky a nakreslete vlastní záhlaví.
CMFCPropertySheet::GetHeaderHeight Načte výšku aktuální hlavičky.
CMFCPropertySheet::GetLook Načte hodnotu výčtu, která určuje vzhled aktuálního seznamu vlastností.
CMFCPropertySheet::GetNavBarWidth Opakuje šířku navigačního panelu v pixelech.
CMFCPropertySheet::GetTab Načte objekt interního ovládacího prvku tab, který podporuje aktuální ovládací prvek seznamu vlastností.
CMFCPropertySheet::GetThisClass Používá se architekturou k získání ukazatele na CRuntimeClass objektu, který je přidružen k tomuto typu třídy.
CMFCPropertySheet::InitNavigationControl Inicializuje vzhled aktuálního ovládacího prvku seznam vlastností.
CMFCPropertySheet::OnActivatePage Volá se rozhraním, pokud je povolena stránka vlastností.
CMFCPropertySheet::OnDrawPageHeader Volá se rozhraním pro vykreslení vlastního záhlaví stránky vlastností.
CMFCPropertySheet::OnInitDialog Zpracovává WM_INITDIALOG zprávu. (Přepsání CPropertySheet::OnInitDialog.)
CMFCPropertySheet::OnRemoveTreePage Volá se rozhraním pro odebrání stránky vlastností z ovládacího prvku stromu.
CMFCPropertySheet::PreTranslateMessage Překládá zprávy okna před odesláním do funkcí TranslateMessage a DispatchMessage systému Windows. (Přepsání CPropertySheet::PreTranslateMessage.)
CMFCPropertySheet::RemoveCategory Odebere uzel z ovládacího prvku strom.
CMFCPropertySheet::RemovePage Odebere stránku vlastností z seznamu vlastností.
CMFCPropertySheet::SetIconsList Určuje seznam obrázků, které se používají v navigačním ovládacím prvku podokna Aplikace Outlook.
CMFCPropertySheet::SetLook Určuje vzhled seznamu vlastností.

Poznámky

Třída CMFCPropertySheet představuje seznamy vlastností, označované také jako dialogová okna tabulátoru. Třída CMFCPropertySheet může zobrazit stránku vlastností různými způsoby.

Pokud chcete použít CMFCPropertySheet třídu ve vaší aplikaci, proveďte následující kroky:

  1. Odvodit třídu z CMFCPropertySheet třídy a pojmenovat třídu, například CMyPropertySheet.

  2. Vytvořte CMFCPropertyPage objekt pro každou stránku vlastnosti.

  3. Volání CMFCPropertySheet::SetLook metoda v CMyPropertySheet konstruktoru. Parametr této metody určuje, že stránky vlastností se zobrazí buď jako ouška podél horního nebo levého seznamu vlastností; ouška ve stylu seznamu vlastností Microsoft OneNotu; tlačítka na ovládacím prvku panelu nástrojů aplikace Microsoft Outlook; uzly na ovládacím prvku stromu; nebo jako seznam položek na levé straně seznamu vlastností.

  4. Pokud vytvoříte seznam vlastností ve stylu panelu nástrojů aplikace Microsoft Outlook, zavolejte CMFCPropertySheet::SetIconsList metoda přidružení seznamu obrázků ke stránkám vlastností.

  5. Volání CMFCPropertySheet::AddPage metoda pro každou stránku vlastností.

  6. Vytvořte CMFCPropertySheet ovládací prvek a volejte jeho DoModal metodu.

Ilustrace

Následující obrázek znázorňuje seznam vlastností, který je ve stylu vloženého panelu nástrojů aplikace Microsoft Outlook. Panel nástrojů Outlooku se zobrazí na levé straně seznamu vlastností.

CMFCPropertySheet color controls.

Následující obrázek znázorňuje seznam vlastností, který obsahuje OBJEKT CMFCPropertyGridCtrl Class . Tento objekt je seznam vlastností ve stylu standardního seznamu vlastností běžných ovládacích prvků.

CMFCPropertySheet list and property controls.

Následující obrázek znázorňuje seznam vlastností, který je ve stylu ovládacího prvku strom.

Property Tree.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

Cwnd

CPropertySheet

CMFCPropertySheet

Požadavky

Záhlaví: afxpropertysheet.h

CMFCPropertySheet::AddPage

Přidá stránku do seznamu vlastností.

void AddPage(CPropertyPage* pPage);

Parametry

pPage
[v] Ukazatel na objekt stránky Tento parametr nemůže být NULL.

Poznámky

Tato metoda přidá zadanou stránku vlastností jako kartu nejvíce vpravo v seznamu vlastností. Proto tuto metodu použijte k přidání stránek v pořadí zleva doprava.

Pokud je seznam vlastností ve stylu aplikace Microsoft Outlook, zobrazí rozhraní seznam navigačních tlačítek nalevo od seznamu vlastností. Po této metodě přidá stránku vlastností, přidá odpovídající tlačítko do seznamu. Pokud chcete zobrazit stránku vlastností, klikněte na příslušné tlačítko. Další informace o stylech listů vlastností naleznete v tématu CMFCPropertySheet::SetLook.

CMFCPropertySheet::AddPageToTree

Přidá do ovládacího prvku strom novou stránku vlastností.

void AddPageToTree(
    CMFCPropertySheetCategoryInfo* pCategory,
    CMFCPropertyPage* pPage,
    int nIconNum=-1,
    int nSelIconNum=-1);

Parametry

pCategory
[v] Ukazatel na nadřazený uzel stromu nebo NULL pro přidružení zadané stránky k uzlu nejvyšší úrovně. Volání CMFCPropertySheet::AddTreeCategory metoda získat tento ukazatel.

pPage
[v] Ukazatel na objekt stránky vlastnosti.

nIconNum
[v] Nulový index ikony nebo -1, pokud není použita žádná ikona. Ikona se zobrazí vedle stránky vlastností ovládacího prvku strom, pokud stránka není vybraná. Výchozí hodnota je -1.

nSelIconNum
[v] Nulový index ikony nebo -1, pokud není použita žádná ikona. Ikona se zobrazí vedle stránky vlastností ovládacího prvku strom, když je stránka vybrána. Výchozí hodnota je -1.

Poznámky

Tato metoda přidá stránku vlastností jako list ovládacího prvku stromu. Chcete-li přidat stránku vlastnosti, vytvořte CMFCPropertySheet objekt, zavolejte CMFCPropertySheet::SetLook metoda s look parametr nastavena na CMFCPropertySheet::PropSheetLook_Treea pak použijte tuto metodu přidat stránku vlastnosti.

CMFCPropertySheet::AddTreeCategory

Přidá do ovládacího prvku strom nový uzel.

CMFCPropertySheetCategoryInfo* AddTreeCategory(
    LPCTSTR lpszLabel,
    int nIconNum=-1,
    int nSelectedIconNum=-1,
    const CMFCPropertySheetCategoryInfo* pParentCategory=NULL);

Parametry

lpszLabel
[v] Název uzlu.

nIconNum
[v] Nulový index ikony nebo -1, pokud není použita žádná ikona. Ikona se zobrazí vedle stránky vlastností ovládacího prvku strom, pokud stránka není vybraná. Výchozí hodnota je -1.

nSelectedIconNum
[v] Nulový index ikony nebo -1, pokud není použita žádná ikona. Ikona se zobrazí vedle stránky vlastností ovládacího prvku strom, když je stránka vybrána. Výchozí hodnota je -1.

pParentCategory
[v] Ukazatel na nadřazený uzel stromu nebo NULL pro přidružení zadané stránky k uzlu nejvyšší úrovně. Nastavte tento parametr pomocí CMFCPropertySheet::AddTreeCategory metoda.

Vrácená hodnota

Ukazatel na nový uzel v ovládacím prvku strom.

Poznámky

Tuto metodu použijte k přidání nového uzlu, který se také označuje jako kategorie, do ovládacího prvku stromu. Chcete-li přidat uzel, vytvořte CMFCPropertySheet objekt, zavolejte CMFCPropertySheet::SetLook metoda s look parametr nastavena na CMFCPropertySheet::PropSheetLook_Treea pak použijte tuto metodu přidat uzel.

Použijte návratovou hodnotu této metody v následných volání CMFCPropertySheet::AddPageToTree a CMFCPropertySheet::AddTreeCategory.

CMFCPropertySheet::CMFCPropertySheet

CMFCPropertySheet Vytvoří objekt.

CMFCPropertySheet(
    UINT nIDCaption,
    CWnd* pParentWnd=NULL,
    UINT iSelectPage=0);

CMFCPropertySheet(
    LPCTSTR pszCaption,
    CWnd* pParentWnd=NULL,
    UINT iSelectPage=0);

Parametry

pszCaption
[v] Řetězec, který obsahuje seznam vlastností popis. Nesmí mít hodnotu NULL.

nIDCaption
[v] ID prostředku, které obsahuje seznam vlastností popis.

pParentWnd
[v] Ukazatel na nadřazené okno seznamu vlastností nebo NULL, pokud je nadřazené okno hlavním oknem aplikace. Výchozí hodnota je NULL.

iSelectPage
[v] Index založený na nule horní stránky vlastností. Výchozí hodnota je 0.

Poznámky

Další informace naleznete v parametrech pro CPropertySheet::CPropertySheet konstruktor.

CMFCPropertySheet::EnablePageHeader

Zarezervuje místo v horní části každé stránky a nakreslete vlastní záhlaví.

void EnablePageHeader(int nHeaderHeight);

Parametry

nHeaderHeight
[v] Výška záhlaví v pixelech.

Poznámky

Chcete-li použít hodnotu nHeaderHeight parametr nakreslit vlastní hlavičku, přepište CMFCPropertySheet::OnDrawPageHeader metoda.

CMFCPropertySheet::GetHeaderHeight

Načte výšku aktuální hlavičky.

int GetHeaderHeight() const;

Vrácená hodnota

Výška záhlaví v pixelech.

Poznámky

Před voláním této metody zavolejte CMFCPropertySheet::EnablePageHeader metoda.

CMFCPropertySheet::GetLook

Načte hodnotu výčtu, která určuje vzhled aktuálního seznamu vlastností.

PropSheetLook GetLook() const;

Vrácená hodnota

Jedna z hodnot výčtu, která určuje vzhled seznamu vlastností. Seznam možných hodnot naleznete v tabulce výčtu v části Poznámky CMFCPropertySheet::SetLook.

CMFCPropertySheet::GetNavBarWidth

Získá šířku navigačního panelu.

int GetNavBarWidth() const;

Vrácená hodnota

Šířka navigačního panelu v pixelech.

CMFCPropertySheet::GetTab

Načte objekt interního ovládacího prvku tab, který podporuje aktuální ovládací prvek seznamu vlastností.

CMFCTabCtrl& GetTab() const;

Vrácená hodnota

Vnitřní objekt ovládacího prvku tabulátoru.

Poznámky

Seznam vlastností můžete nastavit tak, aby se zobrazil v různých stylech, jako je například ovládací prvek strom, seznam navigačních tlačítek nebo sada stránek s kartami.

Před voláním této metody zavolejte CMFCPropertySheet::SetLook metoda nastavit vzhled ovládacího prvku seznam vlastností. Potom zavolejte CMFCPropertySheet::InitNavigationControl metoda inicializovat vnitřní tab ovládací prvek objekt. Tato metoda slouží k načtení objektu ovládacího prvku tabulátoru a následné použití tohoto objektu pro práci se ouškami na seznamu vlastností.

Tato metoda se používá v režimu ladění, pokud ovládací prvek seznam vlastností není nastaven tak, aby se zobrazoval ve stylu Microsoft OneNotu.

CMFCPropertySheet::InitNavigationControl

Inicializuje vzhled aktuálního ovládacího prvku seznam vlastností.

virtual CWnd* InitNavigationControl();

Vrácená hodnota

Ukazatel na okno ovládacího prvku seznam vlastností.

Poznámky

Ovládací prvek seznamu vlastností se může zobrazit v několika různých formách, například v sadě stránek se záložkami, v ovládacím prvku strom nebo v seznamu navigačních tlačítek. Pomocí CMFCPropertySheet::SetLook metoda určit vzhled ovládacího prvku property list.

CMFCPropertySheet::OnActivatePage

Volá se rozhraním, pokud je povolena stránka vlastností.

virtual void OnActivatePage(CPropertyPage* pPage);

Parametry

pPage
[v] Ukazatel na objekt stránky vlastností, který představuje povolenou stránku vlastností.

Poznámky

Tato metoda ve výchozím nastavení zajišťuje, že se stránka s povolenou vlastností posune do zobrazení. Pokud styl aktuálního seznamu vlastností obsahuje podokno aplikace Microsoft Outlook, nastaví tato metoda odpovídající tlačítko aplikace Outlook na stav zaškrtnutí.

CMFCPropertySheet::OnDrawPageHeader

Volá se rozhraním pro vykreslení záhlaví pro stránku vlastní vlastnosti.

virtual void OnDrawPageHeader(
    CDC* pDC,
    int nPage,
    CRect rectHeader);

Parametry

Pdc
[v] Ukazatel na kontext zařízení

nPage
[v] Číslo stránky vlastností založené na nule.

rectHeader
[v] Ohraničující obdélník, který určuje, kam se má záhlaví nakreslit.

Poznámky

Ve výchozím nastavení tato metoda nedělá nic. Pokud tuto metodu přepíšete, zavolejte CMFCPropertySheet::EnablePageHeader metoda před voláním této metody.

CMFCPropertySheet::OnRemoveTreePage

Volá se rozhraním pro odebrání stránky vlastností z ovládacího prvku stromu.

virtual BOOL OnRemoveTreePage(CPropertyPage* pPage);

Parametry

pPage
[v] Ukazatel na objekt stránky vlastností, který představuje stránku vlastností, kterou chcete odebrat.

Vrácená hodnota

TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.

CMFCPropertySheet::RemoveCategory

Odebere uzel z ovládacího prvku strom.

void RemoveCategory(CMFCPropertySheetCategoryInfo* pCategory);

Parametry

pCategory
[v] Ukazatel na kategorii (uzel) pro odebrání

Poznámky

Tuto metodu použijte k odebrání uzlu, který se také označuje jako kategorie, z ovládacího prvku stromu. Pomocí CMFCPropertySheet::AddTreeCategory metoda přidat uzel do ovládacího prvku stromu.

CMFCPropertySheet::RemovePage

Odebere stránku vlastností z seznamu vlastností.

void RemovePage(CPropertyPage* pPage);
void RemovePage(int nPage);

Parametry

pPage
[v] Ukazatel na objekt stránky vlastností, který představuje stránku vlastností, kterou chcete odebrat. Nesmí mít hodnotu NULL.

nPage
[v] Index stránky založený na nule, který chcete odebrat.

Poznámky

Tato metoda odebere zadanou stránku vlastností a zničí její přidružené okno. Objekt stránky vlastnosti, který parametr pPage určuje, není zničen, dokud CMFCPropertySheet okno není uzavřeno.

CMFCPropertySheet::SetIconsList

Určuje seznam obrázků, které se používají v navigačním ovládacím prvku podokna Aplikace Outlook.

BOOL SetIconsList(
    UINT uiImageListResID,
    int cx,
    COLORREF clrTransparent=RGB(255, 0, 255));
void SetIconsList(HIMAGELIST hIcons);

Parametry

uiImageListResID
[v] ID prostředku seznamu obrázků.

Cx
[v] Šířka ikon v seznamu obrázků v pixelech.

clrTransparent
[v] Průhledná barva obrázku. Části obrázku, které jsou touto barvou, budou průhledné. Výchozí hodnota je barva purpurová, RGB(255 0 255).

hIcons
[v] Popisovač existujícího seznamu obrázků.

Vrácená hodnota

V první syntaxi přetížení metody, TRUE, pokud tato metoda je úspěšná; jinak NEPRAVDA.

Poznámky

Pokud je seznam vlastností ve stylu aplikace Microsoft Outlook, zobrazí se v levé části seznamu vlastností seznam navigačních tlačítek označovaných jako ovládací prvek podokna Aplikace Outlook. Tuto metodu použijte k nastavení seznamu obrázků, který má používat ovládací prvek podokna Aplikace Outlook.

Další informace o metodách, které podporují tuto metodu, naleznete v tématu CImageList::Create a CImageList::Add. Další informace o nastavení stylu seznamu vlastností naleznete v tématu CMFCPropertySheet::SetLook.

CMFCPropertySheet::SetLook

Určuje vzhled seznamu vlastností.

void SetLook(
    PropSheetLook look,
    int nNavControlWidth=100);

Parametry

Podívej
[v] Jedna z hodnot výčtu, která určuje vzhled seznamu vlastností. Výchozí styl pro seznam vlastností je CMFCPropertySheet::PropSheetLook_Tabs. Další informace najdete v tabulce v části Poznámky v tomto tématu.

nNavControlWidth
[v] Šířka navigačního ovládacího prvku v pixelech. Výchozí hodnota je 100.

Poznámky

Chcete-li zobrazit seznam vlastností v jiném stylu než výchozí, zavolejte tuto metodu před vytvořením okna seznamu vlastností.

Následující tabulka uvádí hodnoty výčtu, které lze zadat v parametru look .

Hodnota popis
CMFCPropertySheet::PropSheetLook_Tabs (Výchozí) Zobrazí kartu pro každou stránku vlastností. Tabulátory se zobrazují v horní části seznamu vlastností a jsou skládané, pokud je více oušek, než se vejde do jednoho řádku.
CMFCPropertySheet::PropSheetLook_OutlookBar Zobrazí seznam navigačních tlačítek ve stylu panelu Microsoft Outlooku na levé straně seznamu vlastností. Každé tlačítko v seznamu odpovídá stránce vlastností. Rozhraní zobrazí šipky posouvání, pokud je více tlačítek, než se vejde do viditelné oblasti seznamu.
CMFCPropertySheet::PropSheetLook_Tree Zobrazí ovládací prvek stromu na levé straně seznamu vlastností. Každý nadřazený nebo podřízený uzel ovládacího prvku stromu odpovídá stránce vlastností. Architektura zobrazí šipky posouvání, pokud je více uzlů, než se vejde do viditelné oblasti ovládacího prvku stromu.
CMFCPropertySheet::PropSheetLook_OneNoteTabs Zobrazí kartu ve stylu Microsoft OneNotu pro každou stránku vlastností. Architektura zobrazuje tabulátory v horní části seznamu vlastností a šipky posouvání, pokud je více oušek, než se vejde do jednoho řádku.
CMFCPropertySheet::PropSheetLook_List Zobrazí seznam na levé straně seznamu vlastností. Každá položka seznamu odpovídá stránce vlastností. Architektura zobrazí šipky posouvání, pokud je více položek seznamu, než se vejde do viditelné oblasti seznamu.

Viz také

Graf hierarchie
Třídy
CMFCPropertyPage – třída
CMFCOutlookBar – třída