## 標簽
類名: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
- 緩動特效
- 關于特效
- 緩動種類
- 相關命令
- 授權機制