Microsoft KB Archive/262765

{|
 * width="100%"|

DOC: Selecting the Icon Group for a Control Panel Dialog Box

 * }

Q262765

-

The information in this article applies to:


 * Microsoft Windows CE Platform SDK for Pocket PC

-

SUMMARY
When you create a Control Panel application for Pocket PC, a dialog box's icon may appear in one of three different Settings pages. CPL_IDNAME is a new message that allows the Control Panel application code to select one of these three icon groups for each dialog box. Documentation for this message is not in the Pocket PC SDK that is included with Microsoft Windows CE eMbedded Tools version3.0.

CPL_IDNAME
This message is sent to a Control Panel application to request the name of the registry subkey that contains a dialog box's group number.

"uAppNum = (UINT)lParam1;" Dialog box number. This number must be in the range zero through one less than the value returned in response to the CPL_GETCOUNT message (CPL_GETCOUNT - 1).

"pszSubkey = (LPTSTR)lParam2;" Key name buffer. This is a pointer to a 32-character array that will receive a NULL terminated name of the subkey that holds the dialog box's group value.

Return Values
Zero indicates that the CPlApplet function processes this message successfully. Nonzero indicates otherwise.

Remarks
The icon group is determined by the value located at:

"HKEY_LOCAL_MACHINE\ControlPanel\" Value Name: Group

Data Type: DWORD

This value indicates the group that the icon will appear in. For Pocket PC, these are:

0 = Personal

1 = System (default)

2 = Connections Handling of this message is only required if the icon should be in a group other than the default.