HGE 系列教材(9) --- GUI(本文未完成)

1. hge 中 GUI 对象和控件

hge 中 GUI 对象被看作是一个控件的容器,hge 提供了创建 GUI 对象的类 hgeGUI 类

 

2. hgeGUI 类

1)AddCtrl 函数

void AddCtrl(
hgeGUIObject *ctrl    // hgeGUIObject 对象的指针
);

我们通常可以有这样的写法:

gui->AddCtrl(new hgeGUIMenuItem(1,fnt,snd,400,200,0.0f,"Play"));

这里 hgeGUIMenuItem 是一个控件,继承于 hgeGUIObject 类,注意,我们创建了 hgeGUIObject 对象,但是却没有去销毁它,因为 hgeGUI 类的析构函数会去处理这些问题。

2)SetNavMode

设置 GUI 导航模式(Navigate mode):

void SetNavMode(
int navmode
);

HGEGUI_NONAVKEYS - 无键盘导航
HGEGUI_LEFTRIGHT - 左右按键导航
HGEGUI_UPDOWN - 上下按键导航
HGEGUI_CYCLED - 循环

默认情况下,navmode 被设置为 HGEGUI_NONAVKEYS,对于一个菜单,我们可以这样设置:

SetNavMode(HGEGUI_UPDOWN | HGEGUI_CYCLED);

使用上下键导航,并且循环。

3)SetCursor

设置光标 sprite:

void SetCursor(
hgeSprite *sprite
);
设置光标对应的 sprite,如果为0,表示不显示光标,默认情况为0。注意,光标不受 GUI 对象的管理,也就是用户必须自己释放光标资源。

4)SetFocus

void SetFocus(
int id
);

每个控件都有一个对应的 ID 号,这个 ID 号被称之为控件的标识符,这里通过控件标识符来设置焦点。键盘事件只会被分发到成为焦点的控件上。

5)Enter

开始 GUI Enter 动画

 

3. hgeGUIObject

hgeGUIObject 是一个抽象类,它有一个纯虚函数 Render

hgeGUIObject 类的子类的对象并不是 GUI 对象,而是 GUI 控件,这一点应该清楚

1)hgeGUIObject 的成员变量

hgeGUIObject 的成员变量都为 public:

// 必须在构造函数中初始化的变量

int      id;   // 控件标识符
bool     bStatic;    // 如果为 true 控件无法成为焦点也不会接受键盘事件,同时它将被 navigate 例程忽略(前面已谈到设置 navigate)
bool     bVisible;   // 控件是否可见,如果为 false,控件将不被渲染
bool     bEnabled;   // false 时,控件对用户的输入不作出任何回应,但是控件是可以接受到用户的通知(区别于 bStatic)
hgeRect rect;   // 控件有界框(bounding box)在屏幕上的区域
DWORD    color;   // 控件颜色
// 不需要在构造函数中初始化的变量
hgeGUI       *gui;   // GUI 对象指针
hgeGUIObject *next;   // 连接 GUI 对象中的所有控件,子类不需要改变它
hgeGUIObject *prev;   // 连接 GUI 对象中的所有控件,子类不需要改变它
// hge 指针
static HGE   *hge;

2)void Render(void)

渲染控件到屏幕

3)void Update(float fDt)

fDt 上次调用 Update 函数到现在所用的时间(单位是秒)

4)void Enter(void)

控件出现在屏幕上的时候被调用,用于播放控件出现时的动画

5)void Leave(void)

控件离开屏幕的时候被调用,用于播放控件离开屏幕的动画

6)bool IsDone(void)

判断控件出现动画和控件离开动画是否播放完毕

7)void Focus(bool bFocused)

控件获得焦点,bFocused 为 true,反之为 false

8)bool MouseMove(float x, float y)

以控件左上为原点,鼠标指针的坐标。如果控件状态改变,需要通知调用者,那么返回 true,否则返回 false

9)bool MouseLButton( bool bDown)

bDown 如果为 true,表示按下鼠标左键,如果 bDown 为 false,表示松开鼠标左键

10)bool KeyClick( int key, int chr)

key 表示按键的虚拟代码(Virtual code of the pressed key),见下表:

HGEK_LBUTTON Left mouse button
HGEK_RBUTTON Right mouse button
HGEK_MBUTTON Middle mouse button (wheel button)
 
HGEK_ESCAPE ESCAPE key
HGEK_BACKSPACE BACKSPACE key
HGEK_TAB TAB key
HGEK_ENTER Any of the two ENTER keys
HGEK_SPACE SPACE key
 
