estrutura PROPSHEETUI_INFO (compstui.h)

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

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 de PROPSHEETUI_INFO.

Version

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

Flags

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

Bandeira	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 PFNPROPSHEETUIpara 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 uma folha de propriedades pai do grupo. 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 Reason 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 Motivo.

UserData

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

Result

Valor de resultado fornecido pela função PFNPROPSHEETUI associada, inicialmente definida como zero pelo CPSUI. Se a função armazenar um valor de resultado em Resultado, para chamadas subsequentes à função, o valor armazenado ficará 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)