AWTK用户手册：启用鼠标指针与开启按键音指南

"该文档是绿盟远程安全评估系统的2020年用户手册，主要介绍了如何在AWTK（ZLG GUI Toolkit）中启用鼠标指针和开启按键音的功能。AWTK是一个轻量级的GUI框架，适用于嵌入式设备和移动平台。" 在AWTK中启用鼠标指针分为两个步骤。首先，在`demo_main.c`文件中，通过定义预处理器宏`ENABLE_CURSOR`，可以启用鼠标指针。代码如下： ```c // awtk\demos\demo_main.c #ifdef ENABLE_CURSOR window_manager_set_cursor(window_manager(), "cursor"); #endif /*ENABLE_CURSOR*/ ``` 这行代码会调用`window_manager_set_cursor`函数，设置鼠标的指针形象。这里的"cursor"是鼠标的图片资源名，需要与实际的图片资源文件名一致。 如果要在自定义的应用程序中启用鼠标指针，你需要： 1. 添加鼠标指针的图片资源，例如"cursor.png"，并将其放置在资源目录下，如`res\assets\raw\images\xx`。 2. 在代码中调用`window_manager_set_cursor`函数，传入对应的图片资源名，如： ```c window_manager_set_cursor(window_manager(), "cursor"); ``` 关于指针图片的要求，考虑到在绘制指针时会将图片中心对准鼠标当前位置，因此在制作指针图片时，应确保图片设计符合这一规则，以实现正确的显示效果。 开启按键音是为用户提供操作反馈的一种方式，AWTK提供了一个`ui_feedback`接口来实现这一功能。由于AWTK自身不包含声音或震动的直接接口，开发者需要设置回调函数来处理声音播放或设备震动。回调函数`ui_on_feedback_t`的原型如下： ```c /** * @method ui_on_feedback_t * 回调函数。 * * @param {void*} ctx 回调函数的上下文，即 ui_feedback_init 中传递的 ctx。 * @param { widget_t *} widget 设置 feedback 属性的控件对象。 * @param { event_t *} evt 事件对象。 * @return {ret_t} 返回 RET_OK 表示成功，否则表示失败。 */ ret_t ui_on_feedback_t(void* ctx, widget_t* widget, event_t* evt); ``` 开发者可以通过`ui_feedback_init`函数设置这个回调，以便在按键或触屏事件发生时播放相应的声音或震动。 AWTK提供了一套灵活的机制，允许开发者自定义UI的行为，包括启用鼠标指针和创建个性化的按键反馈机制，以提升用户体验。对于嵌入式设备和移动应用的开发，这样的灵活性是至关重要的。