【安富莱原创】【STemWin教程】第38章控件基础知识

**第38章控件基础知识**

第38章控件基础知识

本期教程开始给大家讲控件方面的知识，这部分知识主要来自官方手册。

控件是具有对象类型属性的各种窗口，是组成用户界面的元素。它们可自动对某些事件作出反应；例如，按下某按钮后，它可以不同状态显示。小工具需要创建，具有可在存续期间随时更改的属性，并通常在不再需要时被删除。正如窗口一样，小工具通过其创建函数返回的句柄进行引用。

控件要求使用窗口管理器。控件创建后，可像其他任何窗口一样处理它；WM确保了在必要时随时正确显示（并重绘）它。控件不是编写应用程序或用户界面所必需的，但它们可大大简化编程。

38. 1 当前支持的控件

38. 2 控件的重绘机制

38. 3 如何使用控件

38. 4 控件配置选项

38. 5 通用控件API

38. 6 常用函数

38. 7 总结

38.1当前支持的控件

这部分内容在前面1.3.6小节已经有讲解了，这里就是给大家提示一下。

38.2控件的重绘机制

控件根据其属性绘制自身，此操作在调用WM_Exec()、GUI_Exec()或GUI_Delay()时执行。在多任务环境中，通常由后台任务来调用WM_Exec()并更新控件（以及所有其他具有回调函数的窗口）。

控件的属性更改后，该控件的窗口（或部分窗口）会被标记为无效，但不会立即重绘。因此，代码段的执行速度会非常快。重绘由WM在稍后执行，或者通过为该小工具调用WM_Paint()强制执行（或直到重绘所有窗口时调用WM_Exec()）。

硬汉Eric2013 · 2015-4-28 10:39:46

38.3如何使用控件

假设我们要显示一个进度条。所需的只是以下代码：

PROGBAR_Handle hProgBar;

GUI_DispStringAt("Progress bar", 100, 20);

hProgBar = PROGBAR_Create(100, 40, 100, 20, WM_CF_SHOW);

其中第一行为控件的句柄保留内存，最后一行实际创建该控件。稍后或者在某单独任务中调用WM_Exec()时，窗口管理器会自动绘制此控件。每种类型的控件都有若干能够修改其外观的成员函数。控件创建后，可通过调用其成员函数之一更改其属性。这些函数使用控件的句柄作为第一个自变量。要使上述创建的进度条显示45%并将条颜色从默认设置（深灰/浅灰）更改为绿色/红色，可使用以下代码段：

PROGBAR_SetBarColor(hProgBar, 0, GUI_GREEN);

PROGBAR_SetBarColor(hProgBar, 1, GUI_RED);

PROGBAR_SetValue(hProgBar, 45);

38.3.1默认配置

所有控件都还具有一个或多个配置宏，它们定义各种默认设置（如所使用的字体和颜色）。在后面讲解到这些控件的时候再跟大家详细讲解。

38.3.2控件如何通讯

控件通常作为子窗口创建，父窗口可为任何窗口类型，甚至是另一种控件。为了确保同步，无论何时父窗口的任何子项有任何事件发生，通常都应通知父窗口。有事件发生时，子窗口控件通过发送WM_NOTIFY_PARENT消息与其父窗口通信。作为消息一部分发送的通知代码取决于事件。大多数控件都有定义不同类型事件的一个或多个通知代码，每种控件可用的通知代码（如果有）会在后面的教程中给大家列出。

38.3.3皮肤设置

控件的外观可使用其各自的成员函数进行修改，其中一些支持皮肤设置。如果对某控件使用了皮肤设置，则 “皮肤”将决定该控件的外观，且一些成员函数将失效。这个会在后面专门抽一章节跟大家讲。

38.3.4控件的动态内存使用

在嵌入式应用中，由于分裂效应，通常都不太希望使用动态内存。可使用许多不同策略来避免此情况，但只要内存区域被应用程序中的指针引用，这些策略的使用都有局限性。因此，emWin使用不同的方法：所有对象（以及运行时存储的所有数据）都存储在被句柄引用的内存区域中。这使它能够在运行时重新分配已分配的内存区域，因此避免了使用指针时会发生的长期分配问题。所以所有控件都使用句柄引用。

38.3.5确定控件的类型

没有像WM_GetWidgetType()一样的函数来确定控件的类型，其类型仅可通过将特定控件的回调函数与控件API的公共回调函数进行比较来确定。在回调函数未被覆盖时此方法很有效。如下所示为如何确定控件类型的简短示例。如果回调函数被覆盖，则应相应调整方法：

WM_CALLBACK * pCb = WM_GetCallback(hWidget);
if (pCb == BUTTON_Callback) {
/* Widget is a button */
} else if (pCb == DROPDOWN_Callback) {
/* Widget is a dropdown */
} else if (pCb == LISTBOX_Callback) {
/* Widget is a listbox */
} else if (...) {
...
}

