Partilhar via

estrutura SETRESULT_INFO (compstui.h)

  • Artigo

A estrutura SETRESULT_INFO é usada como um parâmetro de entrada para a função de retorno de chamada PFNPROPSHEETUIde um aplicativo.

Sintaxe

typedef struct _SETRESULT_INFO {
  WORD    cbSize;
  WORD    wReserved;
  HANDLE  hSetResult;
  LRESULT Result;
} SETRESULT_INFO, *PSETRESULT_INFO;

Membros

cbSize

Tamanho fornecido por CPSUI, em bytes, da estrutura de SETRESULT_INFO.

wReserved

Reservado.

hSetResult

Identificador fornecido por CPSUI para uma página de folha de propriedades adicionada, obtida do aplicativo. Para obter mais informações, consulte a seção comentários abaixo.

Result

Identificador fornecido por CPSUI para uma página de folha de propriedades adicionada, obtida do aplicativo. Para obter mais informações, consulte a seção comentários abaixo.

Observações

Quando um aplicativo chama a função ComPropSheet do CPSUI, especificando um código de função de CPSFUNC_SET_RESULT, o CPSUI chama todas as funções registradas PFNPROPSHEETUItipadas, especificando um motivo de PROPSHEETUI_REASON_SET_RESULT. Ao especificar esse motivo, o CPSUI também fornece uma estrutura de SETRESULT_INFO.

Os valores contidos nos hSetResult da estrutura e membros do resultam são os valores lParam1 e lParam2, respectivamente, que foram fornecidos para a função comPropSheet do CPSUI.

Cada uma das funções do tipo PFNPROPSHEETUI do aplicativo é chamada em ordem, desde a declarada mais recentemente até a primeira declarada, até que uma dessas funções forneça um valor retornado menor que um. Nesse ponto, o CPSUI retorna de sua função ComPropSheet, fornecendo uma contagem do número de funções do tipo PFNPROPSHEETUI que foram chamadas.

Normalmente, a função do tipo PFNPROPSHEETUI de um aplicativo define o membro Result de sua estrutura PROPSHEETUI_INFO para o valor recebido no membro do resultado da estrutura SETRESULT_INFO. Em seguida, a função retorna um valor de 1 (ou maior), para que a próxima função do tipo PFNPROPSHEETUI também possa recebê-la. Cada função chamada posteriormente é associada a uma página que é o pai da página associada à última função chamada. Uma função pode modificar o conteúdo do membro Resultado da estrutura SETRESULT_INFO, fazendo com que as funções associadas às páginas pai recebam o novo valor.

Requisitos

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