Share via

Função de retorno de chamada PCMSCALLBACKW (icm.h)

  • Artigo

*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

Confira também