You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
561 lines
29 KiB
561 lines
29 KiB
/**
|
|
* Copyright (C) 2014-2050 SOUI团队
|
|
* All rights reserved.
|
|
*
|
|
* @file stabctrl.h
|
|
* @brief
|
|
* @version v1.0
|
|
* @author soui
|
|
* @date 2014-07-06
|
|
*
|
|
* Describe 扩展列表框
|
|
*/
|
|
#pragma once
|
|
#include "core/SPanel.h"
|
|
#include "core/SItempanel.h"
|
|
|
|
namespace SOUI
|
|
{
|
|
|
|
|
|
class EventTBGetDispInfo : public TplEventArgs<EventTBGetDispInfo>
|
|
{
|
|
SOUI_CLASS_NAME(EventTBGetDispInfo,L"on_treebox_get_display_info")
|
|
public:
|
|
EventTBGetDispInfo(SObject *pSender):TplEventArgs<EventTBGetDispInfo>(pSender){}
|
|
enum{EventID=EVT_EXTERNAL_BEGIN+400};
|
|
HSTREEITEM hItem;
|
|
SWindow *pItemWnd;
|
|
BOOL bSel;
|
|
BOOL bHover;
|
|
};
|
|
|
|
class EventTBSelChanging: public TplEventArgs<EventTBSelChanging>
|
|
{
|
|
SOUI_CLASS_NAME(EventTBSelChanging,L"on_treebox_sel_changing")
|
|
public:
|
|
EventTBSelChanging(SObject *pSender):TplEventArgs<EventTBSelChanging>(pSender),bCancel(FALSE){}
|
|
enum{EventID=EVT_EXTERNAL_BEGIN+401};
|
|
HSTREEITEM hNewSel;
|
|
HSTREEITEM hOldSel;
|
|
BOOL bCancel;
|
|
};
|
|
|
|
class EventTBSelChanged: public TplEventArgs<EventTBSelChanged>
|
|
{
|
|
SOUI_CLASS_NAME(EventTBSelChanged,L"on_treebox_sel_changed")
|
|
public:
|
|
EventTBSelChanged(SObject *pSender):TplEventArgs<EventTBSelChanged>(pSender){}
|
|
enum{EventID=EVT_EXTERNAL_BEGIN+402};
|
|
HSTREEITEM hNewSel;
|
|
HSTREEITEM hOldSel;
|
|
};
|
|
|
|
class EventTBQueryItemHeight : public TplEventArgs<EventTBQueryItemHeight>
|
|
{
|
|
SOUI_CLASS_NAME(EventTBQueryItemHeight,L"on_treebox_query_item_height")
|
|
public:
|
|
EventTBQueryItemHeight(SObject *pSender):TplEventArgs<EventTBQueryItemHeight>(pSender){}
|
|
enum{EventID=EVT_EXTERNAL_BEGIN+403};
|
|
HSTREEITEM hItem;
|
|
DWORD dwState; //状态,和SWindow::GetState的值一致
|
|
int nItemHeight;//返回值保存到这里
|
|
};
|
|
|
|
/**
|
|
* @class STreeItem
|
|
* @brief tree item
|
|
*
|
|
* Describe tree item
|
|
*/
|
|
class STreeItem : public SItemPanel
|
|
{
|
|
public:
|
|
/**
|
|
* STreeItem::STreeItem
|
|
* @brief 构造函数
|
|
* @param SWindow *pFrameHost -- 宿主
|
|
* @param IItemContainer *pContainer -- 表项的容器
|
|
*
|
|
* Describe 构造函数
|
|
*/
|
|
STreeItem(SWindow *pFrameHost,IItemContainer *pContainer);
|
|
|
|
BOOL m_bCollapsed; /**< 是否折叠 */
|
|
BOOL m_bVisible; /**< 是否显示 */
|
|
int m_nLevel; /**< tree深度 */
|
|
int m_nItemHeight;/**< 表项高度 */
|
|
int m_nBranchHeight;/**< 分枝总显示高度 */
|
|
};
|
|
|
|
/**
|
|
* @class STreeBox
|
|
* @brief STreeBox
|
|
*
|
|
* Describe STreeBox
|
|
*/
|
|
class STreeBox
|
|
: public SScrollView
|
|
, public IItemContainer
|
|
, protected CSTree<STreeItem *>
|
|
{
|
|
SOUI_CLASS_NAME(STreeBox, L"treebox")
|
|
public:
|
|
/**
|
|
* STreeBox::STreeBox
|
|
* @brief 构造函数
|
|
*
|
|
* Describe 构造函数
|
|
*/
|
|
STreeBox();
|
|
|
|
/**
|
|
* STreeBox::~STreeBox
|
|
* @brief 析构函数
|
|
*
|
|
* Describe 析构函数
|
|
*/
|
|
virtual ~STreeBox();
|
|
|
|
/**
|
|
* STreeBox::InsertItem
|
|
* @brief 插入新项
|
|
* @param pugi::xml_node xmlNode -- xml数据结点
|
|
* @param DWORD dwData -- 附加数据
|
|
* @param HSTREEITEM hParent -- 父节点
|
|
* @param HSTREEITEM hInsertAfter -- 某点之后插入
|
|
* @param BOOL bEnsureVisible -- 是否显示
|
|
* @return 返回HSTREEITEM
|
|
*
|
|
* Describe 插入新项
|
|
*/
|
|
HSTREEITEM InsertItem(pugi::xml_node xmlNode,DWORD dwData,HSTREEITEM hParent=STVI_ROOT, HSTREEITEM hInsertAfter=STVI_LAST,BOOL bEnsureVisible=FALSE);
|
|
|
|
/**
|
|
* STreeBox::InsertItem
|
|
* @brief 插入新项
|
|
* @param LPCWSTR pszXml -- xml字符串(utf16)
|
|
* @param DWORD dwData -- 附加数据
|
|
* @param HSTREEITEM hParent -- 父节点
|
|
* @param HSTREEITEM hInsertAfter -- 某点之后插入
|
|
* @param BOOL bEnsureVisible -- 是否显示
|
|
* @return 返回STreeItem*
|
|
*
|
|
* Describe 插入新项
|
|
*/
|
|
STreeItem* InsertItem(LPCWSTR pszXml,DWORD dwData,HSTREEITEM hParent=STVI_ROOT, HSTREEITEM hInsertAfter=STVI_LAST,BOOL bEnsureVisible=FALSE);
|
|
|
|
/**
|
|
* STreeBox::RemoveItem
|
|
* @brief 删除某项
|
|
* @param HSTREEITEM hItem -- 待删除节点
|
|
* @return 返回BOOL
|
|
*
|
|
* Describe 插入新项
|
|
*/
|
|
BOOL RemoveItem(HSTREEITEM hItem);
|
|
|
|
/**
|
|
* STreeBox::RemoveAllItems
|
|
* @brief 删除所有某项
|
|
*
|
|
* Describe 插入新项
|
|
*/
|
|
void RemoveAllItems();
|
|
|
|
/**
|
|
* STreeBox::GetRootItem
|
|
* @brief 获取根节点
|
|
* @return 返回HSTREEITEM
|
|
*
|
|
* Describe 获取根节点
|
|
*/
|
|
HSTREEITEM GetRootItem();
|
|
|
|
/**
|
|
* STreeBox::GetNextSiblingItem
|
|
* @brief 获取兄弟节点--下一个
|
|
* @param HSTREEITEM hItem -- 节点
|
|
* @return 返回HSTREEITEM
|
|
*
|
|
* Describe 获取兄弟节点--下一个
|
|
*/
|
|
HSTREEITEM GetNextSiblingItem(HSTREEITEM hItem);
|
|
/**
|
|
* STreeBox::GetPrevSiblingItem
|
|
* @brief 获取兄弟节点--前一个
|
|
* @param HSTREEITEM hItem -- 节点
|
|
* @return 返回HSTREEITEM
|
|
*
|
|
* Describe 获取兄弟节点--前一个
|
|
*/
|
|
HSTREEITEM GetPrevSiblingItem(HSTREEITEM hItem);
|
|
/**
|
|
* STreeBox::GetChildItem
|
|
* @brief 获取子节点
|
|
* @param HSTREEITEM hItem -- 父节点
|
|
* @param BOOL bFirst -- 第几个子节点
|
|
* @return 返回HSTREEITEM
|
|
*
|
|
* Describe 获取子节点
|
|
*/
|
|
HSTREEITEM GetChildItem(HSTREEITEM hItem,BOOL bFirst =TRUE);
|
|
/**
|
|
* STreeBox::GetParentItem
|
|
* @brief 获取父节点
|
|
* @param HSTREEITEM hItem -- 子节点
|
|
* @return 返回HSTREEITEM
|
|
*
|
|
* Describe 获取父节点
|
|
*/
|
|
HSTREEITEM GetParentItem(HSTREEITEM hItem);
|
|
|
|
/**
|
|
* STreeBox::OnDestroy
|
|
* @brief 销毁
|
|
*
|
|
* Describe 获取父节点
|
|
*/
|
|
void OnDestroy();
|
|
|
|
/**
|
|
* STreeBox::Expand
|
|
* @brief 展开
|
|
* @param HSTREEITEM hItem -- 节点
|
|
* @param UINT nCode --
|
|
* @return 返回BOOL
|
|
*
|
|
* Describe 展开
|
|
*/
|
|
BOOL Expand(HSTREEITEM hItem , UINT nCode);
|
|
|
|
/**
|
|
* STreeBox::EnsureVisible
|
|
* @brief 显示某节点
|
|
* @param HSTREEITEM hItem -- 节点
|
|
*
|
|
* Describe 显示某节点
|
|
*/
|
|
BOOL EnsureVisible(HSTREEITEM hItem);
|
|
|
|
/**
|
|
* STreeBox::HitTest
|
|
* @brief 获取节点
|
|
* @param HSTREEITEM hItem -- 节点
|
|
*
|
|
* Describe 点击某节点 返回节点信息
|
|
*/
|
|
HSTREEITEM HitTest(CPoint &pt);
|
|
|
|
/**
|
|
* STreeBox::GetItemPanel
|
|
* @brief 获取节点的STreeItem对象
|
|
* @param HSTREEITEM hItem -- 节点
|
|
*
|
|
* Describe 获取节点
|
|
*/
|
|
STreeItem * GetItemPanel(HSTREEITEM hItem)
|
|
{
|
|
return GetItem(hItem);
|
|
}
|
|
|
|
/**
|
|
* STreeBox::GetItemRect
|
|
* @brief 获取节点在窗口中的显示位置
|
|
* @param HSTREEITEM hItem -- 目标节点
|
|
* @return CRect -- 显示位置（窗口坐标）
|
|
* Describe 不显示则返回空矩形
|
|
*/
|
|
CRect GetItemRect(HSTREEITEM hItem);
|
|
protected:
|
|
/**
|
|
* STreeBox::SetChildrenVisible
|
|
* @brief 设置节点显示
|
|
* @param HSTREEITEM hItem -- 节点
|
|
* @param BOOL bVisible -- 是否显示
|
|
*
|
|
* Describe 设置节点显示
|
|
*/
|
|
int SetChildrenVisible(HSTREEITEM hItem,BOOL bVisible);
|
|
/**
|
|
* STreeBox::OnNodeFree
|
|
* @brief 释放节点
|
|
* @param STreeItem * & pItem -- 待释放节点
|
|
*
|
|
* Describe 释放节点
|
|
*/
|
|
virtual void OnNodeFree(STreeItem * & pItem);
|
|
|
|
/**
|
|
* STreeBox::CreateChildren
|
|
* @brief 创建tree
|
|
* @param pugi::xml_node xmlNode -- xml文件
|
|
*
|
|
* Describe 创建tree
|
|
*/
|
|
virtual BOOL CreateChildren(pugi::xml_node xmlNode);
|
|
/**
|
|
* STreeBox::LoadBranch
|
|
* @brief 加载分支节点
|
|
* @param HSTREEITEM hParent -- 父节点
|
|
* @param pugi::xml_node xmlNode -- xml文件
|
|
*
|
|
* Describe 加载分支节点
|
|
*/
|
|
void LoadBranch(HSTREEITEM hParent,pugi::xml_node xmlNode);
|
|
|
|
void OnSize(UINT nType,CSize size);
|
|
|
|
/**
|
|
* STreeBox::RedrawItem
|
|
* @brief 重新绘制
|
|
* @param HSTREEITEM hItem -- 节点
|
|
*
|
|
* Describe 重新绘制
|
|
*/
|
|
void RedrawItem(HSTREEITEM hItem);
|
|
|
|
/**
|
|
* STreeBox::DrawItem
|
|
* @brief 绘制
|
|
* @param IRenderTarget *pRT -- 绘图设备
|
|
* @param CRect & rc -- 位置
|
|
* @param HSTREEITEM hItem -- 节点
|
|
*
|
|
* Describe 重新绘制
|
|
*/
|
|
virtual void DrawItem(IRenderTarget *pRT, CRect & rc, HSTREEITEM hItem);
|
|
|
|
virtual BOOL OnUpdateToolTip(CPoint pt, SwndToolTipInfo & tipInfo);
|
|
|
|
/**
|
|
* STreeBox::OnPaint
|
|
* @brief 绘制
|
|
* @param IRenderTarget *pRT -- 绘图设备
|
|
*
|
|
* Describe 绘制
|
|
*/
|
|
void OnPaint(IRenderTarget *pRT);
|
|
|
|
/**
|
|
* STreeBox::OnLButtonDown
|
|
* @brief 鼠标左键按下事件
|
|
* @param UINT nFlags -- 标志
|
|
* @param CPoint point -- 鼠标坐标
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
void OnLButtonDown(UINT nFlags,CPoint pt);
|
|
/**
|
|
* STreeBox::OnLButtonDbClick
|
|
* @brief 鼠标左键双击事件
|
|
* @param UINT nFlags -- 标志
|
|
* @param CPoint point -- 鼠标坐标
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
void OnLButtonDbClick(UINT nFlags,CPoint pt);
|
|
/**
|
|
* STreeBox::OnLButtonDbClick
|
|
* @brief 鼠标事件
|
|
* @param UINT uMsg -- 消息码
|
|
* @param WPARAM wParam --
|
|
* @param LPARAM lParam --
|
|
* @return 返回LRESULT
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
LRESULT OnMouseEvent(UINT uMsg,WPARAM wParam,LPARAM lParam);
|
|
|
|
/**
|
|
* STreeBox::OnMouseMove
|
|
* @brief 鼠标移动事件
|
|
* @param UINT nFlags -- 标志
|
|
* @param CPoint point -- 鼠标坐标
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
void OnMouseMove(UINT nFlags,CPoint pt);
|
|
|
|
/**
|
|
* STreeBox::OnMouseLeave
|
|
* @brief 鼠标离开事件
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
void OnMouseLeave();
|
|
/**
|
|
* STreeBox::OnSetFocus
|
|
* @brief 获得焦点
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
void OnSetFocus(SWND wndOld);
|
|
/**
|
|
* STreeBox::OnKillFocus
|
|
* @brief 失去焦点
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
void OnKillFocus(SWND wndFocus);
|
|
/**
|
|
* STreeBox::OnKeyEvent
|
|
* @brief 按键事件
|
|
* @param UINT uMsg -- 消息码
|
|
* @param WPARAM wParam --
|
|
* @param LPARAM lParam --
|
|
* @return 返回LRESULT
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
LRESULT OnKeyEvent( UINT uMsg,WPARAM wParam,LPARAM lParam );
|
|
/**
|
|
* STreeBox::FireEvent
|
|
* @brief
|
|
* @param EventArgs &evt --
|
|
*
|
|
* Describe
|
|
*/
|
|
virtual BOOL FireEvent(EventArgs &evt);
|
|
/**
|
|
* STreeBox::OnSetCursor
|
|
* @brief 设置鼠标
|
|
* @param const CPoint &pt -- 位置
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
virtual BOOL OnSetCursor(const CPoint &pt);
|
|
/**
|
|
* STreeBox::OnViewOriginChanged
|
|
* @brief
|
|
* @param CPoint ptOld --
|
|
* @param CPoint ptNew --
|
|
*
|
|
* Describe
|
|
*/
|
|
virtual void OnViewOriginChanged( CPoint ptOld,CPoint ptNew );
|
|
|
|
virtual void OnViewSizeChanged(CSize szOld,CSize szNew);
|
|
|
|
/**
|
|
* STreeBox::OnGetDlgCode
|
|
* @brief 获取窗口消息码
|
|
* @return 返回UINT
|
|
*
|
|
* Describe 此函数是消息响应函数
|
|
*/
|
|
virtual UINT OnGetDlgCode()
|
|
{
|
|
return SC_WANTALLKEYS;
|
|
}
|
|
|
|
protected:
|
|
/**
|
|
* STreeBox::IsAncestor
|
|
* @brief 判断是否是先祖
|
|
* @param HSTREEITEM hItem1 -- 节点1
|
|
* @param HSTREEITEM hItem2 -- 节点2
|
|
*
|
|
* Describe 判断是否是先祖
|
|
*/
|
|
BOOL IsAncestor(HSTREEITEM hItem1,HSTREEITEM hItem2);
|
|
|
|
void UpdateSwitchState(HSTREEITEM hItem);
|
|
|
|
void UpdateItemWidth(HSTREEITEM hItem,int nWidth);
|
|
|
|
void SetViewHeight(int nHeight);
|
|
|
|
bool OnItemStateChanged(EventArgs *pEvt);
|
|
|
|
void UpdateAncestorBranchHeight(HSTREEITEM hItem,int nHeightChange);
|
|
|
|
/**
|
|
* STreeBox::GetItemShowIndex
|
|
* @brief 获取索引
|
|
* @param HSTREEITEM hItemObj -- 节点
|
|
*
|
|
* Describe 获取索引
|
|
*/
|
|
int GetItemShowIndex(HSTREEITEM hItemObj);
|
|
|
|
//计算一个ITEM在控件中显示的偏移量
|
|
CPoint GetItemOffsetInView(HSTREEITEM hItem);
|
|
|
|
CRect GetItemRectInView(HSTREEITEM hItem);
|
|
|
|
void PaintVisibleItem(IRenderTarget *pRT,IRegion *pRgn,HSTREEITEM hItem,int & yOffset);
|
|
|
|
HSTREEITEM _HitTest(HSTREEITEM hItem,int & yOffset,const CPoint & pt );
|
|
protected:
|
|
/**
|
|
* STreeBox::OnItemSetCapture
|
|
* @brief 判断是否捕获
|
|
* @param SItemPanel *pItem -- 节点
|
|
* @param BOOL bCapture -- 是否捕获
|
|
*
|
|
* Describe 判断是否捕获
|
|
*/
|
|
virtual void OnItemSetCapture(SItemPanel *pItem,BOOL bCapture);
|
|
/**
|
|
* STreeBox::OnItemGetRect
|
|
* @brief
|
|
* @param SItemPanel *pItem -- 节点
|
|
* @param CRect &rcItem -- 位置
|
|
*
|
|
* Describe
|
|
*/
|
|
virtual BOOL OnItemGetRect(SItemPanel *pItem,CRect &rcItem);
|
|
|
|
/**
|
|
* STreeBox::IsItemRedrawDelay
|
|
* @brief 获取表项延时刷新标志
|
|
* @param 返回BOOL
|
|
*
|
|
* Describe
|
|
*/
|
|
virtual BOOL IsItemRedrawDelay(){return m_bItemRedrawDelay;}
|
|
|
|
virtual void OnItemRequestRelayout(SItemPanel *pItem);
|
|
|
|
HSTREEITEM m_hSelItem; /**< 选中item */
|
|
HSTREEITEM m_hHoverItem; /**< hover状态item */
|
|
|
|
SItemPanel *m_pCapturedFrame; /**< 当前捕获光标的表项 */
|
|
|
|
int m_nItemHeight; /**< 高度 */
|
|
int m_nIndent; /**< 缩进 */
|
|
COLORREF m_crItemBg; /**< 背景色 */
|
|
COLORREF m_crItemSelBg; /**< 选中背景色 */
|
|
ISkinObj * m_pItemSkin; /**< ISkinObj对象 */
|
|
BOOL m_bItemRedrawDelay; /**< 表项中控件刷新时延时*/
|
|
pugi::xml_document m_xmlTemplate;/**< XML模板*/
|
|
|
|
SOUI_ATTRS_BEGIN()
|
|
ATTR_INT(L"indent", m_nIndent, TRUE)
|
|
ATTR_INT(L"itemHeight", m_nItemHeight, TRUE)
|
|
ATTR_SKIN(L"itemSkin", m_pItemSkin, TRUE)
|
|
ATTR_COLOR(L"colorItemBkgnd",m_crItemBg,FALSE)
|
|
ATTR_COLOR(L"colorItemSelBkgnd",m_crItemSelBg,FALSE)
|
|
ATTR_INT(L"itemRedrawDelay", m_bItemRedrawDelay, TRUE)
|
|
SOUI_ATTRS_END()
|
|
|
|
SOUI_MSG_MAP_BEGIN()
|
|
MSG_WM_PAINT_EX(OnPaint)
|
|
MSG_WM_NCCALCSIZE(OnNcCalcSize)
|
|
MSG_WM_SIZE(OnSize)
|
|
MSG_WM_DESTROY(OnDestroy)
|
|
MSG_WM_LBUTTONDOWN(OnLButtonDown)
|
|
MSG_WM_LBUTTONDBLCLK(OnLButtonDbClick)
|
|
MSG_WM_MOUSEMOVE(OnMouseMove)
|
|
MSG_WM_MOUSELEAVE(OnMouseLeave)
|
|
MSG_WM_SETFOCUS_EX(OnSetFocus)
|
|
MSG_WM_KILLFOCUS_EX(OnKillFocus)
|
|
MESSAGE_RANGE_HANDLER_EX(WM_MOUSEFIRST,WM_MOUSELAST,OnMouseEvent)
|
|
MESSAGE_RANGE_HANDLER_EX(WM_KEYFIRST,WM_KEYLAST,OnKeyEvent)
|
|
MESSAGE_RANGE_HANDLER_EX(WM_IME_STARTCOMPOSITION,WM_IME_KEYLAST,OnKeyEvent)
|
|
MESSAGE_HANDLER_EX(WM_IME_CHAR,OnKeyEvent)
|
|
SOUI_MSG_MAP_END()
|
|
};
|
|
|
|
}//namespace SOUI
|