PROPSHEETPAGE-Struktur

Definiert eine Seite in einem Eigenschaftenblatt.

Syntax

typedef struct {
    DWORD      dwSize;
    DWORD      dwFlags;
    HINSTANCE  hInstance;
    union {
        LPCSTR                 pszTemplate;
        PROPSHEETPAGE_RESOURCE pResource;
    };
    union {
        HICON  hIcon;
        LPCSTR pszIcon;
    };
    LPCSTR          pszTitle;
    DLGPROC         pfnDlgProc;
    LPARAM          lParam;
    LPFNPSPCALLBACK pfnCallback;
    UINT            *pcRefParent;
    LPCTSTR         pszHeaderTitle;
    LPCTSTR         pszHeaderSubTitle;
    HANDLE          hActCtx;
    union 
    {
        HBITMAP     hbmHeader;
        LPCSTR      pszbmHeader;
    }
} PROPSHEETPAGE, *LPPROPSHEETPAGE;

Member

dwSize

Art: DWORD

Größe dieser Struktur in Byte.

dwFlags

Art: DWORD

Flags, die angeben, welche Optionen beim Erstellen der Eigenschaftenblattseite verwendet werden. Dieser Member kann eine Kombination der folgenden Werte sein.

hInstance

Typ: HINSTANCE

Handle mit dem instance, aus dem ein Symbol oder eine Zeichenfolgenressource geladen werden soll. Wenn das Element pszIcon, pszTitle, pszHeaderTitle oder pszHeaderSubTitle eine zu ladende Ressource identifiziert, muss hInstance angegeben werden.

pszTemplate

Typ: LPCSTR

Dialogfeldvorlage, die zum Erstellen der Seite verwendet werden soll. Dieses Element kann entweder den Ressourcenbezeichner der Vorlage oder die Adresse einer Zeichenfolge angeben, die den Namen der Vorlage angibt. Wenn das PSP_DLGINDIRECT-Flag im dwFlags-Element festgelegt ist, wird pszTemplate ignoriert. Dieser Member wird als Union mit pResource deklariert.

pResource

Typ: LPCDLGTEMPLATE

Zeiger auf eine Dialogfeldvorlage im Arbeitsspeicher. Die PropertySheet-Funktion geht davon aus, dass die Vorlage nicht schreibgeschützt ist. Eine schreibgeschützte Vorlage verursacht in einigen Versionen von Windows eine Ausnahme. Um dieses Element verwenden zu können, müssen Sie das PSP_DLGINDIRECT-Flag im dwFlags-Element festlegen. Dieser Member wird mit pszTemplate als Union deklariert.

hIcon

Typ: HICON

Handle mit dem Symbol, das als Symbol auf der Registerkarte der Seite verwendet werden soll. Wenn das dwFlags-Element nicht PSP_USEHICON enthält, wird dieser Member ignoriert. Dieses Element wird als Union mit pszIcon deklariert.

pszIcon

Typ: LPCSTR

Symbolressource, die als Symbol auf der Registerkarte der Seite verwendet werden soll. Dieses Element kann entweder den Bezeichner der Symbolressource oder die Adresse der Zeichenfolge angeben, die den Namen der Symbolressource angibt. Um dieses Element verwenden zu können, müssen Sie das PSP_USEICONID-Flag im dwFlags-Element festlegen. Dieses Element wird als Union mit hIcon deklariert.

pszTitle

Typ: LPCSTR

Titel des Eigenschaftenblattdialogfelds. Dieser Titel überschreibt den in der Dialogfeldvorlage angegebenen Titel. Dieses Element kann entweder den Bezeichner einer Zeichenfolgenressource oder die Adresse einer Zeichenfolge angeben, die den Titel angibt. Um dieses Element verwenden zu können, müssen Sie das PSP_USETITLE-Flag im dwFlags-Element festlegen.

pfnDlgProc

Typ: DLGPROC

Zeiger auf die Dialogfeldprozedur für die Seite. Da die Seiten als moduslose Dialogfelder erstellt werden, darf die Dialogfeldprozedur die EndDialog-Funktion nicht aufrufen.

lParam

Typ: LPARAM

Wenn die Seite erstellt wird, wird eine Kopie der PROPSHEETPAGE-Struktur der Seite mit einer WM_INITDIALOG Meldung an die Dialogfeldprozedur übergeben. Das lParam-Element wird bereitgestellt, damit Sie anwendungsspezifische Informationen an die Dialogfeldprozedur übergeben können. Dies hat keine Auswirkungen auf die eigentliche Seite.

pfnCallback

Typ: LPFNPSPCALLBACK

Zeiger auf eine anwendungsdefinierte Rückruffunktion, die aufgerufen wird, wenn die Seite erstellt wird und wann sie zerstört werden soll. Weitere Informationen zur Rückruffunktion finden Sie unter LPFNPSPCALLBACKA-Rückruffunktion. Um dieses Element verwenden zu können, müssen Sie das PSP_USECALLBACK-Flag im dwFlags-Element festlegen.

pcRefParent

Typ: UINT*

Zeiger auf den Wert für die Verweisanzahl. Um diesen Member verwenden zu können, müssen Sie das PSP_USEREFPARENT-Flag im dwFlags-Element festlegen.

pszHeaderTitle

Typ: LPCTSTR

Version 5.80 oder höher. Titel des Kopfzeilenbereichs. Um dieses Element im Assistenten 97-Stil zu verwenden, müssen Sie auch die folgenden Schritte ausführen:

• Legen Sie das PSP_USEHEADERTITLE-Flag im dwFlags-Element fest.
• Legen Sie das PSH_WIZARD97-Flag im dwFlags-Element der PROPSHEETHEADER-Struktur der Seite fest.
• Stellen Sie sicher, dass das PSP_HIDEHEADER-Flag im dwFlags-Element nicht festgelegt ist.

pszHeaderSubTitle

Typ: LPCTSTR

Version 5.80 oder höher. Untertitel des Kopfzeilenbereichs. Um diesen Member verwenden zu können, müssen Sie die folgenden Schritte ausführen:

• Legen Sie das PSP_USEHEADERSUBTITLE-Flag im dwFlags-Element fest.
• Legen Sie das PSH_WIZARD97-Flag im dwFlags-Element der PROPSHEETHEADER-Struktur der Seite fest.
• Stellen Sie sicher, dass das PSP_HIDEHEADER-Flag im dwFlags-Element nicht festgelegt ist.

hActCtx

Typ: HANDLE

Version 6.0 oder höher. Ein Aktivierungskontexthandle. Legen Sie diesen Member auf das Handle fest, das zurückgegeben wird, wenn Sie den Aktivierungskontext mit CreateActCtx erstellen. Das System aktiviert diesen Kontext, bevor das Dialogfeld erstellt wird. Sie müssen diesen Member nicht verwenden, wenn Sie ein globales Manifest verwenden.

hbmHeader

Typ: HBITMAP

Dieses Element wird mit pszbmHeader als Union deklariert.

pszbmHeader

Typ: LPCSTR

Dieser Member wird mit hbmHeader als Union deklariert.

Bemerkungen

Comctl32.dll Version 6 und höher sind nicht verteilbar. Um Comctl32.dll Version 6 oder höher zu verwenden, geben Sie die .dll-Datei in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Anforderungen