Sdílet prostřednictvím


Seznam vlastností

Tato část obsahuje informace o programovacích prvcích používaných v listech vlastností.

Přehledy

Námět Obsah
o seznamů vlastností Seznam vlastností je okno, které umožňuje uživateli zobrazit a upravit vlastnosti položky.
vytváření průvodců Průvodce je typ seznamu vlastností, který poskytuje jednoduchý a účinný způsob, jak uživatele vést postupem.
použití seznamů vlastností Tato část obsahuje podrobnosti implementace a ukázkový kód pro práci s listy vlastností.

Funkce

Námět Obsah
AddPropSheetPageProc Určuje funkci zpětného volání definovanou aplikací, kterou rozšíření seznamu vlastností používá k přidání stránky do seznamu vlastností.
CreatePropertySheetPage Vytvoří novou stránku pro seznam vlastností.
DestroyPropertySheetPage Zničí stránku seznamu vlastností. Aplikace musí tuto funkci volat pro stránky, které nebyly předány funkci PropertySheet.
PropertySheet Vytvoří seznam vlastností a přidá stránky definované v zadané struktuře záhlaví seznamu vlastností.
PropSheetPageProc Určuje funkci zpětného volání definovanou aplikací, kterou list vlastností volá při vytvoření stránky a kdy se chystá zničit. Aplikace může tuto funkci použít k provádění operací inicializace a čištění stránky.
propsheetproc Funkce zpětného volání definovaná aplikací, kterou systém volá při vytváření a inicializaci seznamu vlastností.

Zprávy

Námět Obsah
PSM_ADDPAGE Přidá novou stránku na konec existujícího seznamu vlastností. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_AddPage.
PSM_APPLY Simuluje výběr tlačítka Použít, které indikuje, že se změnila jedna nebo více stránek a že je potřeba změny ověřit a zaznamenat.
PSM_CANCELTOCLOSE Odeslala aplikace, když provedla změny od posledního PSN_APPLY oznámení, které nelze zrušit. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_CancelToClose.
PSM_CHANGED Informuje seznam vlastností, že se změnily informace na stránce. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_Changed.
PSM_ENABLEWIZBUTTONS Povolí nebo zakáže některá ze standardních tlačítek v průvodci Aero. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_EnableWizButtons.
PSM_GETCURRENTPAGEHWND Načte úchyt do okna aktuální stránky seznamu vlastností. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_GetCurrentPageHwnd.
PSM_GETRESULT Používá se v bezmodálních listech vlastností k načtení informací vrácených do modálních seznamů vlastností pomocí PropertySheet. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_GetResult.
PSM_GETTABCONTROL Načte úchyt na ovládací prvek ouško seznamu vlastností. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_GetTabControl.
PSM_HWNDTOINDEX Vezme úchyt okna stránky seznamu vlastností a vrátí jeho index založený na nule. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_HwndToIndex.
PSM_IDTOINDEX Vezme ID prostředku stránky seznamu vlastností a vrátí index založený na nule. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_IdToIndex.
PSM_INDEXTOHWND Vezme index stránky seznamu vlastností a vrátí jeho popisovač okna. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_IndexToHwnd.
PSM_INDEXTOID Vezme index stránky seznamu vlastností a vrátí jeho ID prostředku. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_IndexToId.
PSM_INDEXTOPAGE Vezme index stránky seznamu vlastností a vrátí jeho úchyt HPROPSHEETPAGE. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_IndexToPage.
PSM_INSERTPAGE Vloží novou stránku do existujícího seznamu vlastností. Stránku lze vložit buď do zadaného indexu, nebo za zadanou stránku. Tuto zprávu můžete odeslat explicitně nebo pomocí PropSheet_InsertPage makra.
PSM_ISDIALOGMESSAGE Předá zprávu do dialogového okna seznamu vlastností a označuje, zda dialogové okno zprávu zpracovalo. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_IsDialogMessage.
PSM_PAGETOINDEX Vezme úchyt HPROPSHEETPAGE stránky seznamu vlastností a vrátí jeho index založený na nule. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_PageToIndex.
PSM_PRESSBUTTON Simuluje výběr tlačítka seznamu vlastností. Tuto zprávu můžete odeslat explicitně nebo pomocí PropSheet_PressButton makra.
PSM_QUERYSIBLINGS Odesláno do seznamu vlastností, který pak zprávu přepošle na každou z jejích stránek. Tuto zprávu můžete odeslat explicitně nebo pomocí PropSheet_QuerySiblings makra.
PSM_REBOOTSYSTEM Označuje, že je potřeba systém restartovat, aby se změny projevily. Zprávu PSM_REBOOTSYSTEM můžete odeslat explicitně nebo pomocí makra PropSheet_RebootSystem.
PSM_RECALCPAGESIZES Přepočítá velikost stránky standardního seznamu vlastností nebo seznamu vlastností průvodce po přidání nebo odebrání stránek. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_RecalcPageSizes.
PSM_REMOVEPAGE Odebere stránku ze seznamu vlastností. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_RemovePage.
PSM_RESTARTWINDOWS Označuje, že je potřeba restartovat Systém Windows, aby se změny projevily.
PSM_SETBUTTONTEXT Nastaví text na tlačítku v průvodci Aero. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_SetButtonText.
PSM_SETCURSEL Aktivuje zadanou stránku v seznamu vlastností. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_SetCurSel.
PSM_SETCURSELID Aktivuje danou stránku v seznamu vlastností na základě identifikátoru prostředku stránky. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_SetCurSelByID.
PSM_SETFINISHTEXT Nastaví text tlačítka Dokončit v průvodci, zobrazí a povolí tlačítko a skryje tlačítka Další a tlačítka Zpět. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_SetFinishText.
PSM_SETHEADERBITMAP Tato zpráva není implementována.
PSM_SETHEADERBITMAPRESOURCE Tato zpráva není implementována.
PSM_SETHEADERSUBTITLE Nastaví text titulku pro záhlaví vnitřní stránky průvodce. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_SetHeaderSubTitle.
PSM_SETHEADERTITLE Nastaví text nadpisu pro záhlaví vnitřní stránky průvodce. Tuto zprávu můžete odeslat explicitně nebo použít makro PropSheet_SetHeaderTitle.
PSM_SETNEXTTEXT Nastaví text tlačítka Další v průvodci. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_SetNextText.
PSM_SETTITLE Nastaví název seznamu vlastností. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_SetTitle.
PSM_SETWIZBUTTONS Povolí nebo zakáže tlačítka Back, Nexta Finish buttons in a wizard. K publikování zprávy můžete také použít makro PropSheet_SetWizButtons.
PSM_SHOWWIZBUTTONS Zobrazí nebo skryje tlačítka v průvodci. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_ShowWizButtons.
PSM_UNCHANGED Informuje seznam vlastností, že informace na stránce se vrátily k dříve uloženému stavu. Tuto zprávu můžete odeslat explicitně nebo pomocí makra PropSheet_UnChanged.

