## 标签
类名:Static
功能:显示一段文本内容。
外观:
[这里放图片]
> 控件的使用请详见 ctrl.e。
* * * * *
### 创建
| 参数 | 创建参数名 | XML属性 | 值或备注 |
| -- | -- | -- | -- |
| 类名 | lpwzClassName | class | “Static” |
| 标题 | lpwzObjTitle | text | 标签显示的内容 |
| 风格 | dwStyle | style | 取值详见下表 |
#### 标签独有风格表
| 常量名 | 英文常量名 | 常量值 | 16进制 | 常量含义 |
| -- | -- | -- | -- | -- |
| 标签风格\_文本横向对齐\_左边 | EX_LS_HALIGN_LEFT | 0 | 0x0000 | 标签文本水平左对齐 |
| 标签风格\_文本横向对齐\_居中 | EX_LS_HALIGN_CENTER | 1 | 0x0001 | 标签文本水平居中对齐 |
| 标签风格\_文本横向对齐\_右边 | EX_LS_HALIGN_RIGHT | 2 | 0x0002 | 标签文本水平右对齐 |
| 标签风格\_文本纵向对齐\_顶部 | EX_LS_VALIGN_TOP | 4 | 0x0004 | 标签文本竖直左对齐 |
| 标签风格\_文本纵向对齐\_居中 | EX_LS_VALIGN_CENTER | 8 | 0x0008 | 标签文本竖直居中对齐 |
| 标签风格\_文本纵向对齐\_底部 | EX_LS_VALIGN_BOTTOM | 16 | 0x0010 | 标签文本竖直右对齐 |
| 标签风格\_单行文本 | EX_LS_SINGLELINE | 32 | 0x0020 | 标签文本不换行 |
| 标签风格\_自动换行 | EX_LS_AUTONEWLINE | 64 | 0x0040 | 标签文本自动换行 |
| 标签风格\_显示加速符 | EX_LS_SHOWPREFIX | 128 | 0x0080 | 标签文本显示加速符(&字符的处理) |
| 标签风格\_事件通知父组件 | EX_LS_NOTIFYPARENT | 256 | 0x0100 | 标签控件的事件将通知父控件 |
| 标签风格\_文本修整\_路径 | EX_LS_ELLIPSIS_PATH | 512 | 0x0200 | 按路径为单位进行文本休整 |
| 标签风格\_文本修整\_字符 | EX_LS_ELLIPSIS_WORD | 1024 | 0x0400 | 按字符为单位进行文本休整 |
> 该控件的风格同时还可包括控件基类的基础风格。
* * * * *
### 使用
当需要设置文本时,可以调用 Ex_ObjSetText 进行设置。
~~~
' // 将标签的标题设置为“新文本”
lpwzText = A2W("新文本")
Ex_ObjSetText(hObjLabel,取指针_字节集型(lpwzText))
~~~
当需要设置字体时,可以调用 Ex_ObjSetFont 进行设置。
~~~
' // 将标签的字体设置为微软雅黑,20号字,加粗下划线显示。
lpwzFontName = A2W("微软雅黑")
Ex_ObjSetFont(hObjLabel,取指针_字节集型(lpwzFontName),20,位或(#粗体,#下划线))
~~~
当需要设置文本颜色时,可以调用 Ex_ObjSetTextColor 进行设置。
~~~
' // 将标签的文本色设置为200透明度的红色。
Ex_ObjSetTextColor(hObjLabel,RGB2ARGB(#红色,200))
~~~
* * * * *
### 事件
由于标签控件属于静态控件,默认是不接收键鼠事件处理的,所以需要先进行处理,将其静态控件的风格去除。
~~~
'//去除标签控件的静态控件风格
Ex_ObjSetLong (hObjLabel, #EOL_EXSTYLE, 位与 (Ex_ObjGetLong (m_hObjLabel, #EOL_EXSTYLE), 位取反 (#组件风格_扩展_静态控件)))
~~~
去除后即可正常进行控件键鼠事件的挂接了。
~~~
'// 挂接标签的单击事件。
Ex_ObjHandEvent(hObjLabel, #事件_鼠标左键被单击,到整数(&事件处理函数))
~~~
> 有很多用户由于习惯了易语言中标签的反馈事件,所以来问ExDUI标签如何实现,其实易语言中的标签反馈事件的实现原理,是通过向标签子窗口发送自定义消息实现的,通过发送自定义消息完成。由于ExDUI中的控件并非真正的Windows控件,所以应当向其所在窗口发送自定义消息,在其父窗口消息处理函数中处理,从而完成反馈事件,具体的参考代码详见 black_moon.e。
* * * * *
### 相关命令
| 命令 | 功能 |
| -- | -- |
| [Ex_ObjGetText](#) | 获取控件文本 |
| [Ex_ObjSetText](#) | 设置控件文本 |
| [Ex_ObjGetTextColor](#) | 获取控件文本颜色 |
| [Ex_ObjSetTextColor](#) | 设置控件文本颜色 |
| [Ex_ObjSetFont](#) | 设置控件文本字体 |
* * * * *
### 相关消息/事件
| 消息/事件类型 | 英文名 | 值 | wParam | lParam | 备注 |
| -- | -- | -- | -- | -- | -- |
*****
### 标签独有的布局属性
| 属性名 | 属性含义 | 属性类型 | 默认值 | 举例 |
| -- | -- | -- | -- | -- |
- 序言
- 基础
- 概念
- 术语
- 相关技术
- 入门
- 如何获取
- 环境需求
- 使用条件
- 开发规范
- 文件结构
- 让我们开始吧
- 全局命令
- 引擎命令
- Ex_Init
- Ex_UnInit
- Ex_XMLRegisterValueCallback
- Ex_XMLRegisterCallback
- Ex_GetLong
- 辅助命令
- Ex_SleepEx
- Ex_GetHash
- Ex_Atom
- 窗口命令
- 窗口相关
- Ex_WndRegisterClass
- Ex_WndCreate
- Ex_WndMsgLoop
- 皮肤相关
- Ex_DUIBindWindow
- Ex_DUICreateFromLayout
- Ex_DUILoadLayout
- Ex_DUIHandEvent
- Ex_DUIShowWindow
- Ex_DUIShowWindowEx
- Ex_DUIGetBkgColor
- Ex_DUISetBkgColor
- Ex_DUISetBkgImage
- Ex_DUIGetAlpha
- Ex_DUISetAlpha
- Ex_DUIGetSysCtl
- Ex_DUIGetObjFromID
- Ex_DUIGetClientRect
- Ex_DUIInvalidateRect
- Ex_DUIObjFromWindowPoint
- Ex_DUIObjFromScreenPoint
- Ex_DUIAddTrayIcon
- Ex_DUIPopupTrayIcon
- Ex_DUIPopupTipsEx
- Ex_DUIDeleteTrayIcon
- 关于布局文件
- 控件命令
- 控件基类
- 关于布局文件
- Ex_ObjCreate
- Ex_ObjCreateEx
- Ex_ObjDestroy
- Ex_ObjGetLong
- Ex_ObjSetLong
- Ex_ObjDispatchMessage
- Ex_ObjSendMessage
- Ex_ObjPostMessage
- Ex_ObjCallProc
- Ex_ObjDefProc
- Ex_ObjDispatchOwnerMessage
- Ex_ObjUpdate
- Ex_ObjInvalidateRect
- Ex_ObjBeginPaint
- Ex_ObjEndPaint
- Ex_ObjGethWnd
- Ex_ObjGethExDui
- Ex_ObjGethTheme
- Ex_ObjGetParent
- Ex_ObjSetParent
- Ex_ObjRegister
- Ex_ObjGetText
- Ex_ObjSetText
- Ex_ObjGetBkColor
- Ex_ObjSetBkColor
- Ex_ObjGetBkImageInfo
- Ex_ObjSetBkImageInfo
- Ex_ObjGetBkMode
- Ex_ObjSetBkMode
- Ex_ObjGetTextColor
- Ex_ObjSetTextColor
- Ex_ObjGetBorderColor
- Ex_ObjSetBorderColor
- Ex_ObjGetAlpha
- Ex_ObjSetAlpha
- Ex_ObjSetFont
- Ex_ObjSetRedraw
- Ex_ObjValidate
- Ex_ObjSetTimer
- Ex_ObjKillTimer
- Ex_ObjEnableScrollBar
- Ex_ObjGetScrollBar
- Ex_ObjGetScrollPos
- Ex_ObjSetScrollPos
- Ex_ObjGetScrollRange
- Ex_ObjSetScrollRange
- Ex_ObjGetTrackPos
- Ex_ObjGetScrollInfo
- Ex_ObjSetScrollInfo
- Ex_ObjGetClassNameA
- Ex_ObjGetClassNameW
- Ex_ObjGetRect
- Ex_ObjClientToWindow
- Ex_ObjMove
- Ex_ObjLockPos
- Ex_ObjIsVisible
- Ex_ObjShow
- Ex_ObjEnable
- Ex_ObjGetAnimationInfo
- Ex_ObjSetAnimationInfo
- Ex_ObjBeginAnimation
- Ex_ObjHandEvent
- Ex_ObjHandEventFromID
- 控件消息
- 介绍
- 属性分发
- 设置提示文本
- 获取提示文本
- 组件状态被改变
- 计算尺寸
- 获取Tab焦点区域矩形
- 绘制背景
- 绘制非客户区
- 绘制主题数据
- 系统控件
- 标题栏
- 图标控件
- 系统按钮
- 菜单
- 基础控件
- 标签
- 按钮
- 普通按钮
- 图形按钮
- 组图按钮
- 下拉按钮
- 图片框
- 链接框
- 选择框
- 三态选择框
- 单选框
- 分组框
- 进度条
- 滚动条
- 编辑框
- 丰富文本框
- 高级控件
- 组合框
- 列表框
- 选择夹
- 浏览框
- 扩展控件
- 绘图命令
- 关于绘图引擎
- 设备上下文
- 画布
- _excanvas_getlasterror
- _excanvas_setlasterror
- _excanvas_getlong
- _canvas_create
- _canvas_destroy
- _canvas_validate
- _canvas_beginpaint
- _canvas_endpaint
- _canvas_clear
- _canvas_drawimage
- _canvas_drawimagerect
- _canvas_drawimagerectrect
- _canvas_drawline
- _canvas_drawlinefrompen
- _canvas_drawimagefromdrawdata
- _canvas_drawimagegird
- _canvas_drawrectangle
- _canvas_fillrectangle
- _canvas_fillrectanglefrombrush
- _canvas_getdc
- _canvas_width
- _canvas_height
- _canvas_setbkmode
- _canvas_getbkmode
- _canvas_bitblt
- _canvas_bitblt_dc
- _canvas_alphablt
- _canvas_alphablt_dc
- _canvas_cliprect
- _canvas_cliphrgn
- _canvas_resetclip
- _canvas_savetofile
- _canvas_resize
- _canvas_drawrectanglefrompen
- _canvas_setfont
- _canvas_getfont
- _canvas_getlogfont
- _canvas_getpixel
- _canvas_calctextsize
- _canvas_drawtext
- _canvas_savetomemory
- _canvas_blur
- 图像
- _image_width
- _image_height
- _image_createfromfile
- _image_destory
- _image_createfromstream
- _image_selectactiveframe
- _image_getframecount
- _image_copy
- _image_copyrect
- _image_createfrommemory
- _image_savetofile
- _image_getframedelay
- _image_createfromhicon
- _image_create
- _image_savetomemory
- _image_lockbits
- _image_createfromhres
- 画笔
- _pen_create
- _pen_destory
- _pen_create_frombrush
- 画刷
- _brush_create
- _brush_destroy
- _brush_createfromimage
- _brush_create_lineargradientfrompoint
- 字体
- _font_createfromfamily
- _font_create
- _font_destroy
- _font_getlogfont
- _font_createfromlogfont
- 路径
- 区域
- 文本格式
- 效果
- 布局文件
- 关于XML
- 文件结构
- 特殊语法
- 主题文件
- 关于EXT
- 文件结构
- 贴图文件
- 描述文件
- 制作主题
- 相关命令
- Ex_ThemeLoad
- Ex_ThemeFree
- Ex_ThemepData
- Ex_ThemeGetData
- Ex_ThemeGetColor
- Ex_ThemeGetRect
- Ex_ThemeDraw
- Ex_ThemeDrawEx
- Ex_ThemeDispatchDrawEx
- 缓动特效
- 关于特效
- 缓动种类
- 相关命令
- 授权机制