UiWin类参考

MZFC的UI控件基类. 更多...

#include <UiWin.h>

被MzGridMenu、MzPopupMenu、MzPopupMessage、MzPopupProgress、UiAdjustBar、UiAlphabetBar、UiButton、UiButtonBar、UiCanvas、UiCustomList、UiDesktopItem、UiDragPanel、UiEdit、UiEditZoom、UiFillColor、UiGif、UiGradient、UiHeadingBar、UiIconBar、UiList、UiList_2、UiList_H、UiListEx、UiPasswordEdit、UiPasswordKeypad、UiProgressBar、UiReceiverItem、UiScrollWin、UiSearchBox、UiSingleLineEdit、UiSlideBar、UiStatic、UiStatusBar、UiToolbar_Icon、UiToolbar_Text、UiToolBarPro、UiToolTips、UiWheel、UiWheelContainer、WheelContainer及WinManager继承.

所有成员的列表。

公有成员

void AddChild (UiWin *pChild)
 添加子控件
virtual int CalcContentHeight ()
 计算（返回）控件的内容总高度
virtual int CalcContentTopPosH ()
 计算（返回）控件的内容水平方向的位置
virtual int CalcContentTopPosV ()
 计算（返回）控件的内容竖直方向的位置
virtual int CalcContentWidth ()
 计算（返回）控件的内容总宽度
MZFC_INLINE void EnableClipExtend (bool bEnable)
 设置控件是否启用扩展裁剪属性
MZFC_INLINE void EnableDragModeH (bool bEnable)
 设置控件是否启用横向拖动通知. 详见 MZ_WM_LIST_ITEM_DRAG_H
virtual void EnableDragScroll (bool bEnable)
 设置控件是否启用 DragScroll 属性
MZFC_INLINE void EnableDragScrollbarV (bool bEnable)
 设置控件是否启用竖直方向的“可拖动滚动条”
MZFC_INLINE void EnableGrabFocusByMouse (bool bEnable)
 设置控件在鼠标按下时，是否获得键盘焦点
void EnableGrabMouseEventOfChildren (bool bEnable)
void EnableInvalidate (bool bEnable)
MZFC_INLINE void EnableMouseOverExtend (bool bEnable)
 设置控件是否启用扩展鼠标响应区域属性
MZFC_INLINE void EnableNotifyMessage (bool bEnable)
 设置控件是否启用鼠标通知（发送MZ_WM_MOUSE_NOTIFY到它所在的窗口）
