MMI_WIN_PRIORITY_E win_priority = WIN_LOWEST_LEVEL;
MMI_WIN_ID_Talert_win_id=MMICMSBRW_NEWPUSH_WIN_ID;
MMIPUB_OpenAlertWinByTextPtr(
&time_out,
&prompt_str,
Mocor MMI Pubwin Interface User Guide
Version:1.0.0
DocCode:SW-MOCOR-UG-0019
Date:2008-01-25

重要声明
版权声明
本文档中的任何内容受《中华人民共和国著作权法》的保护，版权所有© 2008，展讯通信有限公司，保留所有权利，但注明引用其他方的内容除外。
MMI_IMAGE_ID_Tprompt_image_id;
MMI_ANIM_ID_Twait_anim_id;
MMI_TEXT_ID_Tsoftkey_id[GUISOFTKEY_BUTTON_NUM];
MMIPUB_SOFTKEY_STYLE_Esoftkey_style;
MMITHEME_PUBWIN_Tpubwin_theme;
商标声明
展讯通信有限公司和展讯通信有限公司的产品是展讯通信有限公司专有。在提及其他公司及其产品时将使用各自公司所拥有的商标，这种使用的目的仅限于引用。
不作保证声明
展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证，而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。
MMI_GetLabelTextByLang(TXT_SMS_NEW_MSG, &prompt_str);
MMIPUB_SetAlertWinTextByPtr(
MMISMS_NEWMSG_WIN_ID,
&prompt_str,
PNULL,
TRUE
);
三.1.6
【函数原型】
PUBLIC BOOLEANMMIPUB_CloseAlertWin(void);
MMI_WIN_ID_Twin_id;
MMI_MESSAGE_ID_Euser_msg_id;
} MMIPUB_INFO_T;
【参数说明】
参数名称
含义
id
Pubwin的窗口ID。这个不是窗口的ID
is_enter_anim_last_frame
is the last frame of enter anim
win_id_ptr：窗口ID，默认为MMIPUB_ALERT_WIN_ID；
win_priority_ptr：alert窗口优先级，默认为WIN_ONE_LEVEL；
softkey_style：softkey类型；
handle_func：处理函数。
【返回值】
无。
【注意事项】
无。
【范例/伪代码】
uint32time_out = 0;
一.2
图11描述了Pubwin在总体结构中的位置。它为上层应用程序提供了一种透明的服务机制。用户不需要关心实际上的pubwin的创建，销毁，消息处理等具体过程，而只需要在适当的时候创建并调用相应的处理函数即可。
图11Pubwin模块在总体结构中的位置
第二章
二.1
常量名
取值
说明
MMIPUB_WAIT_TEXT_LAEBL_NUM
wait_text_num
text number of wait window
timer_id
timerID
time_periodt
time period
prompt_image_id
prompt imageID
wait_anim_id
等待动画ID
softkey_id[]
softkeyID
softkey_style
MMI_STRING_T*text1_ptr,
MMI_STRING_T*text2_ptr,
MMI_IMAGE_ID_Timage_id,
MMI_WIN_ID_T*win_id_ptr,
MMI_WIN_PRIORITY_E*win_priority_ptr,
MMIPUB_SOFTKEY_STYLE_Esoftkey_style,
保密声明
本文档（包括任何附件）包含的信息是保密信息。接收人了解其获得的本文档是保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第三方。
前言
文档说明
本文档描述了Pubwin的对外接口。
阅读对象
本文档适用于MMI相关开发人员。
内容介绍
本文档包括三个章节，分别为：
第一章：概述。简单介绍了Pubwin模块的特点；
Softkey类型
pubwin_theme
public window theme
win_id
窗口ID
user_msg_id
用户消息ID
第三章
三.1
三.1.1
【函数原型】
PUBLICvoidMMIPUB_OpenAlertWinByTextId(
uint32*time_period_ptr,
MMI_TEXT_ID_Ttext1_id,
win_priority_ptr：窗口优先级，默认为WIN_ONE_LEVEL；
softkey_style：softkey类型；
handle_func：处理函数。
【返回值】
无。
【注意事项】
无。
三.1.2
【函数原型】
PUBLICvoidMMIPUB_OpenAlertWinByTextPtr(
uint32*time_period_ptr,
if(MMIPUB_GetAlertTimerId(win_id) == *(uint8*)param)
{
……
}
三.1.5
【函数原型】
PUBLIC voidMMIPUB_SetAlertWinTextByPtr(
MMI_WIN_ID_Twin_id,
MMI_STRING_T*text1_ptr,
MMI_STRING_T*text2_ptr,
3
等待窗口所能设置的Text的最大数目
二.2
二.2.1
【含义】
MMIPUB_SOFTKEY_STYLE_E定义了Softkey类型。
【定义】
typedef enum
{
MMIPUB_SOFTKEY_NONE,
MMIPUB_SOFTKEY_ONE,
MMIPUB_SOFTKEY_OKEXIT,
MMIPUB_SOFTKEY_OKCANCEL,
enter_timer_id
enter anim timerID
cur_enter_anim_frame
currentframe of enter anim,default 0,from 0 to max-1
burst_snapshot_callback
call back function forburstsnapshot
【定义】
typedef struct
{
uint32id;
BOOLEANis_enter_anim_last_frame;
uint8enter_timer_id;
uint16cur_enter_anim_frame;
uint8wait_text_num;
uint8timer_id;
uint32time_period;
【依赖关系】
无。
【注意事项】
无。
【范例/伪代码】
MMI_RESULT_E recode = MMI_RESULT_TRUE;
recode = MMIPUB_HandleAlertWinMsg(win_id,msg_id,param);
三.1.4
【函数原型】
PUBLIC uint8MMIPUB_GetAlertபைடு நூலகம்imerId(
两个softkey，分别为ok和exit
MMIPUB_SOFTKEY_OKCANCEL
两个softkey，分别为ok和cancel
MMIPUB_SOFTKEY_CUSTOMER
用户自定义softkey
MMIPUB_SOFTKEY_MAX
定义枚举最大值
二.3
二.3.1
【含义】
MMIPUB_INFO_T定义了Pubwin信息。
MMI_TEXT_ID_Ttext2_id,
MMI_IMAGE_ID_Timage_id,
MMI_WIN_ID_T*win_id_ptr,
MMI_WIN_PRIORITY_E*win_priority_ptr,
MMIPUB_SOFTKEY_STYLE_Esoftkey_style,
MMIPUB_HANDLE_FUNChandle_func
第二章：数据类型。介绍了Pubwin所涉及到的数据类型，包括枚举、结构等；
第三章：API函数。详细描述了相关API函数的定义及说明。
文档约定
本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。
注意：
提醒操作中应注意的事项。
说明：
说明比较重要的事项。
相关文档
第一章
一.1
Pubwin是窗口的一种，用于显示提示、提醒等信息。按功能分，可将Pubwin分为三种：警告（alert）窗口、询问（query）窗口以及等待（waiting）窗口。本文简要的介绍了Pubwin模块的对外接口。包括窗口的创建、打开、消息处理以及softkey处理等。
PNULL,
IMAGE_PUBWIN_NEWMSG,