讯息处理

【勇芳软件工作室】汉化HomePreviousNext

CPlApplet回调函数处理由控制应用程序发送到控制面板应用程序的所有消息。该函数希望以特定顺序发送消息。控制应用程序期望以特定的方式处理消息。

当控制应用程序首先加载控制面板应用程序时,CPlApplet功能将收到CPL_INIT消息。该函数应该执行任何初始化,如分配内存,并返回非零。如果CPlApplet无法完成初始化,则必须返回零,指示控制应用程序终止通信并释放DLL。

只有CPL_INIT消息成功,CPlApplet功能才会收到CPL_GETCOUNT消息。该函数必须返回控制面板应用程序支持的对话框数。

CPlApplet功能为控制面板应用程序支持的每个对话框收到一条CPL_INQUIRE消息和一条CPL_NEWINQUIRE消息。该函数将填写CPLINFONEWCPLINFO结构,其中包含有关应用程序的信息,例如其名称,图标和描述性字符串。大多数应用程序应处理CPL_INQUIRE消息,并忽略CPL_NEWINQUIRE消息。CPL_INQUIRE消息以控制应用程序可以缓存的形式提供信息,从而实现更好的性能。CPL_NEWINQUIRE消息仅在需要根据计算机的状态更改应用程序的图标或显示字符串时有用。

CPlApplet功能收到一条CPL_DBLCLK消息,作为用户已选择表示该对话框的图标的通知。该函数可以接收此消息任何次数。该消息包括对话框标识符和LDATA值。该函数应显示相应的对话框并处理后续用户输入。

在控制应用程序终止之前,CPlApplet为控制面板应用程序支持的每个对话框收到一次CPL_STOP消息。该消息包括对话框的标识符和LDATA值。该函数应该释放它为指定对话框分配的任何内存。

在最后一个CPL_STOP消息之后,CPlApplet收到CPL_EXIT消息。该函数应该释放所有剩余的分配的内存,并取消注册它可能注册的任何私有窗口类。函数从该消息返回后,控制应用程序立即通过调用FreeLibrary功能释放控制面板应用程序。