MZFC_INLINE void EnablePressedHoldSupport (bool bEnable)
 设置控件是否启用 pressed-hold 支持 (长按一段时间会触发通知消息！
MZFC_INLINE void EnableScrollableParent (bool bEnable)
 设置当鼠标拖动时，是否通知其所在的可滚动容器
MZFC_INLINE void EnableScrollBarH (bool bEnable)
 设置控件是否启用（显示）水平滚动条
MZFC_INLINE void EnableScrollBarV (bool bEnable)
 设置控件是否启用（显示）竖直滚动条
MZFC_INLINE void EnableScrollOptimize (bool bEnable)
 设置控件是否启用滚动优化
MZFC_INLINE void EnableSound (bool bEnable)
 设置控件是否启用声音
size_t FindChild (UiWin *pChild)
 寻找某个子控件，并获得子控件的z-order
UiWin * GetCapture ()
 获得当前拥有鼠标焦点的控件
UiWin * GetChild (int nIndex)
 获得指定索引的子控件
UiWin * GetChildByID (int nID)
 获得指定ID的子控件
size_t GetChildrenCount ()
 获得子控件总数
RECT GetClientRect ()
 获得控件区域. (相对于自身左上角, x,y 必为零)
MZFC_INLINE int GetClipExtend (int nFlag)
 获得控件的扩展裁剪大小,0:Left 1:Top 2:Right 3:Bottom
MZFC_INLINE int GetClipExtend ()
 获得控件的扩展裁剪大小
int GetDragMode ()
 控件的拖动模式
MZFC_INLINE DWORD GetDrawTextFormat ()
 获得文本的 DrawText format
MZFC_INLINE int GetEllipsis_Bottom ()
MZFC_INLINE int GetEllipsis_Left ()
MZFC_INLINE int GetEllipsis_Right ()
MZFC_INLINE int GetEllipsis_Top ()
BOOL GetExtendedProperty_UiWin (int nPropertyType, void *pValue, int nBufSize)
 获取或设置对象的扩展属性值
MZFC_INLINE int GetHeight ()
 获得控件的高
MZFC_INLINE INT GetHidingScrollbarResID ()
int GetID ()
 获得控件的ID
int GetLeftPos ()
virtual WinManager * GetManager ()
 获得所在的控件管理者
MZFC_INLINE POINT GetMouseDownPos ()
 获得鼠标按下的坐标
MZFC_INLINE UiWin * GetParent ()
 获得父控件
virtual HWND GetParentWnd ()
 获得所在的窗口
MZFC_INLINE int GetPosX ()
 获得控件的X坐标(相对于控件所在的容器的左上角)
MZFC_INLINE int GetPosY ()
 获得控件的Y坐标(相对于控件所在的容器的左上角)
MZFC_INLINE int GetPressedHoldTime ()
 控件的 pressed-hold 时间长度（单位为毫秒）
RECT GetRect ()
 获得控件区域. (相对于控件所在的容器的左上角)
virtual UiWin * GetScrollableParent ()
 是否包含在可滚动容器中（包括自己）
MZFC_INLINE int GetScrollbarMarginH ()
MZFC_INLINE int GetScrollbarMarginV ()
virtual CMzString & GetText ()
 获得文本
MZFC_INLINE COLORREF GetTextColor ()
 获得文本颜色
MZFC_INLINE long GetTextSize ()
 获得文本字体尺寸
MZFC_INLINE long GetTextWeight ()
 获得文本字体的粗细: FW_NORMAL, FW_XXXX, etc. 详见 Win32 API: CreateFont()
int GetTopPos ()
 获得内容顶部位置
UINT GetUiWinType ()
MZFC_INLINE void * GetUserData ()
 获得控件的用户数据字段
MZFC_INLINE int GetWidth ()
 获得控件的宽
bool HasChild (UiWin *pWin)
 是否有某个子控件
bool HasChildNode (UiWin *pWin)
 检查控件是否有某个子控件.
void InsertChild (UiWin *pChild, size_t nZOrder)
 把控件添加到指定的z-order
virtual void Invalidate (RECT *prcUpdate=NULL)
 无效控件所在区域
MZFC_INLINE bool IsCancelAction ()
 设置控件的 CancelAction 属性。（例如，对于按钮控件，当你press->release，则为false；当你press->drag->release，则为true）
MZFC_INLINE bool IsDragingScrollbarV ()
MZFC_INLINE bool IsEnable ()
 控件是否接受鼠标操作.
MZFC_INLINE bool IsEnableClipExtend ()
 控件是否启用扩展裁剪属性
MZFC_INLINE bool IsEnableDragModeH ()
 控件是否启用横向拖动通知.
bool IsEnableDragScroll ()
 控件是否启用 DragScroll 属性
MZFC_INLINE bool IsEnableDragScrollbarV ()
 控件是否启用竖直方向的“可拖动滚动条”
MZFC_INLINE bool IsEnableGrabFocusByMouse ()
 控件在鼠标按下时，是否获得键盘焦点
bool IsEnableGrabMouseEventOfChildren ()
bool IsEnableInvalidate ()
MZFC_INLINE bool IsEnableMouseOverExtend ()
 控件是否启用扩展鼠标响应区域属性
MZFC_INLINE bool IsEnableNotifyMessage ()
 控件是否启用鼠标通知
MZFC_INLINE bool IsEnablePressedHoldSupport ()
 控件是否启用 pressed-hold 支持
MZFC_INLINE bool IsEnableScrollableParent ()
 当鼠标拖动时，是否通知其所在的可滚动容器
MZFC_INLINE bool IsEnableScrollBarH ()
 控件是否启用（显示）水平滚动条
MZFC_INLINE bool IsEnableScrollBarV ()
 控件是否启用（显示）竖直滚动条
MZFC_INLINE bool IsEnableScrollOptimize ()
 控件是否启用滚动优化
bool IsFocused ()
 控件是否拥有键盘焦点
bool IsHidingScrollbar ()
MZFC_INLINE bool IsInDragH ()
MZFC_INLINE bool IsLButtonDblClk ()
 获得 LButtonDbClk 属性
MZFC_INLINE bool IsLButtonDown ()
 获得 LButtonDown 属性
MZFC_INLINE bool IsMouseDownAtScrolling ()
 is mouse down when the control is in scrolling status
MZFC_INLINE bool IsMouseMoved ()
 获得 MouseMoved 属性
MZFC_INLINE bool IsPassDown ()
 控件是否忽略鼠标操作并把此鼠标操作传递至下一个z-order的控件
MZFC_INLINE bool IsPressedHoldTimeup ()
 控件是否 pressed-hold 时间结束
virtual bool IsScrollable ()
 内容是否可滚动
MZFC_INLINE bool IsScrolling ()
 控件是否正在滚动
MZFC_INLINE bool IsSoundEnabled ()
MZFC_INLINE bool IsStateLocked ()
MZFC_INLINE bool IsVertDragDisabled ()
MZFC_INLINE bool IsVisible ()
 控件是否可见
virtual void LockState (bool bLock)
virtual void Move (int xOffset, int yOffset)
 移动控件的位置
void MoveChildren (int xOffset, int yOffset)
 移动子控件
virtual void MoveTopPos (int nOffset)
 移动内容顶部位置
virtual int OnChar (TCHAR chCharCode, LPARAM lKeyData)
 当有键盘字符输入时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual void OnCopy ()
 当控件WM_COPY消息时，此函数会被调用
virtual void OnCut ()
 当控件WM_CUT消息时，此函数会被调用
virtual void OnFocused (UiWin *pWinPrev)
 当控件获得键盘焦点时，此函数会被调用
virtual int OnImeComposition (BOOL fFlags)
 当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual int OnImeEndComposition ()
 当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual int OnImeStartComposition ()
 当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual void OnInsertPic (TCHAR *szString)
virtual int OnKeyDown (int nVirtKey, DWORD lKeyData)
 当有键盘按键按下时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual int OnKeyUp (int nVirtKey, DWORD lKeyData)
 当有键盘按键放开时，此函数会被调用.(仅当控件拥有键盘焦点时)
virtual int OnLButtonDblClk (UINT fwKeys, int xPos, int yPos)
 当控件被双击时，此函数会被调用.
virtual int OnLButtonDown (UINT fwKeys, int xPos, int yPos)
 当控件被左键按下时，此函数会被调用.
virtual int OnLButtonUp (UINT fwKeys, int xPos, int yPos)
 当控件被左键放开时，此函数会被调用.
virtual void OnLostFocus (UiWin *pWinNext)
 当控件失去键盘焦点时，此函数会被调用
virtual int OnMouseMove (UINT fwKeys, int xPos, int yPos)
 当控件上鼠标移动时，此函数会被调用.
virtual void OnPaint (HDC hdcDst, RECT *prcWin, RECT *prcUpdate)
virtual void OnParentScrollStart ()
virtual void OnParentScrollStop ()
virtual void OnPaste ()
 当控件WM_PASTE消息时，此函数会被调用
virtual void OnPaste (TCHAR *szString)
virtual void OnPressedHoldStart ()
 当 pressed-hold 开始时，此函数会被调用，可重载以自定义处理
virtual void OnPressedHoldTimeup ()
 当 pressed-hold 结束时，此函数会被调用，可重载以自定义处理
virtual int OnTimer (UINT_PTR nIDEvent)
 当Timer到达时，此函数会被调用.
virtual void OnWmA4M8 (WPARAM wParam, WPARAM lParam)
 当控件WM_A4M8消息时，此函数会被调用
virtual void PaintScrollBarH (HDC hdc, RECT *prcWin, RECT *prcUpdate)
 绘制水平滚动条（重载可以自定义其绘制）
virtual void PaintScrollBarHiding ()
virtual void PaintScrollBarV (HDC hdc, RECT *prcWin, RECT *prcUpdate)
 绘制竖直滚动条（重载可以自定义其绘制）
virtual void PaintScrollBarV_Ex (HDC hdc, RECT *prcWin, INT nResID)
virtual void PaintWin (HDC hdcDst, RECT *prcWin, RECT *prcUpdate)
 绘制控件
void PostCommandMessage (int nID, int nNotifyCode, LPARAM lParam)
 发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.
void PostCommandMessage (LPARAM lParam)
 发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.
void PostCommandMessage ()
 发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.
void PostMessage (UINT message, WPARAM wParam, LPARAM lParam)
 发送消息到控件所在的窗口.
virtual void PostUiMessage (UiWin *pwinDst, LPARAM lParam)
 给同一个WinManager内的指定控件发送消息. (See MZ_MZ_UI_POSTMESSAGE)
void ReleaseCapture ()
 释放鼠标焦点
void RemoveAllChildren ()
 移除所有子控件（不会负责delete它们的指针）
void RemoveChild (int nIndex)
void RemoveChild (UiWin *pChild)
 删除子控件
void ScrollParent ()
virtual void ScrollStart (double fScrollSpeed)
 开始滚动
virtual void ScrollStop ()
 结束滚动
virtual void ScrollTo (int nScrollToType=UI_SCROLLTO_TOP, int nDstTopPos=0, bool bAnimate=true)
 滚动控件内容至某个位置
void SendCommandMessage (LPARAM lParam)
 发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.
void SendCommandMessage ()
 发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.
void SendMessage (UINT message, WPARAM wParam, LPARAM lParam)
 发送消息到控件所在的窗口.
MZFC_INLINE void SetCancelAction (bool bCancel)
 设置控件的 CancelAction 属性
void SetCapture ()
 让控件获得鼠标焦点
MZFC_INLINE void SetClipExtend (int nExtendLeft, int nExtendTop, int nExtendRight, int nExtendBottom)
 设置控件的扩展裁剪大小
MZFC_INLINE void SetClipExtend (int nExtend)
 设置控件的扩展裁剪大小
virtual void SetDragMode (int nDragMode)
 设置控件的拖动模式
MZFC_INLINE void SetDrawTextFormat (DWORD dwFormat)
 设置文本的 DrawText format
MZFC_INLINE void SetEllipsis (int nEllipsis_Left, int nEllipsis_Right, int nEllipsis_Top, int nEllipsis_Bottom)
virtual void SetEnable (bool bEnable=true)
 设置控件是否接受鼠标操作. (其子控件也会受影响)
BOOL SetExtendedProperty_UiWin (int nPropertyType, void *pValue, int nBufSize)
 获取或设置对象的扩展属性值
virtual void SetFocus (bool bFocus)
 设置控件是否拥有键盘焦点
void SetHidingScrollbar (bool bHiding)
MZFC_INLINE void SetHidingScrollbarResID (INT nResID)
void SetID (int nID)
 设置控件的ID
MZFC_INLINE void SetIsDragingScrollbarV (bool bIs)
MZFC_INLINE void SetIsInDragH (bool bIsInDragH)
MZFC_INLINE void SetLButtonDblClk (bool bDblClk)
 设置LButtonDblClk属性
MZFC_INLINE void SetLButtonDown (bool bDown)
 设置LButtonDown属性
MZFC_INLINE void SetMouseDownAtScrolling (bool bDownAtScrolling)
 set the mouse is down when the control is in scrolling status
MZFC_INLINE void SetMouseDownPos (int x, int y)
 设置鼠标按下的坐标
MZFC_INLINE void SetMouseMoved (bool bMoved)
 设置MouseMoved属性
virtual void SetParent (UiWin *pParent)
virtual void SetPassDown (bool bPassDown=true)
 设置控件是否忽略鼠标操作并把此鼠标操作传递至下一个z-order的控件
virtual void SetPos (int x, int y, int w, int h, UINT flags=0)
 设置控件的位置
MZFC_INLINE void SetPressedHoldTime (int nElapse)
 设置控件的 pressed-hold 时间长度 (单位为毫秒, 默认值为 1000)
MZFC_INLINE void SetPressedHoldTimeup (bool bTimeup)
 设置控件是否 pressed-hold 时间结束
MZFC_INLINE void SetScrollbarMarginH (int nMargin)
MZFC_INLINE void SetScrollbarMarginV (int nMargin)
virtual void SetText (LPCTSTR text)
 设置文本
MZFC_INLINE void SetTextColor (COLORREF cr)
 设置文本颜色
MZFC_INLINE void SetTextSize (long nSize)
 设置文本字体尺寸
MZFC_INLINE void SetTextWeight (long nWeight)
 设置文本字体的粗细: FW_NORMAL, FW_XXXX, etc. 详见 Win32 API: CreateFont()
virtual void SetTopPos (int nTopPos)
 设置内容顶部位置
MZFC_INLINE void SetUserData (void *data)
 设置控件的用户数据字段
MZFC_INLINE void SetVertDragDisabled (bool bDisable)
virtual void SetVisible (bool bVisible=true)
 设置控件是否可见
void SetZOrderOfChild (UiWin *pChild, size_t nZOrder)
 指定子控件的 z-order
 UiWin ()
virtual void UiWinProc (LPARAM lParam)
 MZ_MZ_UI_POSTMESSAGE 消息的处理函数，重载可以自定义处理
virtual void Update ()
 更新控件所在窗口
virtual ~UiWin ()

保护成员

MZFC_INLINE void SetIsScrolling (bool bScrolling)

保护属性

bool m_bEnableNotifyMessage
bool m_bEnablePressedHoldSupport
bool m_bEnableScrollOptimize
bool m_bIsDragingScrollbarV
bool m_bIsEnableDragScrollbarV
bool m_bIsEnableGrabFocusByMouse
bool m_bPassDown
bool m_bPressedHoldTimeup
int m_nEllipsis_Bottom
int m_nEllipsis_Left
int m_nEllipsis_Right
int m_nEllipsis_Top
int m_nLeftPos
int m_nPressedHoldTime
int m_nTopPos
UINT m_uiWinType

详细描述

MZFC的UI控件基类.

构造及析构函数文档

UiWin::UiWin (  ) 
virtual UiWin::~UiWin (  )  [virtual]

成员函数文档

void UiWin::AddChild ( UiWin *  pChild  ) 

添加子控件

virtual int UiWin::CalcContentHeight (  )  [virtual]

计算（返回）控件的内容总高度

被MzGridMenu、UiCustomList、UiEdit、UiList、UiListEx及UiScrollWin重载。

virtual int UiWin::CalcContentTopPosH (  )  [virtual]

计算（返回）控件的内容水平方向的位置

被UiScrollWin重载。

virtual int UiWin::CalcContentTopPosV (  )  [virtual]

计算（返回）控件的内容竖直方向的位置

被UiCustomList、UiEdit、UiList、UiListEx及UiScrollWin重载。

virtual int UiWin::CalcContentWidth (  )  [virtual]

计算（返回）控件的内容总宽度

被UiList_H、UiListEx及UiScrollWin重载。

MZFC_INLINE void UiWin::EnableClipExtend ( bool  bEnable  ) 

设置控件是否启用扩展裁剪属性

MZFC_INLINE void UiWin::EnableDragModeH ( bool  bEnable  ) 

设置控件是否启用横向拖动通知. 详见 MZ_WM_LIST_ITEM_DRAG_H

virtual void UiWin::EnableDragScroll ( bool  bEnable  )  [virtual]

设置控件是否启用 DragScroll 属性

MZFC_INLINE void UiWin::EnableDragScrollbarV ( bool  bEnable  ) 

设置控件是否启用竖直方向的“可拖动滚动条”

MZFC_INLINE void UiWin::EnableGrabFocusByMouse ( bool  bEnable  ) 

设置控件在鼠标按下时，是否获得键盘焦点

void UiWin::EnableGrabMouseEventOfChildren ( bool  bEnable  ) 
void UiWin::EnableInvalidate ( bool  bEnable  ) 
MZFC_INLINE void UiWin::EnableMouseOverExtend ( bool  bEnable  ) 

设置控件是否启用扩展鼠标响应区域属性

MZFC_INLINE void UiWin::EnableNotifyMessage ( bool  bEnable  ) 

设置控件是否启用鼠标通知（发送MZ_WM_MOUSE_NOTIFY到它所在的窗口）

MZFC_INLINE void UiWin::EnablePressedHoldSupport ( bool  bEnable  ) 

设置控件是否启用 pressed-hold 支持 (长按一段时间会触发通知消息！

参见:
MZ_WM_MOUSE_NOTIFY, MZ_MN_PRESSEDHOLD_TIMEUP
MZFC_INLINE void UiWin::EnableScrollableParent ( bool  bEnable  ) 

设置当鼠标拖动时，是否通知其所在的可滚动容器

被UiEdit及UiSingleLineEdit重载。

MZFC_INLINE void UiWin::EnableScrollBarH ( bool  bEnable  ) 

设置控件是否启用（显示）水平滚动条

MZFC_INLINE void UiWin::EnableScrollBarV ( bool  bEnable  ) 

设置控件是否启用（显示）竖直滚动条

MZFC_INLINE void UiWin::EnableScrollOptimize ( bool  bEnable  ) 

设置控件是否启用滚动优化

MZFC_INLINE void UiWin::EnableSound ( bool  bEnable  ) 

设置控件是否启用声音

size_t UiWin::FindChild ( UiWin *  pChild  ) 

寻找某个子控件，并获得子控件的z-order

参数:
pChild 目的子控件
返回:
目的子控件所在的z-order
  • 如果返回 GetChildCount()，表示没有找到这个控件
UiWin* UiWin::GetCapture (  ) 

获得当前拥有鼠标焦点的控件

被WinManager重载。

UiWin* UiWin::GetChild ( int  nIndex  ) 

获得指定索引的子控件

UiWin* UiWin::GetChildByID ( int  nID  ) 

获得指定ID的子控件

size_t UiWin::GetChildrenCount (  ) 

获得子控件总数

RECT UiWin::GetClientRect (  ) 

获得控件区域. (相对于自身左上角, x,y 必为零)

MZFC_INLINE int UiWin::GetClipExtend ( int  nFlag  ) 

获得控件的扩展裁剪大小,0:Left 1:Top 2:Right 3:Bottom

MZFC_INLINE int UiWin::GetClipExtend (  ) 

获得控件的扩展裁剪大小

int UiWin::GetDragMode (  ) 

控件的拖动模式

返回:
可以是以下值：UI_DRAGMODE_FREE UI_DRAGMODE_AUTO UI_DRAGMODE_FIXED
MZFC_INLINE DWORD UiWin::GetDrawTextFormat (  ) 

获得文本的 DrawText format

MZFC_INLINE int UiWin::GetEllipsis_Bottom (  ) 
MZFC_INLINE int UiWin::GetEllipsis_Left (  ) 
MZFC_INLINE int UiWin::GetEllipsis_Right (  ) 
MZFC_INLINE int UiWin::GetEllipsis_Top (  ) 
BOOL UiWin::GetExtendedProperty_UiWin ( int  nPropertyType,
void *  pValue,
int  nBufSize 
)

获取或设置对象的扩展属性值

参数:
nPropertyType 要获取或设置的属性类型
pValue 要获取或设置的属性值的指针
nBufSize pValue所指向的变量的size大小（单位: 字节）
返回:
操作是否成功
MZFC_INLINE int UiWin::GetHeight (  ) 

获得控件的高

MZFC_INLINE INT UiWin::GetHidingScrollbarResID (  ) 
int UiWin::GetID (  ) 

获得控件的ID

int UiWin::GetLeftPos (  ) 

被UiList_H及UiListEx重载。

virtual WinManager* UiWin::GetManager (  )  [virtual]

获得所在的控件管理者

被WinManager重载。

MZFC_INLINE POINT UiWin::GetMouseDownPos (  ) 

获得鼠标按下的坐标

MZFC_INLINE UiWin* UiWin::GetParent (  ) 

获得父控件

virtual HWND UiWin::GetParentWnd (  )  [virtual]

获得所在的窗口

被WinManager重载。

MZFC_INLINE int UiWin::GetPosX (  ) 

获得控件的X坐标(相对于控件所在的容器的左上角)

MZFC_INLINE int UiWin::GetPosY (  ) 

获得控件的Y坐标(相对于控件所在的容器的左上角)

MZFC_INLINE int UiWin::GetPressedHoldTime (  ) 

控件的 pressed-hold 时间长度（单位为毫秒）

RECT UiWin::GetRect (  ) 

获得控件区域. (相对于控件所在的容器的左上角)

virtual UiWin* UiWin::GetScrollableParent (  )  [virtual]

是否包含在可滚动容器中（包括自己）

MZFC_INLINE int UiWin::GetScrollbarMarginH (  ) 
MZFC_INLINE int UiWin::GetScrollbarMarginV (  ) 
virtual CMzString& UiWin::GetText (  )  [virtual]

获得文本

被UiEdit重载。

MZFC_INLINE COLORREF UiWin::GetTextColor (  ) 

获得文本颜色

MZFC_INLINE long UiWin::GetTextSize (  ) 

获得文本字体尺寸

MZFC_INLINE long UiWin::GetTextWeight (  ) 

获得文本字体的粗细: FW_NORMAL, FW_XXXX, etc. 详见 Win32 API: CreateFont()

int UiWin::GetTopPos (  ) 

获得内容顶部位置

UINT UiWin::GetUiWinType (  ) 
MZFC_INLINE void* UiWin::GetUserData (  ) 

获得控件的用户数据字段

MZFC_INLINE int UiWin::GetWidth (  ) 

获得控件的宽

bool UiWin::HasChild ( UiWin *  pWin  ) 

是否有某个子控件

bool UiWin::HasChildNode ( UiWin *  pWin  ) 

检查控件是否有某个子控件.

void UiWin::InsertChild ( UiWin *  pChild,
size_t  nZOrder 
)

把控件添加到指定的z-order

参数:
pChild 目的控件
nZOrder 目的z-order

  • 如果 nZOrder >= GetChildCount(), 则添加到顶部
  • 如果 nZOrder == 0, 则添加到底部
virtual void UiWin::Invalidate ( RECT *  prcUpdate = NULL  )  [virtual]

无效控件所在区域

参数:
prcUpdate [in] 指定需要无效的区域. NULL则无效整个控件区域.

被UiAlphabetBar重载。

MZFC_INLINE bool UiWin::IsCancelAction (  ) 

设置控件的 CancelAction 属性。（例如，对于按钮控件，当你press->release，则为false；当你press->drag->release，则为true）

MZFC_INLINE bool UiWin::IsDragingScrollbarV (  ) 
MZFC_INLINE bool UiWin::IsEnable (  ) 

控件是否接受鼠标操作.

MZFC_INLINE bool UiWin::IsEnableClipExtend (  ) 

控件是否启用扩展裁剪属性

MZFC_INLINE bool UiWin::IsEnableDragModeH (  ) 

控件是否启用横向拖动通知.

bool UiWin::IsEnableDragScroll (  ) 

控件是否启用 DragScroll 属性

MZFC_INLINE bool UiWin::IsEnableDragScrollbarV (  ) 

控件是否启用竖直方向的“可拖动滚动条”

MZFC_INLINE bool UiWin::IsEnableGrabFocusByMouse (  ) 

控件在鼠标按下时，是否获得键盘焦点

bool UiWin::IsEnableGrabMouseEventOfChildren (  ) 
bool UiWin::IsEnableInvalidate (  ) 
MZFC_INLINE bool UiWin::IsEnableMouseOverExtend (  ) 

控件是否启用扩展鼠标响应区域属性

MZFC_INLINE bool UiWin::IsEnableNotifyMessage (  ) 

控件是否启用鼠标通知

MZFC_INLINE bool UiWin::IsEnablePressedHoldSupport (  ) 

控件是否启用 pressed-hold 支持

参见:
MZ_WM_MOUSE_NOTIFY, MZ_MN_PRESSEDHOLD_TIMEUP
MZFC_INLINE bool UiWin::IsEnableScrollableParent (  ) 

当鼠标拖动时，是否通知其所在的可滚动容器

MZFC_INLINE bool UiWin::IsEnableScrollBarH (  ) 

控件是否启用（显示）水平滚动条

MZFC_INLINE bool UiWin::IsEnableScrollBarV (  ) 

控件是否启用（显示）竖直滚动条

MZFC_INLINE bool UiWin::IsEnableScrollOptimize (  ) 

控件是否启用滚动优化

bool UiWin::IsFocused (  ) 

控件是否拥有键盘焦点

bool UiWin::IsHidingScrollbar (  ) 
MZFC_INLINE bool UiWin::IsInDragH (  ) 
MZFC_INLINE bool UiWin::IsLButtonDblClk (  ) 

获得 LButtonDbClk 属性

MZFC_INLINE bool UiWin::IsLButtonDown (  ) 

获得 LButtonDown 属性

MZFC_INLINE bool UiWin::IsMouseDownAtScrolling (  ) 

is mouse down when the control is in scrolling status

MZFC_INLINE bool UiWin::IsMouseMoved (  ) 

获得 MouseMoved 属性

MZFC_INLINE bool UiWin::IsPassDown (  ) 

控件是否忽略鼠标操作并把此鼠标操作传递至下一个z-order的控件

MZFC_INLINE bool UiWin::IsPressedHoldTimeup (  ) 

控件是否 pressed-hold 时间结束

virtual bool UiWin::IsScrollable (  )  [virtual]

内容是否可滚动

被UiScrollWin重载。

MZFC_INLINE bool UiWin::IsScrolling (  ) 

控件是否正在滚动

MZFC_INLINE bool UiWin::IsSoundEnabled (  ) 

控件是否启用声音 (此属性供派生类使用以判断是否需要发出声音)

MZFC_INLINE bool UiWin::IsStateLocked (  ) 
MZFC_INLINE bool UiWin::IsVertDragDisabled (  ) 
MZFC_INLINE bool UiWin::IsVisible (  ) 

控件是否可见

virtual void UiWin::LockState ( bool  bLock  )  [virtual]
virtual void UiWin::Move ( int  xOffset,
int  yOffset 
) [virtual]

移动控件的位置

被UiSingleLineEdit重载。

void UiWin::MoveChildren ( int  xOffset,
int  yOffset 
)

移动子控件

virtual void UiWin::MoveTopPos ( int  nOffset  )  [virtual]

移动内容顶部位置

被UiCustomList、UiEdit、UiList、UiListEx及UiScrollWin重载。

virtual int UiWin::OnChar ( TCHAR  chCharCode,
LPARAM  lKeyData 
) [virtual]

当有键盘字符输入时，此函数会被调用.(仅当控件拥有键盘焦点时)

被UiEdit、UiReceiverItem及UiSingleLineEdit重载。

virtual void UiWin::OnCopy (  )  [virtual]

当控件WM_COPY消息时，此函数会被调用

被UiEdit及UiSingleLineEdit重载。

virtual void UiWin::OnCut (  )  [virtual]

当控件WM_CUT消息时，此函数会被调用

被UiEdit及UiSingleLineEdit重载。

virtual void UiWin::OnFocused ( UiWin *  pWinPrev  )  [virtual]

当控件获得键盘焦点时，此函数会被调用

virtual int UiWin::OnImeComposition ( BOOL  fFlags  )  [virtual]

当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)

被UiEdit及UiSingleLineEdit重载。

virtual int UiWin::OnImeEndComposition (  )  [virtual]

当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)

