ShellNotifyMsg.h文件参考

Shell API. 更多...

组合类型

struct  MZ_USER_NOTIFICATION
 通知消息的结构 更多...
struct  MZ_USER_NOTIFICATION_HEADER

宏定义

#define MUN_CUSTOM_CB   0x00000080
 自定义按键按下后回调应用
#define MUN_DEFAULT_CB   0x00000040
 默认按键按下后回调应用
#define MUN_DIALOG   0x00000020
 显示对话框
#define MUN_ICON_TYPE_CANCEL   2
 按键上显示取消图标
#define MUN_ICON_TYPE_HIDE   4
 按键上显示隐藏图标
#define MUN_ICON_TYPE_OK   1
 按键上显示确定图标
#define MUN_ICON_TYPE_OPEN   3
 按键上显示打开图标
#define MUN_IMAGE_L   0x00000010
 任务列表上的图
#define MUN_IMAGE_S   0x00000008
 任务栏上的图
#define MUN_LED   0x00000001
 LED 灯闪烁.
#define MUN_SOUND   0x00000002
 播放声音
#define MUN_SOUND_FADEIN   0x00000200
 渐强音标志
#define MUN_SOUND_MAX   0x00000100
 最大声音长度标志，只播放一次，如果长度超过dwPlaySoundPeriod设置值，则播放到设置值。
#define MUN_URGENT   0x10000000
 紧急事件（优先处理）
#define MUN_VIBRATE   0x00000004
 震动
#define MUNH_DELETE   3
#define MUNH_SET   1
#define MUNH_UPDATE   2
#define MZ_HARDKEY_HOME   (0x00000001)
 M8硬按键定义.
#define MZ_HARDKEY_LINE   (0x00000020)
#define MZ_HARDKEY_PLAY   (0x00000004)
#define MZ_HARDKEY_POWER   (0x00000002)
#define MZ_HARDKEY_VOLUME_DOWN   (0x00000010)
#define MZ_HARDKEY_VOLUME_UP   (0x00000008)
#define WALLPAPER_ALL   0x0003
#define WALLPAPER_DESKTOP   0x0001
 更新桌面及待机界面的背景图
#define WALLPAPER_STANDBY   0x0002
#define WM_MZSH_ALL_KEY_EVENT   0x00000200
 所有硬按键消息
#define WM_MZSH_BATTERY_LOW   0x00000080
 电池电量低
#define WM_MZSH_BEGIN_SYNC_EVENT   0x00000400
 同步开始
#define WM_MZSH_CLICK_M_KEY   0x00000001
 注册Shell相关的通知消息。可同时注册/取消多个，以'|'组合
#define WM_MZSH_CLICK_TASKBAR   0x00000002
 点击任务栏
#define WM_MZSH_END_SYNC_EVENT   0x00000800
 同步结束
#define WM_MZSH_ENTRY_LOCKPHONE   0x00000004
 进入锁机界面
#define WM_MZSH_ENTRY_MUSIC   0x00000100
 开启音乐界面
#define WM_MZSH_ENTRY_SHUTDOWN   0x00000010
 进入关机界面
#define WM_MZSH_LEAVE_LOCKPHONE   0x00000008
 离开锁机界面
#define WM_MZSH_LEAVE_SHUTDOWN   0x00000020
 离开关机界面
#define WM_MZSH_NET_CONNECT   0x00001000
 网络连接（GPRS 和 WIFI）
#define WM_MZSH_NET_DISCONNECT   0x00002000
 网络断开（GPRS 和 WIFI）
#define WM_MZSH_READY_POWEROFF   0x00000040
 准备关机
#define WM_MZSH_SHOW_NOTIFY_WND   0x00004000
 准备显示通知消息窗口，如短信，闹钟等

类型定义

typedef enum _tagM8VolueType M8_VOLUME_TYPE
 音量显示类型