HGEK_SHIFT Any of the two SHIFT keys
HGEK_CTRL Any of the two CTRL keys
HGEK_ALT Any of the two ALT keys
 
HGEK_LWIN Left WINDOWS key
HGEK_RWIN Right WINDOWS key
HGEK_APPS APPLICATIONS key
 
HGEK_PAUSE PAUSE key
HGEK_CAPSLOCK CAPS LOCK key
HGEK_NUMLOCK NUM LOCK key
HGEK_SCROLLLOCK SCROLL LOCK key
 
HGEK_PGUP PAGE UP key
HGEK_PGDN PAGE DOWN key
HGEK_HOME HOME key
HGEK_END END key
HGEK_INSERT INSERT key
HGEK_DELETE DELETE key
 
HGEK_LEFT LEFT ARROW key
HGEK_UP UP ARROW key
HGEK_RIGHT RIGHT ARROW key
HGEK_DOWN DOWN ARROW key
 
HGEK_0 Main keyboard '0' key
HGEK_1 Main keyboard '1' key
HGEK_2 Main keyboard '2' key
HGEK_3 Main keyboard '3' key
HGEK_4 Main keyboard '4' key
HGEK_5 Main keyboard '5' key
HGEK_6 Main keyboard '6' key
HGEK_7 Main keyboard '7' key
HGEK_8 Main keyboard '8' key
HGEK_9 Main keyboard '9' key
 
HGEK_A 'A' key
HGEK_B 'B' key
HGEK_C 'C' key
HGEK_D 'D' key
HGEK_E 'E' key
HGEK_F 'F' key
HGEK_G 'G' key
HGEK_H 'H' key
HGEK_I 'I' key
HGEK_J 'J' key
HGEK_K 'K' key
HGEK_L 'L' key
HGEK_M 'M' key
HGEK_N 'N' key
HGEK_O 'O' key
HGEK_P 'P' key
HGEK_Q 'Q' key
HGEK_R 'R' key
HGEK_S 'S' key
HGEK_T 'T' key
HGEK_U 'U' key
HGEK_V 'V' key
HGEK_W 'W' key
HGEK_X 'X' key
HGEK_Y 'Y' key
HGEK_Z 'Z' key
 
HGEK_GRAVE Grave accent (`)
HGEK_MINUS Main keyboard MINUS key (-)
HGEK_EQUALS Main keyboard EQUALS key (=)
HGEK_BACKSLASH BACK SLASH key (/)
HGEK_LBRACKET Left square bracket ([)
HGEK_RBRACKET Right square bracket (])
HGEK_SEMICOLON Semicolon (;)
HGEK_APOSTROPHE Apostrophe (')
HGEK_COMMA Comma (,)
HGEK_PERIOD Main keyboard PERIOD key (.)
HGEK_SLASH Main keyboard SLASH key (/)
 
HGEK_NUMPAD0 Numeric keyboard '0' key
HGEK_NUMPAD1 Numeric keyboard '1' key
HGEK_NUMPAD2 Numeric keyboard '2' key
HGEK_NUMPAD3 Numeric keyboard '3' key
HGEK_NUMPAD4 Numeric keyboard '4' key
HGEK_NUMPAD5 Numeric keyboard '5' key
HGEK_NUMPAD6 Numeric keyboard '6' key
HGEK_NUMPAD7 Numeric keyboard '7' key
HGEK_NUMPAD8 Numeric keyboard '8' key
HGEK_NUMPAD9 Numeric keyboard '9' key
 
HGEK_MULTIPLY Numeric keyboard MULTIPLY key (*)
HGEK_DIVIDE Numeric keyboard DIVIDE key (/)
HGEK_ADD Numeric keyboard ADD key (+)
HGEK_SUBTRACT Numeric keyboard SUBTRACT key (-)
HGEK_DECIMAL Numeric keyboard DECIMAL key (.)
 
HGEK_F1 F1 key
HGEK_F2 F2 key
HGEK_F3 F3 key
HGEK_F4 F4 key
HGEK_F5 F5 key
HGEK_F6 F6 key
HGEK_F7 F7 key
HGEK_F8 F8 key
HGEK_F9 F9 key
HGEK_F10 F10 key
HGEK_F11 F11 key
HGEK_F12 F12 key

如果控件状态修改了,希望通知调用者,那么返回 true,否则为 false

你可能感兴趣的:(windows,equals,UP,float,button,keyboard)