被UiSingleLineEdit重载。

virtual int UiWin::OnImeStartComposition (  )  [virtual]

当有IME消息时，此函数会被调用.(仅当控件拥有键盘焦点时)

被UiSingleLineEdit重载。

virtual void UiWin::OnInsertPic ( TCHAR *  szString  )  [virtual]
virtual int UiWin::OnKeyDown ( int  nVirtKey,
DWORD  lKeyData 
) [virtual]

当有键盘按键按下时，此函数会被调用.(仅当控件拥有键盘焦点时)

被UiEdit及UiSingleLineEdit重载。

virtual int UiWin::OnKeyUp ( int  nVirtKey,
DWORD  lKeyData 
) [virtual]

当有键盘按键放开时，此函数会被调用.(仅当控件拥有键盘焦点时)

virtual int UiWin::OnLButtonDblClk ( UINT  fwKeys,
int  xPos,
int  yPos 
) [virtual]

当控件被双击时，此函数会被调用.

被UiButton、UiDragPanel及UiPasswordKeypad重载。

virtual int UiWin::OnLButtonDown ( UINT  fwKeys,
int  xPos,
int  yPos 
) [virtual]

当控件被左键按下时，此函数会被调用.

被UiAlphabetBar、UiButton、UiButtonBar、UiCustomDragList、UiCustomList、UiDragList、UiDragPanel、UiEdit、UiIconBar、UiList、UiList_2、UiList_H、UiListEx、UiPasswordEdit、UiPasswordKeypad、UiScrollWin、UiSearchBox、UiSingleLineEdit、UiSlideBar、UiStatusBar、UiToolbar_Icon、UiToolbar_Text、UiToolBarPro、UiToolTips、UiWheel、UiWheelContainer及WheelContainer重载。