typedef struct
MZ_USER_NOTIFICATION * 		PMZ_USER_NOTIFICATION
typedef struct
MZ_USER_NOTIFICATION_HEADER * 		PMZ_USER_NOTIFICATION_HEADER
typedef enum _tagWparamRSM_SNW WPARAM_RSM_SNW
 GetShellNotifyMsg_ShowNotifyWnd的返回值参数.

枚举

enum  _tagM8VolueType { VOLUME_TYPE_UNKNOW = 0, VOLUME_TYPE_SPEAKER, VOLUME_TYPE_HEADPHONE, VOLUME_TYPE_RECEIVE }
 

音量显示类型

更多...
enum  _tagWparamRSM_SNW { WPARAM_RSM_SNW_SHOW_BEGIN = 0, WPARAM_RSM_SNW_RING_END, WPARAM_RSM_SNW_DIALOG_CANCEL, WPARAM_RSM_SNW_ENTRY_APP }
 

GetShellNotifyMsg_ShowNotifyWnd的返回值参数.

更多...
enum  TIPS_NUMBER_POS { TIPS_NUMBER_POS_RIGHTTOP = 0, TIPS_NUMBER_POS_CENTER, TIPS_NUMBER_POS_LEFT, TIPS_NUMBER_POS_RIGHT }
 

桌面图标显示提示数字的位置

更多...

函数

BOOL DisableChangeDisplaySetting ()
 关闭转屏功能，ChangeDisplaySettingsEx会返回失败。
BOOL EnableChangeDisplaySetting ()
 开启转屏功能。
UINT GetShellNotifyMsg_AllKeyEvent ()
 获取所有的硬按键消息
UINT GetShellNotifyMsg_BatteryLow ()
 获取电池电量低的消息
UINT GetShellNotifyMsg_ClickMKey ()
 获取点击"m"键消息
UINT GetShellNotifyMsg_ClickTaskbar ()
 获取点击任务栏消息
UINT GetShellNotifyMsg_EntryLockPhone ()
 获取进入锁机前消息
UINT GetShellNotifyMsg_EntryMusic ()
 获取开启Music界面的消息（相当于非锁机状态下，按PLAY键）
UINT GetShellNotifyMsg_EntryShutDown ()
 获取进入关机界面前的消息
UINT GetShellNotifyMsg_LeaveLockPhone ()
 获取离开锁机前的消息
UINT GetShellNotifyMsg_LeaveShutDown ()
 获取离开关机界面的消息
UINT GetShellNotifyMsg_NetConnect ()
 获取网络（GPRS,WIFI）连接的消息
UINT GetShellNotifyMsg_NetDisconnect ()
 获取网络（GPRS,WIFI）断开的消息
UINT GetShellNotifyMsg_ReadyPowerOFF ()
 获取准备关机的消息
UINT GetShellNotifyMsg_ShowNotifyWnd ()
 获取准备显示通知消息窗口，如短信，闹钟等的消息
UINT GetShellNotifyMsg_SyncBeginEvent ()
 获取同步开始的消息
UINT GetShellNotifyMsg_SyncEndEvent ()
 获取同步完成的消息
BOOL HideMzTopBar ()
 隐藏顶部的任务栏, 同时工作区到全屏
BOOL HoldShellBatteryLowWarningBox (HWND hWnd)
 阻止Shell弹出电量低的对话框
BOOL HoldShellUsingSomeKeyFunction (HWND hWnd, UINT uKeys)
 阻止Shell使用某些按键功能, 此功能注册后，会自动注册了WM_MZSH_ALL_KEY_EVENT 收到按键的消息定义和WM_MZSH_ALL_KEY_EVENT是一样的。
BOOL IsLockPhoneStatus ()
 静态地判断当前是否是锁机状态
BOOL MzBeginScreenRotate ()
 转屏之前，调用该API用来通知Shell准备转屏了。为了防止任务栏动画不美观
