estrutura PROPSHEETUI_INFO (compstui.h)

A estrutura PROPSHEETUI_INFO é usada como um parâmetro de entrada para funções do tipo PFNPROPSHEETUI.

Sintaxe

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;

Membros

cbSize

Tamanho fornecido por CPSUI, em bytes, da estrutura PROPSHEETUI_INFO .

Version

Número de versão fornecido por CPSUI da estrutura de PROPSHEETUI_INFO . O número de versão atual é definido por PROPSHEETUI_INFO_VERSION em compstui.h.

Flags

Sinalizadores de bits fornecidos por CPSUI. O seguinte sinalizador é definido:

Sinalizador Descrição
PSUIINFO_UNICODE Se definido, o aplicativo de chamada usará caracteres Unicode.

Reason

Constante fornecida por CPSUI especificando a ação a ser executada na folha de propriedades pela função do tipo PFNPROPSHEETUI para a qual a estrutura PROPSHEETUI_INFO foi passada. Uma das seguintes constantes será fornecida:

  • PROPSHEETUI_REASON_DESTROY

  • PROPSHEETUI_REASON_GET_ICON

  • PROPSHEETUI_REASON_GET_INFO_HEADER

  • PROPSHEETUI_REASON_INIT

  • PROPSHEETUI_REASON_SET_RESULT

Para obter informações sobre o significado de cada constante, consulte a seção Comentários da descrição PFNPROPSHEETUI .

hComPropSheet

Identificador fornecido por CPSUI para um pai do grupo de folhas de propriedades. Esse identificador pode ser passado para a função ComPropSheet do CPSUI.

pfnComPropSheet

Endereço da função ComPropSheet do CPSUI.

lParamInit

Valor recebido como o parâmetro lParam para a função do tipo PFNPROPSHEETUI associada, quando a função foi chamada pela primeira vez com um Motivo de PROPSHEETUI_REASON_INIT. Para obter informações sobre o que esse valor pode ser, consulte a descrição de PFNPROPSHEETUI.

Esse valor é fornecido pelo CPSUI e é válido para todos os valores reason .

UserData

Opcional, valor privado ou ponteiro fornecido pela função do tipo PFNPROPSHEETUI associada, inicialmente definido como zero pelo CPSUI. Se a função armazenar um valor em UserData, para chamadas subsequentes à função, o valor armazenado ou o ponteiro permanecerá inalterado, a menos que seja alterado pela função .

Result

Valor de resultado fornecido pela função do tipo PFNPROPSHEETUI associada, inicialmente definida como zero pelo CPSUI. Se a função armazenar um valor de resultado em Resultado, para chamadas subsequentes para a função, o valor armazenado será inalterado, a menos que seja alterado pela função .

Se o endereço da função do tipo PFNPROPSHEETUI tiver sido especificado como um argumento para CommonPropertySheetUI, o último valor armazenado em Result será retornado para CommonPropertySheetUI no local apontado pelo argumento pResult .

Requisitos

Requisito Valor
Cabeçalho compstui.h (inclua Compstui.h)