CPLINFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains resource information and a user-defined value for a dialog box supported by a Control Panel application.

Syntax

typedef struct tagCPLINFO { 
  int idIcon; 
  int idName; 
  int idInfo; 
  LONG lData; 
} CPLINFO;

Members

  • idIcon
    Resource identifier of the icon that represents the dialog box.
  • idName
    Resource identifier of the string that contains the short name for the dialog box. This name is intended to be displayed below the icon.
  • idInfo
    Resource identifier of the string that contains the description for the dialog box that is intended to be displayed when the application icon is selected.
  • lData
    Data defined by the application. When the Control Panel sends the CPL_DBCLK and CPL_STOP messages, it passes this value back to your application.

Remarks

If the icon or display strings of the dialog box can change based on the state of the computer, you can specify the CPL_DYNAMIC_RES value for the idIcon, idName, or idInfo members rather than specifying a valid resource identifier. This causes the Control Panel to send the CPL_NEWINQUIRE message each time it needs the icon and display strings. Using this technique is significantly slower, however, because the Control Panel will need to load your application each time it sends the CPL_NEWINQUIRE message.

Requirements

Header cpl.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CPL_NEWINQUIRE
NEWCPLINFO

Other Resources