BOOL MzChangeDisplaySettingsEx (DWORD dwDmdo, BOOL bFullScreen=FALSE)
 转屏
BOOL MzClearUserNotification (HANDLE hNotification)
 清除通知消息
BOOL MzDisableSlideApp ()
 禁止从左上角关闭程序
BOOL MzDisableTaskbarList ()
 禁止使用任务栏列表。禁止从任务栏上拖出任务栏列表
BOOL MzEnableSlideApp ()
 能够从左上角关闭程序，默认状态
BOOL MzEnableTaskbarList ()
 能够使用任务栏列表。能够从任务栏上拖出任务栏列表，默认状态
BOOL MzEntryLockPhone ()
 通知Shell进入锁机界面
BOOL MzLeaveLockPhone ()
 通知Shell离开锁机界面
BOOL MzNotifyAppInitBegin ()
BOOL MzNotifyAppInitFinished ()
 通知Shell,本应用的启动初始化完成
BOOL MzPowerOffSystem ()
 通知Shell关闭系统
BOOL MzResetSystem ()
 通知Shell重启系统
HANDLE MzSetUserNotification (HANDLE hNotification, PMZ_USER_NOTIFICATION pMun)
 通知消息，出现在任务列表上的消息
BOOL NotifyShellUserNameChanged ()
 通知Shell用户昵称改变
BOOL RefreshWallpaper (int nPaper)
 更新桌面背景图、待机背景图
BOOL RegisterShellMessage (HWND hWnd, UINT uMsg)
 注册Shell的通知消息
BOOL ReloadDesktopIcons ()
 通知Shell重新刷新桌面上的图标，用于安装程序后图标更新
BOOL SetAnimateDesktopIcon (LPCTSTR strPID, LPCTSTR strTips, RECT &rcPos)
 指定桌面图标显示一段文字， 注意，该项设置有效的前提条件是注册表项的AnimateIcon必须设置为1
BOOL SetAnimateDesktopIcon (LPCTSTR strPID, int nNumber, TIPS_NUMBER_POS tipsNPos=TIPS_NUMBER_POS_RIGHTTOP)
 指定桌面图标显示提示数字（像未读短信图标上的提示）, 注意，该项设置有效的前提条件是注册表项的AnimateIcon必须设置为1
BOOL SetScreenAlwaysOn (HWND hWnd)
 使屏幕常亮(不自动黑屏进锁机状态)，使用完之后，一定要调用SetScreenAutoOff(); 该函数不能嵌套调用
BOOL SetScreenAutoOff ()
 使屏幕自动变暗，解除屏幕常亮状态
BOOL ShowAppQuitAnimate ()
 显示退出程序动画（非MZFC程序适用），PostQuitMessage(0)之前调用
BOOL ShowMzTopBar ()
 显示顶部的任务栏，同时工作区到任务栏之下
BOOL ShowVolumeWnd (M8_VOLUME_TYPE nType, int nVolClass)
 显示音量界面
BOOL UnHoldShellBatteryLowWarningBox (HWND hWnd)
 解除阻止Shell弹出电量低的对话框
BOOL UnHoldShellUsingSomeKeyFunction (HWND hWnd, UINT uKeys)
 解除阻止Shell使用某些按键功能
BOOL UnRegisterShellMessage (HWND hWnd, UINT uMsg)
 取消注册Shell的通知消息

详细描述

Shell API.

宏定义文档

#define MUN_CUSTOM_CB   0x00000080

自定义按键按下后回调应用

#define MUN_DEFAULT_CB   0x00000040

默认按键按下后回调应用

#define MUN_DIALOG   0x00000020

显示对话框

#define MUN_ICON_TYPE_CANCEL   2

按键上显示取消图标

#define MUN_ICON_TYPE_HIDE   4

按键上显示隐藏图标

#define MUN_ICON_TYPE_OK   1

按键上显示确定图标

#define MUN_ICON_TYPE_OPEN   3