virtual int UiWin::OnLButtonUp ( UINT  fwKeys,
int  xPos,
int  yPos 
) [virtual]

当控件被左键放开时，此函数会被调用.

被UiAlphabetBar、UiButton、UiButtonBar、UiCustomDragList、UiCustomList、UiDragList、UiDragPanel、UiEdit、UiIconBar、UiList、UiList_2、UiList_H、UiListEx、UiPasswordKeypad、UiScrollWin、UiSearchBox、UiSingleLineEdit、UiSlideBar、UiStatusBar、UiToolbar_Icon、UiToolbar_Text、UiToolBarPro、UiToolTips、UiWheel、UiWheelContainer及WheelContainer重载。

virtual void UiWin::OnLostFocus ( UiWin *  pWinNext  )  [virtual]

当控件失去键盘焦点时，此函数会被调用

virtual int UiWin::OnMouseMove ( UINT  fwKeys,
int  xPos,
int  yPos 
) [virtual]

当控件上鼠标移动时，此函数会被调用.

被UiAlphabetBar、UiButton、UiCustomDragList、UiCustomList、UiDragList、UiDragPanel、UiEdit、UiList、UiList_2、UiList_H、UiListEx、UiPasswordKeypad、UiScrollWin、UiSearchBox、UiSingleLineEdit、UiSlideBar、UiStatusBar、UiWheel、UiWheelContainer及WheelContainer重载。