复制代码

硬汉Eric2013 · 2015-4-28 10:42:26

38.4控件配置选项

宏	默认值	描述
WIDGET_USE_PARENT_EFFECT	0	设置为1时，控件的每个子控件都具有与其父控件相同的效果。例如，如果列表框需要创建一个滚动条，则新滚动条具有与列表框相同的效果。
WIDGET_USE_SCHEME_LARGE	0	设置为1时，控件的默认外观为大尺寸。这意味着所有显示文本的控件都配置为使用大尺寸的默认字体。
WIDGET_USE_SCHEME_MEDIUM	0	设置为1时，控件的默认外观为中等尺寸。这意味着所有显示文本的控件都配置为使用中等尺寸的默认字体
WIDGET_USE_SCHEME_SMALL	1	设置为1时，控件的默认外观为小尺寸。这意味着所有显示文本的控件都配置为使用小尺寸的默认字体。
WIDGET_USE_FLEX_SKIN	0	设置为1时，默认使用Flex皮肤来绘制控件。

WIDGET_USE_SCHEME_XXX显示的效果如下：

硬汉Eric2013 · 2015-4-28 10:53:10

38.5通用控件API

由于控件质上就是窗口，所以它们与任何窗口管理器API例程都兼容。窗口的句柄用作hWin参数，且窗口的处理方式与其他任何窗口都相同。最常用于控件的WM函数如下所列：

例程	描述
WM_DeleteWindow()	删除窗口。
WM_DisableMemdev()	禁止使用存储设备进行重绘。
WM_EnableMemdev()	启用存储设备用于重绘。
WM_InvalidateWindow()	使窗口无效。
WM_Paint()	立即绘制或重绘窗口。

硬汉Eric2013 · 2015-4-28 12:50:54

38.6常用函数

下面是控件中常用的函数：

例程	描述
_Callback()	默认回调函数。
_CreateIndirect()	用于对话框中的自动创建。
_CreateUser()	使用额外字节作为用户数据创建小工具。
_GetUserData()	检索用 _SetUserData设置的数据。
_SetUserData()	设置小工具的额外数据。
WIDGET_GetDefaultEffect()	返回用于小工具的默认效果。
WIDGET_SetDefaultEffect()	设置用于小工具的默认效果。
WIDGET_SetEffect()	设置用于给定小工具的效果。

这里咱们重点说其中的两个函数，这两个在以后的项目中用的最多，其它的几个函数大家可以看用户手册进行了解。

38.6.1 _CreateIndirect() 函数

这个函数在前面的几期教程中使用的非常多，在对话框中创建控件主要的就是用这个函数。任何控件都可使用适宜的前缀间接创建。例如：

BUTTON_CreateIndirect() 可间接创建一个按钮控件，

CHECKBOX_CreateIndirect() 可间接创建一个复选框控件，等等。

仅在控件要被包含在对话框中时，才需要间接创建它。否则，可使用 _Create()函数直接创建它。

GUI_WIDGET_CREATE_INFO数据结构在对话框资源表中定义如下：

typedef struct {

GUI_WIDGET_CREATE_FUNC * pfCreateIndirect; // Create function

const char * pName; // Text (not used for all widgets)

I16 Id; // Window ID of the widget

I16 x0, y0, xSize, ySize; // Size and position of the widget

I16 Flags; // Widget-specific flags (or 0)

I32 Para; // Widget-specific parameter (or 0)

U32 NumExtraBytes; // Number of extra bytes usable

// with _SetUserData &

// _GetUserData

} GUI_WIDGET_CREATE_INFO;

控件标记和参数是可选的，并随控件类型不同而不同。

38.6.2WIDGET_SetDefaultEffect()函数

通过这个函数可以设置控件的三种状态，效果如下：

这里有一点要注意，如果大家设置控件的皮肤，那么设置这三种状态是无效的。

硬汉Eric2013 · 2015-4-28 12:51:38

38.7总结

对于本期教程，大家要了解这些基本的知识，在后面的学习中，我们会用到。懂得这些知识，在后面学习控件的时候会事半功倍。

ahljj123 · 2015-5-1 21:42:00

学习一下。学习一下。

icedalion · 2015-5-5 16:29:12

感谢楼主分享！！！！！！！！！！！！！

lbq1468 · 2015-5-7 12:34:34

谢谢分享////////////

亿度qiang · 2017-6-6 20:21:14

学习学习。。。。。。。。。。。。。。。。。。。。。。。。。。。。

搜索历史

【安富莱原创】【STemWin教程】第38章 控件基础知识

相关推荐

9条评论

评论

精选推荐

站长推荐/7

【安富莱原创】【STemWin教程】第38章控件基础知识