|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| -
| Header File
| cpl.h
| Unicode
| No
| Platform Notes
| None
|
|
|
CPLINFO
The CPLINFO structure contains resource information and an application-defined value for
a dialog box supported by a Control Panel application. The CPlApplet function of the Control Panel application returns this information to the
Control Panel in response to a CPL_INQUIRE message.
typedef struct tagCPLINFO { // cpli
int idIcon;
int idName;
int idInfo;
LONG lData;
} CPLINFO;
Members
idIcon
Specifies the resource identifier of the icon that represents the dialog box.
idName
Specifies the resource identifier of the string containing the short name for
the dialog box. This name is intended to be displayed below the icon.
idInfo
Specifies the resource identifier of the string containing the description for
the dialog box. The description is the descriptive string that is intended to
be displayed when the application icon is selected.
lData
Specifies data defined by the application. When the Control Panel sends the CPL_DBLCLK 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. By processing
CPL_NEWINQUIRE, you can specify information based on the current state of the
computer. Using this technique is significantly slower, however, because the Control
Panel needs to load your application each time it sends the CPL_NEWINQUIRE
message.
See Also
CPL_DBLCLK, CPL_INQUIRE, CPL_NEWINQUIRE, CPL_STOP, CPlApplet
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|