【安富莱原创】【STemWin教程】第37章窗口管理器之ToolTip使用

ti

`第37章窗口管理器之Tooltip使用

本期教程跟大家讲一下STemWin自带的tooltip使用方法，对于外接鼠标设备的时候，这个控件就比较的有用。如果是用触摸进行操作的话，这个控件就用不上了。

37. 1 ToolTips介绍

37. 2 ToolTips实例

37. 3 总结

37.1 ToolTips介绍

关于ToolTips，大家应该比较的熟悉，只是不知道它专业的名字。下面这个就是ToolTips：

现在STemWin5.22版本支持的API如下：

`

硬汉Eric2013 · 2015-4-27 11:16:51

37.2 ToolTips实例

下面通过一个实例跟大家讲解一下ToolTips的使用，这个例子可以直接复制到模拟器或者开发板上面运行。

#include
#include "stdio.h"
#include "GUI.h"
#include "DIALOG.h"
#include "WM.h"
#include "BUTTON.h"
#include "CHECKBOX.h"
#include "DROPDOWN.h"
#include "EDIT.h"
#include "FRAMEWIN.h"
#include "LISTBOX.h"
#include "MULTIEDIT.h"
#include "RADIO.h"
#include "SLIDER.h"
#include "TEXT.h"
#include "PROGBAR.h"
#include "SCROLLBAR.h"
#include "LISTVIEW.h"
static int Count;
/*********************************************************************
*
* Dialog resource
*
* This table conatins the info required to create the dialog.
* It has been created by ucGUIbuilder.
*/
static const GUI_WIDGET_CREATE_INFO _aDialogCreate[] = {
{ FRAMEWIN_CreateIndirect, "armfly", 0, 0, 0, 800,480,FRAMEWIN_CF_MOVEABLE,0},
{ BUTTON_CreateIndirect, "BUTTON0", GUI_ID_BUTTON0, 82, 122,162,37, 0,0},
{ BUTTON_CreateIndirect, "BUTTON1", GUI_ID_BUTTON1, 357,123,152,35, 0,0},
{ TEXT_CreateIndirect, "0000", GUI_ID_TEXT0, 278,264,300,48, 0,0}
};
/*****************************************************************
** FunctionName:void PaintDialog(WM_MESSAGE * pMsg)
** Function: to initialize the Dialog items
**
** call this function in _cbCallback --> WM_PAINT
*****************************************************************/
void PaintDialog(WM_MESSAGE * pMsg)
{
WM_HWIN hWin = pMsg->hWin;
}
/*****************************************************************
** FunctionName:void InitDialog(WM_MESSAGE * pMsg)
** Function: to initialize the Dialog items
**
** call this function in _cbCallback --> WM_INIT_DIALOG
*****************************************************************/
void InitDialog(WM_MESSAGE * pMsg)
{
WM_HWIN hWin = pMsg->hWin;
//
//FRAMEWIN
//
FRAMEWIN_SetFont(hWin,&GUI_Font24B_ASCII);
FRAMEWIN_SetTextAlign(hWin,GUI_TA_VCENTER|GUI_TA_CENTER);
FRAMEWIN_AddCloseButton(hWin, FRAMEWIN_BUTTON_RIGHT, 0);
FRAMEWIN_AddMaxButton(hWin, FRAMEWIN_BUTTON_RIGHT, 1);
FRAMEWIN_AddMinButton(hWin, FRAMEWIN_BUTTON_RIGHT, 2);
FRAMEWIN_SetTitleHeight(hWin,30);
//
//GUI_ID_TEXT0
//
TEXT_SetFont(WM_GetDialogItem(hWin,GUI_ID_TEXT0),&GUI_FontD36x48);
}
/*********************************************************************
*
* Dialog callback routine
*/
static void _cbCallback(WM_MESSAGE * pMsg)
{
int NCode, Id;
char buf[10];
WM_HWIN hWin = pMsg->hWin;
switch (pMsg->MsgId)
{
case WM_TIMER:
Count++;
sprintf(buf, "%04d", Count);
TEXT_SetText(WM_GetDialogItem(hWin,GUI_ID_TEXT0), (const char *)buf);
WM_RestartTimer(pMsg->Data.v, 100);
break;
case WM_PAINT:
PaintDialog(pMsg);
break;
case WM_INIT_DIALOG:
InitDialog(pMsg);
break;
case WM_KEY:
switch (((WM_KEY_INFO*)(pMsg->Data.p))->Key)
{
case GUI_KEY_ESCAPE:
GUI_EndDialog(hWin, 1);
break;
case GUI_KEY_ENTER:
GUI_EndDialog(hWin, 0);
break;
}
break;
case WM_NOTIFY_PARENT:
Id = WM_GetId(pMsg->hWinSrc);
NCode = pMsg->Data.v;
switch (Id)
{
case GUI_ID_OK:
if(NCode==WM_NOTIFICATION_RELEASED)
GUI_EndDialog(hWin, 0);
break;
case GUI_ID_CANCEL:
if(NCode==WM_NOTIFICATION_RELEASED)
GUI_EndDialog(hWin, 0);
break;
case GUI_ID_BUTTON0:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
case WM_NOTIFICATION_MOVED_OUT:
break;
}
break;
case GUI_ID_BUTTON1:
switch(NCode)
{
case WM_NOTIFICATION_CLICKED:
break;
case WM_NOTIFICATION_RELEASED:
break;
case WM_NOTIFICATION_MOVED_OUT:
break;
}
break;
}
break;
default:
WM_DefaultProc(pMsg);
}
}
static const TOOLTIP_INFO _aInfo[] = {（1）
{ GUI_ID_BUTTON0, "I am Button 0"},
{ GUI_ID_BUTTON1, "I am Button 1" },
{ GUI_ID_TEXT0, "I am TEXT 0" },
};
/*********************************************************************
*
* MainTask
*
**********************************************************************
*/
void MainTask(void)
{
WM_HWIN hDlg;
WM_HTIMER hTimer;
WM_TOOLTIP_HANDLE hInfo;
WM_TOOLTIP_HANDLE hToolTip;
Count = 0;
/*
使能窗口使用内存设备，这样可以有效避免闪烁放在GUI_Init前面就包括桌面
窗口，如果放在后面就不包括桌面窗口。
*/
WM_SetCreateFlags(WM_CF_MEMDEV);
GUI_Init();
WM_SetDesktopColor(GUI_BLUE); /* Automacally update desktop window */
PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
FRAMEWIN_SetDefaultSkin(FRAMEWIN_SKIN_FLEX);
PROGBAR_SetDefaultSkin(PROGBAR_SKIN_FLEX);
BUTTON_SetDefaultSkin(BUTTON_SKIN_FLEX);
CHECKBOX_SetDefaultSkin(CHECKBOX_SKIN_FLEX);
DROPDOWN_SetDefaultSkin(DROPDOWN_SKIN_FLEX);
SCROLLBAR_SetDefaultSkin(SCROLLBAR_SKIN_FLEX);
SLIDER_SetDefaultSkin(SLIDER_SKIN_FLEX);
HEADER_SetDefaultSkin(HEADER_SKIN_FLEX);
RADIO_SetDefaultSkin(RADIO_SKIN_FLEX);
/* 创建一个对话框 */
hDlg = GUI_CreateDialogBox(_aDialogCreate, GUI_COUNTOF(_aDialogCreate), &_cbCallback, 0, 0, 0);
hTimer = WM_CreateTimer(WM_GetClientWindow(hDlg), 0, 100, 0);
hInfo = WM_TOOLTIP_Create(hDlg, _aInfo, GUI_COUNTOF(_aInfo));（2）
hToolTip = WM_TOOLTIP_Create(hDlg, NULL, 0);（3）
WM_TOOLTIP_AddTool(hToolTip, WM_GetClientWindow(hDlg), "I am a ToolTip");（4）
while (1)
{
GUI_Delay(500);
}
}