Partager via

structure PROPSHEETUI_INFO (compstui.h)

  • Article

La structure PROPSHEETUI_INFO est utilisée comme paramètre d’entrée pour fonctions PFNPROPSHEETUI-typées.

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 :

Drapeau Description
PSUIINFO_UNICODE Si elle 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 l'PFNPROPSHEETUIfonction -typée à 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 PFNPROPSHEETUI description.

hComPropSheet

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

pfnComPropSheet

Adresse de la fonction ComPropSheet de CPSUI.

lParamInit

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

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

UserData

Valeur facultative, privée ou pointeur fourni par l'PFNPROPSHEETUIfonction -typée initialement définie sur zéro par CPSUI. Si la fonction stocke une valeur dans UserData, puis, pour les appels suivants à la fonction, la valeur stockée ou le pointeur n’est pas modifié, sauf modification par la fonction.

Result

Valeur de résultat fournie par l'PFNPROPSHEETUIfonction -typée initialement définie sur zéro par CPSUI. Si la fonction stocke une valeur de résultat dans Result, puis, pour les appels suivants à la fonction, la valeur stockée n’est pas modifiée, sauf si elle est modifiée par la fonction.

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

Exigences

Exigence Valeur
d’en-tête compstui.h (include Compstui.h)