virtual void UiWin::OnPaint ( HDC  hdcDst,
RECT *  prcWin,
RECT *  prcUpdate 
) [virtual]

被UiWheelContainer、WheelContainer及UiDesktopItem重载。

virtual void UiWin::OnParentScrollStart (  )  [virtual]

被UiEdit重载。

virtual void UiWin::OnParentScrollStop (  )  [virtual]

被UiEdit及UiSingleLineEdit重载。

virtual void UiWin::OnPaste (  )  [virtual]

当控件WM_PASTE消息时，此函数会被调用

被UiEdit及UiSingleLineEdit重载。

virtual void UiWin::OnPaste ( TCHAR *  szString  )  [virtual]
virtual void UiWin::OnPressedHoldStart (  )  [virtual]

当 pressed-hold 开始时，此函数会被调用，可重载以自定义处理

virtual void UiWin::OnPressedHoldTimeup (  )  [virtual]

当 pressed-hold 结束时，此函数会被调用，可重载以自定义处理

被UiCustomList、UiEdit、UiListEx及UiSingleLineEdit重载。

virtual int UiWin::OnTimer ( UINT_PTR  nIDEvent  )  [virtual]

当Timer到达时，此函数会被调用.

被UiCustomDragList、UiCustomList、UiDragList、UiDragPanel、UiEdit、UiGif、UiList、UiList_H、UiListEx、UiPasswordEdit、UiScrollWin、UiSingleLineEdit、UiSlideBar及UiWheel重载。