按键上显示打开图标

#define MUN_IMAGE_L   0x00000010

任务列表上的图

#define MUN_IMAGE_S   0x00000008

任务栏上的图

#define MUN_LED   0x00000001

LED 灯闪烁.

#define MUN_SOUND   0x00000002

播放声音

#define MUN_SOUND_FADEIN   0x00000200

渐强音标志

#define MUN_SOUND_MAX   0x00000100

最大声音长度标志，只播放一次，如果长度超过dwPlaySoundPeriod设置值，则播放到设置值。

#define MUN_URGENT   0x10000000

紧急事件（优先处理）

#define MUN_VIBRATE   0x00000004

震动

#define MUNH_DELETE   3
#define MUNH_SET   1
#define MUNH_UPDATE   2
#define MZ_HARDKEY_HOME   (0x00000001)

M8硬按键定义.

#define MZ_HARDKEY_LINE   (0x00000020)
#define MZ_HARDKEY_PLAY   (0x00000004)
#define MZ_HARDKEY_POWER   (0x00000002)
#define MZ_HARDKEY_VOLUME_DOWN   (0x00000010)
#define MZ_HARDKEY_VOLUME_UP   (0x00000008)
#define WALLPAPER_ALL   0x0003
#define WALLPAPER_DESKTOP   0x0001

更新桌面及待机界面的背景图

#define WALLPAPER_STANDBY   0x0002
#define WM_MZSH_ALL_KEY_EVENT   0x00000200

所有硬按键消息

#define WM_MZSH_BATTERY_LOW   0x00000080

电池电量低

#define WM_MZSH_BEGIN_SYNC_EVENT   0x00000400

同步开始

#define WM_MZSH_CLICK_M_KEY   0x00000001

注册Shell相关的通知消息。可同时注册/取消多个，以'|'组合

按Home键

#define WM_MZSH_CLICK_TASKBAR   0x00000002

点击任务栏

#define WM_MZSH_END_SYNC_EVENT   0x00000800

同步结束

#define WM_MZSH_ENTRY_LOCKPHONE   0x00000004

进入锁机界面

#define WM_MZSH_ENTRY_MUSIC   0x00000100

开启音乐界面

#define WM_MZSH_ENTRY_SHUTDOWN   0x00000010

进入关机界面

#define WM_MZSH_LEAVE_LOCKPHONE   0x00000008

离开锁机界面

#define WM_MZSH_LEAVE_SHUTDOWN   0x00000020

离开关机界面

#define WM_MZSH_NET_CONNECT   0x00001000

网络连接（GPRS 和 WIFI）

#define WM_MZSH_NET_DISCONNECT   0x00002000

网络断开（GPRS 和 WIFI）

#define WM_MZSH_READY_POWEROFF   0x00000040

准备关机

#define WM_MZSH_SHOW_NOTIFY_WND   0x00004000

准备显示通知消息窗口，如短信，闹钟等

类型定义文档

typedef enum _tagM8VolueType M8_VOLUME_TYPE

音量显示类型

typedef struct MZ_USER_NOTIFICATION * PMZ_USER_NOTIFICATION
typedef struct MZ_USER_NOTIFICATION_HEADER * PMZ_USER_NOTIFICATION_HEADER
typedef enum _tagWparamRSM_SNW WPARAM_RSM_SNW

GetShellNotifyMsg_ShowNotifyWnd的返回值参数.

枚举类型文档

enum _tagM8VolueType

音量显示类型

枚举值:
VOLUME_TYPE_UNKNOW 
VOLUME_TYPE_SPEAKER 

外放喇叭

VOLUME_TYPE_HEADPHONE 

耳塞

VOLUME_TYPE_RECEIVE 

听筒

enum _tagWparamRSM_SNW

GetShellNotifyMsg_ShowNotifyWnd的返回值参数.

