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
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.
Código de retorno | Descrição |
---|---|
ID_PSREBOOTSYSTEM | Uma página enviou uma mensagem PSM_REBOOTSYSTEM para a folha de propriedades. O computador deve ser reiniciado para que as alterações do usuário entrem em vigor. |
ID_PSRESTARTWINDOWS | Uma página enviou uma mensagem PSM_RESTARTWINDOWS para a folha de propriedades. O Windows deve ser reiniciado para que as alterações do usuário entrem em vigor. |
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
Requisitos
Requisito | Valor |
---|---|
de cliente com suporte mínimo | Windows Vista [somente aplicativos da área de trabalho] |
servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
da Plataforma de Destino |
Windows |
cabeçalho | prsht.h |