virtual void UiWin::OnWmA4M8 ( WPARAM  wParam,
WPARAM  lParam 
) [virtual]

当控件WM_A4M8消息时，此函数会被调用

被UiEdit重载。

virtual void UiWin::PaintScrollBarH ( HDC  hdc,
RECT *  prcWin,
RECT *  prcUpdate 
) [virtual]

绘制水平滚动条（重载可以自定义其绘制）

virtual void UiWin::PaintScrollBarHiding (  )  [virtual]
virtual void UiWin::PaintScrollBarV ( HDC  hdc,
RECT *  prcWin,
RECT *  prcUpdate 
) [virtual]

绘制竖直滚动条（重载可以自定义其绘制）

virtual void UiWin::PaintScrollBarV_Ex ( HDC  hdc,
RECT *  prcWin,
INT  nResID 
) [virtual]
virtual void UiWin::PaintWin ( HDC  hdcDst,
RECT *  prcWin,
RECT *  prcUpdate 
) [virtual]

绘制控件

重载此函数可以自定义控件的绘制

参数:
hdcDst 目的DC
prcWin 控件所在区域（以HDC的左上角为原点）
prcUpdate 需要更新的区域（以HDC的左上角为原点)

被MzGridMenu、MzPopupProgress、UiSetDailyButton、UiAdjustBar、UiAlphabetBar、UiButton、UiButton_Gradient、UiButton_Image、UiButtonBar、UiButtonEx、UiCanvas、UiCaption、UiCustomDragList、UiCustomList、UiDragList、UiDragPanel、UiEdit、UiEditZoom、UiFillColor、UiGif、UiGradient、UiHeadingBar、UiIconBar、UiList、UiList_2、UiList_H、UiListEx、UiPasswordEdit、UiPasswordKeypad、UiPicture、UiPicture2、UiProgressBar、UiReceiverItem、UiRichButton、UiSearchBox、UiSingleLineEdit、UiSlideBar、UiStatic、UiStatusBar、UiToolbar_Icon、UiToolbar_Text、UiToolBarPro、UiToolTips及UiWheel重载。