枚举值:
WPARAM_RSM_SNW_SHOW_BEGIN 
WPARAM_RSM_SNW_RING_END 
WPARAM_RSM_SNW_DIALOG_CANCEL 
WPARAM_RSM_SNW_ENTRY_APP 
enum TIPS_NUMBER_POS

桌面图标显示提示数字的位置

枚举值:
TIPS_NUMBER_POS_RIGHTTOP 
TIPS_NUMBER_POS_CENTER 
TIPS_NUMBER_POS_LEFT 
TIPS_NUMBER_POS_RIGHT 

函数文档

BOOL DisableChangeDisplaySetting (  ) 

关闭转屏功能，ChangeDisplaySettingsEx会返回失败。

返回:
TRUE, 成功; FALSE， 失败
参见:
EnableChangeDisplaySetting()
注解:
用完之后，一定要调用EnableChangeDisplaySetting()还原转屏功能 该函数不能嵌套调用
BOOL EnableChangeDisplaySetting (  ) 

开启转屏功能。

返回:
TRUE, 成功; FALSE， 失败
参见:
DisableChangeDisplaySetting()
UINT GetShellNotifyMsg_AllKeyEvent (  ) 

获取所有的硬按键消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_BatteryLow (  ) 

获取电池电量低的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_ClickMKey (  ) 

获取点击"m"键消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_ClickTaskbar (  ) 

获取点击任务栏消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_EntryLockPhone (  ) 

获取进入锁机前消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_EntryMusic (  ) 

获取开启Music界面的消息（相当于非锁机状态下，按PLAY键）

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_EntryShutDown (  ) 

获取进入关机界面前的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_LeaveLockPhone (  ) 

获取离开锁机前的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_LeaveShutDown (  ) 

获取离开关机界面的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_NetConnect (  ) 

获取网络（GPRS,WIFI）连接的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_NetDisconnect (  ) 

获取网络（GPRS,WIFI）断开的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_ReadyPowerOFF (  ) 

获取准备关机的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_ShowNotifyWnd (  ) 

获取准备显示通知消息窗口，如短信，闹钟等的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
注解:
wparam 为0，表示通知框开始显示，为1表示铃声结束，为2表示对话框取消，为3表示准备进入应用程序。
UINT GetShellNotifyMsg_SyncBeginEvent (  ) 

获取同步开始的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
UINT GetShellNotifyMsg_SyncEndEvent (  ) 

获取同步完成的消息

返回:
大于0表示消息值，0代表失败
参见:
RegisterShellMessage()
BOOL HideMzTopBar (  ) 

隐藏顶部的任务栏, 同时工作区到全屏

返回:
TRUE, 成功; FALSE， 失败
BOOL HoldShellBatteryLowWarningBox ( HWND  hWnd  ) 

阻止Shell弹出电量低的对话框

参数:
hWnd [IN]，调用该函数的窗口句柄
返回:
TRUE, 成功; FALSE， 失败
BOOL HoldShellUsingSomeKeyFunction ( HWND  hWnd,
UINT  uKeys 
)

阻止Shell使用某些按键功能, 此功能注册后，会自动注册了WM_MZSH_ALL_KEY_EVENT 收到按键的消息定义和WM_MZSH_ALL_KEY_EVENT是一样的。

参数:
hWnd [IN]，调用该函数的窗口句柄
uKeys [IN], 各键的组合，可以用|组合，按键定义在上面
返回:
TRUE, 成功; FALSE， 失败 Note : 一定要在使用之后记得释放
参见:
MZ_HARDKEY_HOME
BOOL IsLockPhoneStatus (  ) 

静态地判断当前是否是锁机状态

返回:
TRUE 锁机状态， FALSE 非锁机状态
BOOL MzBeginScreenRotate (  ) 

转屏之前，调用该API用来通知Shell准备转屏了。为了防止任务栏动画不美观

