PropSheet_GetResult macro (prsht.h)

Usado por folhas de propriedades modeless para recuperar as informações retornadas às folhas de propriedades modais PropertySheet. Você pode usar essa macro ou enviar a mensagem PSM_GETRESULT explicitamente.

Sintaxe

int PropSheet_GetResult(
   HWND hDlg
);

Parâmetros

hDlg

Tipo: HWND

Manipule para a caixa de diálogo da folha de propriedades.

Valor de retorno

Tipo: int

Retorna um valor positivo se tiver êxito ou -1 caso contrário. Os valores retornados a seguir têm um significado especial.

Observações

Para recuperar informações de erro estendidas, chame GetLastError.

O valor retornado é idêntico ao que PropertySheet teria retornado se essa fosse uma folha de propriedades modal.

Versão 5.80. O PropertySheet valor retornado contém informações diferentes para folhas de propriedades modais e modeless. Em alguns casos, as folhas de propriedades de modelagem podem precisar das informações que teriam recebido de PropertySheet se tivessem sido modais. Em particular, eles podem precisar saber se ID_PSREBOOTSYSTEM ou ID_PSRESTARTWINDOWS teriam sido retornados.

Para uma folha de propriedades de modelagem, o loop de mensagem deve usar PSM_ISDIALOGMESSAGE para passar mensagens para a caixa de diálogo da folha de propriedades e PSM_GETCURRENTPAGEHWND para determinar quando destruir a caixa de diálogo. Quando o usuário clica no botão OK ou Cancelar, PSM_GETCURRENTPAGEHWND retorna NULL. Em seguida, você pode recuperar o valor que uma folha de propriedades modal teria recebido de PropertySheet enviando uma mensagem de PSM_GETRESULT.

Requisitos