Upozornění

Námět Obsah
PSN_APPLY Odesláno na každou stránku v seznamu vlastností, aby bylo uvedeno, že uživatel kliknul na tlačítko OK, Zavřít nebo Použít a chce, aby se všechny změny projevily. Toto oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_GETOBJECT Odesláno seznamem vlastností k vyžádání cílového objektu přetažení, když kurzor předá jedno z tlačítek ovládacího prvku tab.
PSN_HELP Upozorní stránku, že uživatel kliknul na tlačítko Nápověda. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_KILLACTIVE Upozorní stránku, že dojde ke ztrátě aktivace, protože je aktivována jiná stránka nebo uživatel kliknul na tlačítko OK. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_QUERYCANCEL Označuje, že uživatel zrušil seznam vlastností. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_QUERYINITIALFOCUS Odesláno seznamem vlastností, který poskytuje stránku seznamu vlastností, příležitost určit, který ovládací prvek dialogového okna má dostat počáteční fokus. Toto oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_RESET Upozorní stránku, že se seznam vlastností chystá zničit. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_SETACTIVE Upozorní stránku, že se chystá aktivovat. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_TRANSLATEACCELERATOR Upozorní seznam vlastností, že byla přijata zpráva klávesnice. Poskytuje stránku příležitost k překladu privátního akcelerátoru klávesnice. Toto oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_WIZBACK Upozorní stránku, že uživatel v průvodci kliknul na tlačítko Zpět. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_WIZFINISH Upozorní stránku, že uživatel v průvodci kliknul na tlačítko Dokončit. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.
PSN_WIZNEXT Upozorní stránku, že uživatel v průvodci kliknul na tlačítko Další. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy.

Struktury

Námět Obsah
PROPSHEETHEADER Definuje rámec a stránky seznamu vlastností.
PROPSHEETPAGE Definuje stránku v seznamu vlastností.
PSHNOTIFY Obsahuje informace o kódech oznámení seznamu vlastností.