Compartir a través de

estructura PROPSHEETUI_INFO (compstui.h)

  • Artículo

La estructura PROPSHEETUI_INFO se usa como parámetro de entrada para las funciones con tipo PFNPROPSHEETUI.

Sintaxis

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;

Miembros

cbSize

Tamaño proporcionado por CPSUI, en bytes, de la estructura PROPSHEETUI_INFO .

Version

Número de versión proporcionado por CPSUI de la estructura PROPSHEETUI_INFO . El número de versión actual se define mediante PROPSHEETUI_INFO_VERSION en compstui.h.

Flags

Marcas de bits proporcionadas por CPSUI. Se define la marca siguiente:

Marca Descripción
PSUIINFO_UNICODE Si se establece, la aplicación que realiza la llamada usa caracteres Unicode.

Reason

La constante proporcionada por CPSUI que especifica la acción que se va a realizar en la hoja de propiedades mediante la función con tipo PFNPROPSHEETUI a la que se pasó la estructura de PROPSHEETUI_INFO. Se proporcionará una de las siguientes constantes:

  • PROPSHEETUI_REASON_DESTROY

  • PROPSHEETUI_REASON_GET_ICON

  • PROPSHEETUI_REASON_GET_INFO_HEADER

  • PROPSHEETUI_REASON_INIT

  • PROPSHEETUI_REASON_SET_RESULT

Para obtener información sobre el significado de cada constante, vea la sección Comentarios de la descripción PFNPROPSHEETUI .

hComPropSheet

Identificador proporcionado por CPSUI a un elemento primario del grupo de hojas de propiedades. Este identificador se puede pasar a la función ComPropSheet de CPSUI.

pfnComPropSheet

Dirección de la función ComPropSheet de CPSUI.

lParamInit

Valor recibido como parámetro lParam para la función de tipo PFNPROPSHEETUI asociada, cuando se llamó a la función por primera vez con un motivo de PROPSHEETUI_REASON_INIT. Para obtener información sobre lo que puede ser este valor, vea la descripción de PFNPROPSHEETUI.

CPSUI proporciona este valor y es válido para todos los valores reason .

UserData

Opcional, valor privado o puntero proporcionado por la función de tipo PFNPROPSHEETUI asociada, establecido inicialmente en cero por CPSUI. Si la función almacena un valor en UserData, para las llamadas posteriores a la función, el valor almacenado o el puntero no se modifican a menos que la función cambie.

Result

Valor de resultado proporcionado por la función de tipo PFNPROPSHEETUI asociada, establecida inicialmente en cero por CPSUI. Si la función almacena un valor de resultado en Result, para las llamadas posteriores a la función, el valor almacenado no cambia a menos que la función cambie.

Si la dirección de la función con tipo PFNPROPSHEETUI se especificó como argumento para CommonPropertySheetUI, el último valor almacenado en Result se devuelve a CommonPropertySheetUI en la ubicación a la que apunta su argumento pResult .

Requisitos

Requisito Valor
Header compstui.h (incluir Compstui.h)