Função de retorno de chamada PCMSCALLBACKW (icm.h)
*PCMSCALLBACKW* (ou ApplyCallbackFunction) é uma função de retorno de chamada que você implementa que atualiza os dados de configuração do WCS enquanto a caixa de diálogo exibida pela função SetupColorMatchingW está sendo executada. O nome ApplyCallbackFunction é um espaço reservado. O nome real dessa função de retorno de chamada é fornecido pelo aplicativo usando ICM.
Sintaxe
PCMSCALLBACKW Pcmscallbackw;
BOOL Pcmscallbackw(
_tagCOLORMATCHSETUPW *unnamedParam1,
LPARAM unnamedParam2
)
{...}
Parâmetros
unnamedParam1
Ponteiro para uma estrutura COLORMATCHSETUPW que contém dados de configuração do WCS.
unnamedParam2
Contém um valor fornecido pelo aplicativo.
Valor retornado
Se essa função for bem-sucedida, o valor retornado será TRUE.
Se essa função falhar, o valor retornado será FALSE. A função de retorno de chamada pode definir as informações de erro estendidas chamando SetLastError.
Comentários
A função ApplyCallbackFunction é usada para alterar a configuração do WCS para um dispositivo enquanto a caixa de diálogo Gerenciamento de Cores é exibida. A caixa de diálogo Gerenciamento de Cores é exibida pela função SetupColorMatchingW .
Se a função de retorno de chamada for fornecida, um botão Aplicar será exibido no canto inferior direito da caixa de diálogo. Quando você seleciona o botão Aplicar , a função de retorno de chamada atualiza imediatamente a configuração do dispositivo que está sendo configurado. A caixa de diálogo Gerenciamento de Cores permanece na tela.
Um aplicativo fornece uma função de retorno de chamada para o WCS armazenando o endereço da função de retorno de chamada na estrutura COLORMATCHSETUPW que é passada para a função SetupColorMatchingW . O endereço é armazenado no membro lPfnApplyCallback da estrutura COLORMATCHSETUP . O membro dwFlags deve ser definido como CMS_USEAPPLYCALLBACK ou a função de retorno de chamada será ignorada.
Um valor fornecido pelo aplicativo pode ser passado para a função de retorno de chamada. Antes de invocar a função SetupColorMatchingW , o aplicativo pode armazenar um valor no membro lParamApplyCallback da estrutura COLORMATCHSETUPW . Quando a função de retorno de chamada for invocada, o valor no membro da estrutura lParamApplyCallback será passado para a função de retorno de chamada em seu parâmetro lParam .
A função de retorno de chamada é completamente opcional. Se ele não for fornecido, o botão Aplicar não aparecerá na caixa de diálogo Gerenciamento de Cores. A Microsoft recomenda fortemente que seu aplicativo forneça uma função de retorno de chamada.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | icm.h |