参数:
无。 
返回:
TRUE成功，FALSE失败
BOOL MzChangeDisplaySettingsEx ( DWORD  dwDmdo,
BOOL  bFullScreen = FALSE 
)

转屏

参数:
dwDmdo,期望转屏的方向:DMDO_0， DMDO_90， DMDO_180， DMDO_270
bFullScreen,是否要全屏？选择TRUE将会全屏（不显示任务栏），FALSE显示任务栏 
返回:
TRUE, 成功; FALSE， 失败
注解:
转屏后如果需要调整窗口的位置，需要响应WM_SETTINGCHANGE 消息。
BOOL MzClearUserNotification ( HANDLE  hNotification  ) 

清除通知消息

参数:
[IN]hNotification，这个通知消息句柄。 
返回:
TRUE成功，FALSE失败
BOOL MzDisableSlideApp (  ) 

禁止从左上角关闭程序

参数:
无。 
返回:
TRUE成功，FALSE失败
BOOL MzDisableTaskbarList (  ) 

禁止使用任务栏列表。禁止从任务栏上拖出任务栏列表

参数:
无。 
返回:
TRUE成功，FALSE失败
BOOL MzEnableSlideApp (  ) 

能够从左上角关闭程序，默认状态

参数:
无。 
返回:
TRUE成功，FALSE失败
BOOL MzEnableTaskbarList (  ) 

能够使用任务栏列表。能够从任务栏上拖出任务栏列表，默认状态

参数:
无。 
返回:
TRUE成功，FALSE失败
BOOL MzEntryLockPhone (  ) 

通知Shell进入锁机界面

返回:
TRUE, 成功; FALSE， 失败
BOOL MzLeaveLockPhone (  ) 

通知Shell离开锁机界面

返回:
TRUE, 成功; FALSE， 失败
BOOL MzNotifyAppInitBegin (  ) 
BOOL MzNotifyAppInitFinished (  ) 

通知Shell,本应用的启动初始化完成

参数:
无。 
返回:
TRUE成功，FALSE失败 仅在Shell初始化是有效, 并且该应用要依赖于Shell的启动完成后启动。
BOOL MzPowerOffSystem (  ) 

通知Shell关闭系统

返回:
TRUE, 成功; FALSE， 失败
BOOL MzResetSystem (  ) 

通知Shell重启系统

返回:
TRUE, 成功; FALSE， 失败
HANDLE MzSetUserNotification ( HANDLE  hNotification,
PMZ_USER_NOTIFICATION  pMun 
)

通知消息，出现在任务列表上的消息

参数:
[IN]hNotification，为0表示新建一个通知消息，否则为更新这个通知消息。 
[IN]pMun ，通知消息的内容
返回:
返回通知句柄，NULL失败
参见:
MZ_USER_NOTIFICATION
BOOL NotifyShellUserNameChanged (  ) 

通知Shell用户昵称改变

返回:
TRUE, 成功; FALSE， 失败
BOOL RefreshWallpaper ( int  nPaper  ) 

更新桌面背景图、待机背景图

参数:
nPaper [IN]，背景图(上面的消息定义)
返回:
TRUE, 成功; FALSE， 失败
参见:
WALLPAPER_DESKTOP
BOOL RegisterShellMessage ( HWND  hWnd,
UINT  uMsg 
)

注册Shell的通知消息

参数:
hWnd [IN]，注册的窗口句柄
uMsg [IN], 注册的消息， 定义在上面，可组合使用
返回:
TRUE, 成功; FALSE， 失败
参见:
WM_MZSH_CLICK_M_KEY
BOOL ReloadDesktopIcons (  ) 

通知Shell重新刷新桌面上的图标，用于安装程序后图标更新

返回:
TRUE, 成功; FALSE， 失败
BOOL SetAnimateDesktopIcon ( LPCTSTR  strPID,
LPCTSTR  strTips,
RECT &  rcPos 
)

指定桌面图标显示一段文字， 注意，该项设置有效的前提条件是注册表项的AnimateIcon必须设置为1

