structure PROPSHEETUI_INFO (compstui.h)

La structure PROPSHEETUI_INFO est utilisée comme paramètre d’entrée pour les fonctions de type PFNPROPSHEETUI.

Syntaxe

typedef struct _PROPSHEETUI_INFO {
  WORD            cbSize;
  WORD            Version;
  WORD            Flags;
  WORD            Reason;
  HANDLE          hComPropSheet;
  PFNCOMPROPSHEET pfnComPropSheet;
  LPARAM          lParamInit;
  ULONG_PTR       UserData;
  ULONG_PTR       Result;
} PROPSHEETUI_INFO, *PPROPSHEETUI_INFO;

Membres

cbSize

Taille fournie par CPSUI, en octets, de la structure PROPSHEETUI_INFO .

Version

Numéro de version fourni par CPSUI de la structure PROPSHEETUI_INFO . Le numéro de version actuel est défini par PROPSHEETUI_INFO_VERSION dans compstui.h.

Flags

Indicateurs de bits fournis par CPSUI. L’indicateur suivant est défini :

Indicateur	Description
PSUIINFO_UNICODE	Si la valeur est définie, l’application appelante utilise des caractères Unicode.

Reason

Constante fournie par CPSUI spécifiant l’action à effectuer sur la feuille de propriétés par la fonction de type PFNPROPSHEETUI à laquelle la structure PROPSHEETUI_INFO a été passée. L’une des constantes suivantes est fournie :

• PROPSHEETUI_REASON_DESTROY

• PROPSHEETUI_REASON_GET_ICON

• PROPSHEETUI_REASON_GET_INFO_HEADER

• PROPSHEETUI_REASON_INIT

• PROPSHEETUI_REASON_SET_RESULT

Pour plus d’informations sur la signification de chaque constante, consultez la section Remarques de la description PFNPROPSHEETUI .

hComPropSheet

Handle fourni par CPSUI à un parent de groupe de feuilles de propriétés. Ce handle peut être passé à la fonction ComPropSheet du CPSUI.

pfnComPropSheet

Adresse de la fonction ComPropSheet de CPSUI.

lParamInit

Valeur reçue en tant que paramètre lParam pour la fonction de type PFNPROPSHEETUI associée, lorsque la fonction a été appelée pour la première fois avec une raison de PROPSHEETUI_REASON_INIT. Pour plus d’informations sur cette valeur, consultez la description de PFNPROPSHEETUI.

Cette valeur est fournie par CPSUI et est valide pour toutes les valeurs Reason .

UserData

Valeur privée ou pointeur facultatif fourni par la fonction de type PFNPROPSHEETUI associée, initialement définie sur zéro par CPSUI. Si la fonction stocke une valeur dans UserData, pour les appels ultérieurs à la fonction, la valeur stockée ou le pointeur est inchangé, sauf modification par la fonction.

Result

Valeur de résultat fournie par la fonction de type PFNPROPSHEETUI associée, initialement définie sur zéro par CPSUI. Si la fonction stocke une valeur de résultat dans Result, pour les appels ultérieurs à la fonction, la valeur stockée est inchangée, sauf si elle est modifiée par la fonction.

Si l’adresse de la fonction de type PFNPROPSHEETUI a été spécifiée en tant qu’argument pour CommonPropertySheetUI, la dernière valeur stockée dans Result est retournée à CommonPropertySheetUI à l’emplacement vers lequel pointe son argument pResult .

Configuration requise

Condition requise	Valeur
En-tête	compstui.h (inclure Compstui.h)