contiki学习笔记（二）CTK图形界面

CTK 图形界面

Contiki 工具包(CTK)为康智奇系统提供了图形用户界面

Modules
CTK device driver functions CTK设备驱动程序功能

CTK设备驱动程序功能分为两个模块，CTK -draw模块和CTK -arch模块。

CTK events
CTK application functions

一个应用程序使用的CTK函数。

文件
file ctk-draw.h

CTK屏幕绘图模块接口，CTK -draw。

file ctk.c

contiki工具包CTK，contikiGUI。

file ctk.h

CTK header file.

函数

unsigned char	ctk_arch_keyavail (void)
 	//Checks the key press input queue to see if there are pending keys. 
 	//检查按键输入队列，看看是否有暂挂的按键。
ctk_arch_key_t 	ctk_arch_getkey (void)
 	//Retrieves key presses from the VNC client. 
 	//从VNC客户端检索按键。
void	ctk_mode_set (unsigned char mode)
 	//Sets the current CTK mode. 
 	//设置当前的CTK模式。
unsigned char	ctk_mode_get (void)
 	//Retrieves the current CTK mode. 
 	//检索当前的CTK模式。
CCIF void	ctk_window_new (struct ctk_window *window, unsigned char w, unsigned char h, char *title)
 	//Create a new window. 
 	//创建一个新窗口。
CCIF void	ctk_window_clear (struct ctk_window *w)
 	//Remove all widgets from a window. 
 	//从窗口中删除所有小部件。
CCIF void	ctk_window_close (struct ctk_window *w)
 	//Close a window if it is open. 
 	//如果窗口开着，就把它关上。
CCIF void	ctk_window_redraw (struct ctk_window *w)
 	//Redraw a window. 
 	//重新绘制窗口。
CCIF void	ctk_menu_add (struct ctk_menu *menu)
 	//Add a menu to the menu bar. 
 	//将菜单添加到菜单栏。
CCIF void	ctk_menu_remove (struct ctk_menu *menu)
 	//Remove a menu from the menu bar. 
 	//从菜单栏中删除一个菜单。

详细描述
Contiki工具包(CTK)为康智奇系统提供了图形用户界面。

函数文档

ctk_arch_key_t ctk_arch_getkey	(	void		)	
//从VNC客户端检索按键。
//由CTK模块调用。

返回值:
输入队列中的下一个键。

unsigned char ctk_arch_keyavail	(	void		)	
//检查按键输入队列，看看是否有暂挂的按键。
//由CTK模块调用。

返回值:
如果缓冲区中没有按键，则为零;如果输入缓冲区中有按键，则为非零。

CCIF void ctk_menu_add	(	struct ctk_menu * 	menu	)	
//将菜单添加到菜单栏。

参数:
menu 要添加的菜单。
注意事项:
不要对同一个菜单多次调用这个函数，因为没有检查菜单是否已经在菜单栏中。

CCIF void ctk_menu_remove	(	struct ctk_menu * 	menu	)	
//从菜单栏中删除一个菜单。

参数:
menu 要删除的菜单

unsigned char ctk_mode_get	(	void		)	
//检索当前的CTK模式。

返回值:
当前的CTK模式。

void ctk_mode_set	(	unsigned char	m	)	
//设置当前的CTK模式。

CTK模式可以是CTK_MODE_NORMAL、CTK_MODE_SCREENSAVER或CTK_MODE_EXTERNAL。CTK_MODE_NORMAL是正常模式，在这种模式中，将处理按键和鼠标指针移动，并重新绘制屏幕。在CTK_MODE_SCREENSAVER中，不执行屏幕重绘，第一次按键或指针移动将导致发出ctk_signal_screensaver_stop。在CTK_MODE_EXTERNAL模式中，键按和指针移动被忽略，不进行屏幕重绘。

参数:
m 模式

CCIF void ctk_window_clear	(	struct ctk_window * 	w	)	
//从窗口中删除所有小部件。

参数:
w 要清除的窗口。

CCIF void ctk_window_close	(	struct ctk_window * 	w	)	
//如果窗口开着，就把它关上。
//如果窗口未打开，则此函数不执行任何操作。

参数:
w 要关的窗口。

CCIF void ctk_window_new	(	struct ctk_window * 	window,
unsigned char	w,
unsigned char	h,
char *	title 
)		
//Create a new window.

创建一个新窗口。窗口结构的内存必须已经由调用者分配，并且通常使用静态声明来完成。
这个函数设置ctk_window结构体的内部结构，并创建移动和关闭按钮，但它不打开窗口。必须通过调用ctk_window_open()函数显式地打开窗口。

Parameters:
window The window to be created.
w 新窗口的宽度。
h 新窗口的高度。
title 新窗口的标题。

CCIF void ctk_window_redraw	(	struct ctk_window * 	w	)	
//重新绘制窗口
//这个函数会重新绘制窗口，但前提是它是桌面上最重要的窗口。

参数：
w 要重绘制的窗口。