void UiWin::PostCommandMessage ( int  nID,
int  nNotifyCode,
LPARAM  lParam 
)

发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.

void UiWin::PostCommandMessage ( LPARAM  lParam  ) 

发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.

void UiWin::PostCommandMessage (  ) 

发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.

void UiWin::PostMessage ( UINT  message,
WPARAM  wParam,
LPARAM  lParam 
)

发送消息到控件所在的窗口.

被WinManager重载。

virtual void UiWin::PostUiMessage ( UiWin *  pwinDst,
LPARAM  lParam 
) [virtual]

给同一个WinManager内的指定控件发送消息. (See MZ_MZ_UI_POSTMESSAGE)

void UiWin::ReleaseCapture (  ) 

释放鼠标焦点

被WinManager重载。

void UiWin::RemoveAllChildren (  ) 

移除所有子控件（不会负责delete它们的指针）

void UiWin::RemoveChild ( int  nIndex  ) 
void UiWin::RemoveChild ( UiWin *  pChild  ) 

删除子控件

void UiWin::ScrollParent (  ) 
virtual void UiWin::ScrollStart ( double  fScrollSpeed  )  [virtual]

开始滚动

被UiCustomList、UiEdit、UiList、UiList_H、UiListEx、UiScrollWin及UiWheel重载。

virtual void UiWin::ScrollStop (  )  [virtual]

结束滚动

被UiCustomList、UiEdit、UiList、UiList_H、UiListEx、UiScrollWin及UiWheel重载。

virtual void UiWin::ScrollTo ( int  nScrollToType = UI_SCROLLTO_TOP,
int  nDstTopPos = 0,
bool  bAnimate = true 
) [virtual]

滚动控件内容至某个位置

参数:
nScrollToType UI_SCROLLTO_TOP, UI_SCROLLTO_BOTTOM, UI_SCROLLTO_POS
nDstTopPos 目的位置，只当 nScrollToType==UI_SCROLLTO_POS 时有效
bAnimate 是否显示滚动过程

被UiCustomList、UiEdit、UiList、UiList_H、UiListEx及UiScrollWin重载。

void UiWin::SendCommandMessage ( LPARAM  lParam  ) 

发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.

void UiWin::SendCommandMessage (  ) 

发送 MZ_WM_COMMAND 消息到控件所在的窗口. See MZ_WM_COMMAND.

void UiWin::SendMessage ( UINT  message,
WPARAM  wParam,
LPARAM  lParam 
)

发送消息到控件所在的窗口.

被WinManager重载。

MZFC_INLINE void UiWin::SetCancelAction ( bool  bCancel  ) 

设置控件的 CancelAction 属性

void UiWin::SetCapture (  ) 

让控件获得鼠标焦点

MZFC_INLINE void UiWin::SetClipExtend ( int  nExtendLeft,
int  nExtendTop,
int  nExtendRight,
int  nExtendBottom 
)

设置控件的扩展裁剪大小

MZFC_INLINE void UiWin::SetClipExtend ( int  nExtend  ) 

设置控件的扩展裁剪大小

virtual void UiWin::SetDragMode ( int  nDragMode  )  [virtual]

设置控件的拖动模式

参数:
nDragMode 可以是以下值：UI_DRAGMODE_FREE, UI_DRAGMODE_AUTO, UI_DRAGMODE_FIXED
MZFC_INLINE void UiWin::SetDrawTextFormat ( DWORD  dwFormat  ) 

设置文本的 DrawText format

参数:
dwFormat DT_LEFT, DT_TOP, etc. 详见 Win32 API: DrawText()
MZFC_INLINE void UiWin::SetEllipsis ( int  nEllipsis_Left,
int  nEllipsis_Right,
int  nEllipsis_Top,
int  nEllipsis_Bottom 
)
virtual void UiWin::SetEnable ( bool  bEnable = true  )  [virtual]

