Estrutura CPLINFO (cpl.h)

  • Artigo

Contém informações de recurso e um valor definido pelo aplicativo para uma caixa de diálogo compatível com um aplicativo Painel de Controle. A função CPlApplet do aplicativo Painel de Controle retorna essas informações para o Painel de Controle em resposta a uma mensagem CPL_INQUIRE.

Sintaxe

typedef struct tagCPLINFO {
  int      idIcon;
  int      idName;
  int      idInfo;
  LONG_PTR lData;
} CPLINFO, *LPCPLINFO;

Membros

idIcon

Tipo: int

O identificador de recurso do ícone que representa a caixa de diálogo.

idName

Tipo: int

O identificador de recurso da cadeia de caracteres que contém o nome curto da caixa de diálogo. Esse nome deve ser exibido abaixo do ícone.

idInfo

Tipo: int

O identificador de recurso da cadeia de caracteres que contém a descrição da caixa de diálogo que se destina a ser exibida quando o ícone do aplicativo é selecionado.

lData

Tipo: LONG_PTR

Um ponteiro para os dados definidos pelo aplicativo. Quando o Painel de Controle envia as mensagens CPL_DBLCLK e CPL_STOP, ele passa esse valor de volta para seu aplicativo.

Comentários

Se o ícone ou as cadeias de caracteres de exibição da caixa de diálogo puderem ser alteradas com base no estado do computador, você poderá especificar o valor CPL_DYNAMIC_RES para os membros idIcon, idName ou idInfo em vez de especificar um identificador de recurso válido. Isso faz com que o Painel de Controle envie a mensagem CPL_NEWINQUIRE sempre que precisar do ícone e exibir cadeias de caracteres. No entanto, o uso dessa técnica é significativamente mais lento, pois o Painel de Controle precisará carregar seu aplicativo sempre que enviar a mensagem CPL_NEWINQUIRE.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho cpl.h