参数:
strPID [IN]，应用程序对应用PID，注册表中的ProgamID项（唯一标识某个应用程序或图标），使用创建GUID的工具获取全球唯一字串。
strTips [IN]，显示的字符，字符的大小根据给定的RECT和字符长度自动调节,最大支持16个字符长度
rcPos [IN]，提示放在图标上相对的位置, 目前图标大小为96*96, RECT 应当小于这个值
返回:
TRUE, 成功; FALSE， 失败
BOOL SetAnimateDesktopIcon ( LPCTSTR  strPID,
int  nNumber,
TIPS_NUMBER_POS  tipsNPos = TIPS_NUMBER_POS_RIGHTTOP 
)

指定桌面图标显示提示数字（像未读短信图标上的提示）, 注意，该项设置有效的前提条件是注册表项的AnimateIcon必须设置为1

参数:
strPID [IN]，应用程序对应用PID，注册表中的ProgamID项（唯一标识某个应用程序或图标），使用创建GUID的工具获取全球唯一字串。
nNumber [IN]，提示的数字（0~99）,0不会显示，超过99,只显示99
tipsNPos [IN]，提示放在图标上相对的位置，见TIPS_NUMBER_POS
返回:
TRUE, 成功; FALSE， 失败
参见:
TIPS_NUMBER_POS
BOOL SetScreenAlwaysOn ( HWND  hWnd  ) 

使屏幕常亮(不自动黑屏进锁机状态)，使用完之后，一定要调用SetScreenAutoOff(); 该函数不能嵌套调用

参数:
hWnd [IN]，调用该函数的窗口句柄
返回:
TRUE, 成功; FALSE， 失败
参见:
SetScreenAutoOff()
BOOL SetScreenAutoOff (  ) 

使屏幕自动变暗，解除屏幕常亮状态

返回:
TRUE, 成功; FALSE， 失败
参见:
SetScreenAlwaysOn()
BOOL ShowAppQuitAnimate (  ) 

显示退出程序动画（非MZFC程序适用），PostQuitMessage(0)之前调用

返回:
TRUE, 成功; FALSE， 失败
BOOL ShowMzTopBar (  ) 

显示顶部的任务栏，同时工作区到任务栏之下

返回:
TRUE, 成功; FALSE， 失败
BOOL ShowVolumeWnd ( M8_VOLUME_TYPE  nType,
int  nVolClass 
)

显示音量界面

参数:
nType [IN], 音量的类型，目前支持三种，喇叭，耳塞，听筒
nVolClass [IN], 需要显示的等级，目前显示范围为0~15级。
返回:
TRUE 成功， FALSE 失败
参见:
M8_VOLUME_TYPE
BOOL UnHoldShellBatteryLowWarningBox ( HWND  hWnd  ) 

解除阻止Shell弹出电量低的对话框

参数:
hWnd [IN]，调用该函数的窗口句柄
返回:
TRUE, 成功; FALSE， 失败
BOOL UnHoldShellUsingSomeKeyFunction ( HWND  hWnd,
UINT  uKeys 
)

解除阻止Shell使用某些按键功能

参数:
hWnd [IN]，调用该函数的窗口句柄
uKeys [IN], 各键的组合，可以用|组合，按键定义在上面
返回:
TRUE, 成功; FALSE， 失败
参见:
MZ_HARDKEY_HOME
BOOL UnRegisterShellMessage ( HWND  hWnd,
UINT  uMsg 
)

取消注册Shell的通知消息

参数:
hWnd [IN]，注册的窗口句柄
uMsg [IN], 注册的消息， 定义在上面，可组合使用
返回:
TRUE, 成功; FALSE， 失败
参见:
WM_MZSH_CLICK_M_KEY
Generated at Tue Feb 9 15:09:51 2010 for Meizu M8 SDK Documentation by  doxygen 1.6.1