设置控件是否接受鼠标操作. (其子控件也会受影响)

BOOL UiWin::SetExtendedProperty_UiWin ( int  nPropertyType,
void *  pValue,
int  nBufSize 
)

获取或设置对象的扩展属性值

参数:
nPropertyType 要获取或设置的属性类型
pValue 要设置的属性值的指针
nBufSize pValue所指向的变量的size大小（单位: 字节）
返回:
操作是否成功
virtual void UiWin::SetFocus ( bool  bFocus  )  [virtual]

设置控件是否拥有键盘焦点

被UiPasswordEdit重载。

void UiWin::SetHidingScrollbar ( bool  bHiding  ) 
MZFC_INLINE void UiWin::SetHidingScrollbarResID ( INT  nResID  ) 
void UiWin::SetID ( int  nID  ) 

设置控件的ID

MZ_WM_COMMAND 's LOWORD(wParam) = 控件ID, 因此控件ID不能大于65535.

参数:
nID [in] 控件的ID值.
参见:
MZ_WM_COMMAND
MZFC_INLINE void UiWin::SetIsDragingScrollbarV ( bool  bIs  ) 
MZFC_INLINE void UiWin::SetIsInDragH ( bool  bIsInDragH  ) 
MZFC_INLINE void UiWin::SetIsScrolling ( bool  bScrolling  )  [protected]
MZFC_INLINE void UiWin::SetLButtonDblClk ( bool  bDblClk  ) 

设置LButtonDblClk属性

MZFC_INLINE void UiWin::SetLButtonDown ( bool  bDown  ) 

设置LButtonDown属性

MZFC_INLINE void UiWin::SetMouseDownAtScrolling ( bool  bDownAtScrolling  ) 

set the mouse is down when the control is in scrolling status

MZFC_INLINE void UiWin::SetMouseDownPos ( int  x,
int  y 
)

设置鼠标按下的坐标

MZFC_INLINE void UiWin::SetMouseMoved ( bool  bMoved  ) 

设置MouseMoved属性

virtual void UiWin::SetParent ( UiWin *  pParent  )  [virtual]
virtual void UiWin::SetPassDown ( bool  bPassDown = true  )  [virtual]

设置控件是否忽略鼠标操作并把此鼠标操作传递至下一个z-order的控件

如果设置为true，则此控件不会响应鼠标操作. 使用此属性可以实现：把控件作为一个装饰物摆放在其他控件上，而不会影响其下边的控件响应鼠标操作.

virtual void UiWin::SetPos ( int  x,
int  y,
int  w,
int  h,
UINT  flags = 0 
) [virtual]

设置控件的位置

参数:
x X 坐标
y Y 坐标
w 宽
h 高
flags 可以是以下值的合并：0，SP_NOSIZE, SP_NOMOVE

被MzGridMenu、UiDragPanel、UiEdit、UiSingleLineEdit及UiStatusBar重载。

MZFC_INLINE void UiWin::SetPressedHoldTime ( int  nElapse  ) 

设置控件的 pressed-hold 时间长度 (单位为毫秒, 默认值为 1000)

参见:
EnablePressedHoldSupport()
MZFC_INLINE void UiWin::SetPressedHoldTimeup ( bool  bTimeup  ) 

设置控件是否 pressed-hold 时间结束

MZFC_INLINE void UiWin::SetScrollbarMarginH ( int  nMargin  ) 
MZFC_INLINE void UiWin::SetScrollbarMarginV ( int  nMargin  ) 
virtual void UiWin::SetText ( LPCTSTR  text  )  [virtual]

设置文本

被UiSingleLineEdit重载。

MZFC_INLINE void UiWin::SetTextColor ( COLORREF  cr  ) 

设置文本颜色

被UiEdit重载。

MZFC_INLINE void UiWin::SetTextSize ( long  nSize  ) 

设置文本字体尺寸

MZFC_INLINE void UiWin::SetTextWeight ( long  nWeight  ) 

设置文本字体的粗细: FW_NORMAL, FW_XXXX, etc. 详见 Win32 API: CreateFont()

virtual void UiWin::SetTopPos ( int  nTopPos  )  [virtual]

设置内容顶部位置

被UiCustomList、UiEdit、UiList、UiListEx及UiScrollWin重载。

MZFC_INLINE void UiWin::SetUserData ( void *  data  ) 

设置控件的用户数据字段

MZFC_INLINE void UiWin::SetVertDragDisabled ( bool  bDisable  ) 
virtual void UiWin::SetVisible ( bool  bVisible = true  )  [virtual]

设置控件是否可见

void UiWin::SetZOrderOfChild ( UiWin *  pChild,
size_t  nZOrder 
)

指定子控件的 z-order

参数:
pChild 目的子控件
nZOrder 目的z-order

virtual void UiWin::UiWinProc ( LPARAM  lParam  )  [virtual]

MZ_MZ_UI_POSTMESSAGE 消息的处理函数，重载可以自定义处理

virtual void UiWin::Update (  )  [virtual]

更新控件所在窗口

成员数据文档

bool UiWin::m_bEnableNotifyMessage [protected]
bool UiWin::m_bEnablePressedHoldSupport [protected]
bool UiWin::m_bEnableScrollOptimize [protected]
bool UiWin::m_bIsDragingScrollbarV [protected]
bool UiWin::m_bIsEnableDragScrollbarV [protected]
bool UiWin::m_bIsEnableGrabFocusByMouse [protected]
bool UiWin::m_bPassDown [protected]
bool UiWin::m_bPressedHoldTimeup [protected]
int UiWin::m_nEllipsis_Bottom [protected]
int UiWin::m_nEllipsis_Left [protected]
int UiWin::m_nEllipsis_Right [protected]
int UiWin::m_nEllipsis_Top [protected]
int UiWin::m_nLeftPos [protected]
int UiWin::m_nPressedHoldTime [protected]
int UiWin::m_nTopPos [protected]
UINT UiWin::m_uiWinType [protected]
该类的文档由以下文件生成：
Generated at Tue Feb 9 15:10:04 2010 for Meizu M8 SDK Documentation by  doxygen 1.6.1