Função de retorno de chamada PFNPROPSHEETCALLBACK (prsht.h)

Uma função de retorno de chamada definida pelo aplicativo que o sistema chama quando a folha de propriedades está sendo criada e inicializada.

Sintaxe

PFNPROPSHEETCALLBACK Pfnpropsheetcallback;

int Pfnpropsheetcallback(
  HWND unnamedParam1,
  UINT unnamedParam2,
  LPARAM unnamedParam3
)
{...}

Parâmetros

unnamedParam1

Tipo: HWND

Manipule para a folha de propriedades. Esse parâmetro normalmente é chamado de hWnd.

unnamedParam2

Tipo: UINT

Mensagem sendo recebida. Esse parâmetro normalmente é chamado de uMsg.

Esse parâmetro é um dos valores a seguir.

unnamedParam3

Tipo: LPARAM

Informações adicionais sobre a mensagem. Esse parâmetro normalmente é chamado de lParam.

O significado desse valor depende do parâmetro uMsg (unnamedParam2):

• Se uMsg for PSCB_INITIALIZED ou PSCB_BUTTONPRESSED, o valor desse parâmetro será zero.

• Se uMsg for PSCB_PRECREATE, esse parâmetro será um ponteiro para uma estrutura DLGTEMPLATE ou DLGTEMPLATEEX que descreve a caixa de diálogo da folha de propriedades. Teste a assinatura da estrutura para determinar o tipo. Se a assinatura for igual a 0xFFFF, a estrutura será um modelo de caixa de diálogo estendido, caso contrário, a estrutura será um modelo de caixa de diálogo padrão. O exemplo a seguir demonstra como fazer isso.

  if (uMsg == PSCB_PRECREATE) 
  {
       if (lParam)
       {
            DLGTEMPLATE *pDlgTemplate;
            DLGTEMPLATEEX *pDlgTemplateEx;
  
            pDlgTemplateEx = (DLGTEMPLATEEX *)lParam;  
            if (pDlgTemplateEx->signature == 0xFFFF)
            {
                 // pDlgTemplateEx points to an extended  
                 // dialog template structure.
            }
            else
            {
                 // This is a standard dialog template
                 //  structure.
                 pDlgTemplate = (DLGTEMPLATE *)lParam;
            }
       }    
  }
  

Retornar valor

Tipo: int

Retorna zero.

Comentários

Para habilitar uma função de retorno de chamada PropSheetProc , use a estrutura PROPSHEETHEADER ao chamar a função PropertySheet para criar a folha de propriedades. Use o membro pfnCallback para especificar um endereço da função de retorno de chamada e defina o sinalizador PSP_USECALLBACK no membro dwFlags .

PropSheetProc é um espaço reservado para o nome da função definida pelo aplicativo. O tipo PFNPROPSHEETCALLBACK é o endereço de uma função de retorno de chamada PropSheetProc .

Requisitos