#include <ControlBase.h>

类 HiEasyX::ControlBase 继承关系图:

Public 成员函数
	ControlBase ()

	ControlBase (std::wstring wstrText)

	ControlBase (int x, int y, int w=0, int h=0, std::wstring wstrText=L"")

virtual	~ControlBase ()

ControlBase *	GetParent ()

virtual void	SetParent (ControlBase *p)
	设置父控件（父控件调用 AddChild）更多...

virtual bool	IsAutoSizeForChild () const

virtual void	EnableAutoSizeForChild (bool enable)
	为子控件自动改变大小以容纳控件（不容纳负坐标部分）更多...

std::list< ControlBase * > &	GetChildList ()

size_t	GetChildCount ()
	获取子控件总数更多...

virtual void	AddChild (ControlBase *p, int offset_x=0, int offset_y=0)

virtual void	RemoveChild (ControlBase *p)

virtual bool	IsEnabled () const

virtual void	SetEnable (bool enable)

virtual bool	IsVisible () const

virtual void	SetVisible (bool visible)

virtual bool	GetAutoRedrawState () const

virtual void	EnableAutoRedraw (bool enable)
	启用自动重绘（接受到基础消息事件时自动标识需要重绘）更多...

virtual Canvas &	GetCanvas ()

virtual COLORREF	GetBkColor () const

virtual void	SetBkColor (COLORREF color)

virtual COLORREF	GetTextColor () const

virtual void	SetTextColor (COLORREF color)

virtual void	EnableBorder (bool bEnableBorder, COLORREF color=BLACK, int thickness=1)

virtual void	SetAlpha (BYTE alpha, bool bUseCanvasAlpha, bool isAlphaCalculated)

virtual std::wstring	GetText () const

virtual void	SetText (std::wstring wstr)

virtual void	Draw_Text (int nTextOffsetX=0, int nTextOffsetY=0)

virtual void	Redraw ()
	重绘控件更多...

virtual void	Draw (bool draw_child=true)
	绘制控件更多...

virtual void	Render (Canvas dst, RECT pRct=nullptr, int *pCount=0)
	渲染控件到外部更多...

virtual void	SetMsgProcFunc (MESSAGE_PROC_FUNC func)
	设置消息响应函数更多...

virtual void	SetMsgProcFunc (MESSAGE_PROC_FUNC_CLASS static_class_func, void *_this)
	设置消息响应函数为静态类函数更多...

virtual void	UpdateMessage (ExMessage msg)
	更新消息更多...

virtual bool	IsHovered () const
	判断鼠标是否悬停更多...

virtual bool	IsFocused () const
	判断是否拥有焦点更多...

virtual bool	IsPressed () const
	判断是否按下更多...

Public 成员函数继承自 HiEasyX::Container
	Container ()

virtual	~Container ()

RECT	GetRect () const

void	SetRect (int x, int y, int w, int h)
	设置位置和宽高更多...

void	SetRect (RECT rct)
	设置矩形区域更多...

POINT	GetPos () const

int	GetX () const

int	GetY () const

void	SetPos (int x, int y)

void	SetPos (POINT pt)

void	Move (int x, int y)

void	MoveRel (int dx, int dy)

int	GetWidth () const

void	SetWidth (int w)

int	GetHeight () const

void	SetHeight (int h)

void	Resize (int w, int h)

Protected 成员函数
void	UpdateRect (RECT rctOld) override
	更新区域消息处理更多...

void	MarkNeedRedrawAndRender ()
	标记需要重绘和渲染更多...

void	MarkNeedClearRect (RECT rct)
	标记需要清空矩形区域更多...

virtual void	DrawChild ()
	绘制子控件更多...

virtual ExMessage &	TransformMessage (ExMessage &msg)
	转换消息更多...

virtual void	CallUserMsgProcFunc (int msgid, ExMessage msg)
	分发消息到用户函数更多...

virtual void	ChildRectChanged (ControlBase *pChild)
	子控件区域变更更多...

Protected 属性
bool	m_bEnabled = true
	是否可用更多...

bool	m_bVisible = true
	是否可见更多...

bool	m_bAutoRedrawWhenReceiveMsg = true
	当默认消息处理函数接受到消息时，是否自动标识重绘和渲染更多...

bool	m_bRedraw = true
	标识需要重绘更多...

bool	m_bRender = true
	标识需要渲染更多...

bool	m_bClear = false
	标识需要清空某区域更多...

RECT	m_rctClear = { 0 }
	记录需要清空的区域更多...

bool	m_bAlwaysRedrawAndRender = false
	总是重绘和渲染（占用更高）更多...

std::wstring	m_wstrText
	控件文本更多...

Canvas	m_canvas
	画布更多...

BYTE	m_alpha = 255
	透明度更多...

bool	m_bUseCanvasAlpha = false
	是否使用画布自身的透明度信息更多...

bool	m_isAlphaCalculated = false
	画布是否已经计算透明混合颜色更多...

COLORREF	m_cBorder = MODERN_BORDER_GRAY
	边框颜色更多...

COLORREF	m_cBackground = CLASSICGRAY
	背景色更多...

COLORREF	m_cText = BLACK
	文本颜色更多...

bool	m_bEnableBorder = true
	是否绘制边框更多...

int	m_nBorderThickness = 1
	边框粗细更多...

bool	m_bCompleteFirstSetRect = false
	是否已经完成第一次设置区域更多...

ControlBase *	m_pParent = nullptr
	父控件更多...

std::list< ControlBase * >	m_listChild
	子控件更多...

bool	m_bAutoSizeForChild = false
	为子控件自动改变大小以容纳控件更多...

MESSAGE_PROC_FUNC	m_funcMessageProc = nullptr
	消息处理函数更多...

MESSAGE_PROC_FUNC_CLASS	m_funcMessageProc_Class = nullptr
	若绑定的消息处理函数是静态类函数，则记录其地址更多...

void *	m_pCalledClass = nullptr
	若绑定的消息处理函数是静态类函数，则记录该类指针更多...

bool	m_bHovered = false
	鼠标是否悬停更多...

bool	m_bPressed = false
	鼠标是否按下更多...

bool	m_bFocused = false
	是否拥有焦点更多...

Protected 属性继承自 HiEasyX::Container
RECT	m_rct = { 0 }
	容器区域更多...

详细描述

控件基础

在文件 ControlBase.h 第 52 行定义.

构造及析构函数说明

◆ ControlBase() [1/3]

HiEasyX::ControlBase::ControlBase ( )

在文件 ControlBase.cpp 第 14 行定义.

     {
         Init();
     }

◆ ControlBase() [2/3]

HiEasyX::ControlBase::ControlBase ( std::wstring wstrText )

在文件 ControlBase.cpp 第 19 行定义.

     {
         Init();
         SetText(wstrText);
     }

◆ ControlBase() [3/3]

HiEasyX::ControlBase::ControlBase	(	int	x,
		int	y,
		int	w = `0`,
		int	h = `0`,
		std::wstring	wstrText = `L""`
	)

在文件 ControlBase.cpp 第 25 行定义.

     {
         Init();
         SetRect(x, y, w, h);
         SetText(wstrText);
     }

◆ ~ControlBase()

HiEasyX::ControlBase::~ControlBase ( )

virtual

在文件 ControlBase.cpp 第 32 行定义.

33 {

34 }

成员函数说明

◆ AddChild()

void HiEasyX::ControlBase::AddChild	(	ControlBase *	p,
		int	offset_x = `0`,
		int	offset_y = `0`
	)

virtual

在文件 ControlBase.cpp 第 118 行定义.

     {
         for (auto& child : m_listChild)
             if (child == p)
                 return;
         p->MoveRel(offset_x, offset_y);
         p->m_pParent = this;
         m_listChild.push_back(p);
         ChildRectChanged(p);
  
         MarkNeedRedrawAndRender();
     }

◆ CallUserMsgProcFunc()

void HiEasyX::ControlBase::CallUserMsgProcFunc	(	int	msgid,
		ExMessage	msg
	)

protectedvirtual

分发消息到用户函数

参数

[in]	msgid	消息 ID
[in]	msg	消息内容

在文件 ControlBase.cpp 第 368 行定义.

     {
         if (m_funcMessageProc)
         {
             m_funcMessageProc(this, msgid, msg);
         }
         else if (m_funcMessageProc_Class)
         {
             m_funcMessageProc_Class(m_pCalledClass, this, msgid, msg);
         }
     }

◆ ChildRectChanged()

void HiEasyX::ControlBase::ChildRectChanged ( ControlBase * pChild )

protectedvirtual

子控件区域变更

参数

[in] pChild 区域变更的子控件

在文件 ControlBase.cpp 第 380 行定义.

     {
         if (m_bAutoSizeForChild)
         {
             int _w = GetWidth(), _h = GetHeight();
             if (pChild->m_rct.right > _w)       _w += pChild->m_rct.right - _w;
             if (pChild->m_rct.bottom > _h)      _h += pChild->m_rct.bottom - _h;
             Resize(_w, _h);
         }
     }

◆ Draw()

void HiEasyX::ControlBase::Draw ( bool draw_child = true )

virtual

绘制控件

参数

[in] draw_child 是否绘制子控件

被 HiEasyX::ScrollBar, HiEasyX::ProgressCtrl, HiEasyX::Static , 以及 HiEasyX::Button 重载.

在文件 ControlBase.cpp 第 224 行定义.

     {
         if (m_bRedraw || m_bAlwaysRedrawAndRender)
         {
             m_canvas.SetLineThickness(m_nBorderThickness);
             m_canvas.FillRectangle(
                 0, 0, GetWidth() - 1, GetHeight() - 1,
                 true, m_bEnableBorder ? m_cBorder : m_cBackground, m_cBackground
             );
  
             if (!m_bAlwaysRedrawAndRender)
             {
                 m_bRedraw = false;
             }
         }
  
         if (draw_child)
         {
             DrawChild();
         }
     }

◆ Draw_Text()

void HiEasyX::ControlBase::Draw_Text	(	int	nTextOffsetX = `0`,
		int	nTextOffsetY = `0`
	)

virtual

被 HiEasyX::Static 重载.

在文件 ControlBase.cpp 第 205 行定义.

     {
         m_canvas.SetBkColor(m_cBackground);
         m_canvas.SetTextColor(m_cText);
         int w = m_canvas.TextWidth(m_wstrText.c_str());
         int h = m_canvas.TextHeight(m_wstrText.c_str());
         m_canvas.OutTextXY(
             (GetWidth() - w) / 2 + nTextOffsetX,
             (GetHeight() - h) / 2 + nTextOffsetY,
             m_wstrText.c_str()
         );
     }

◆ DrawChild()

void HiEasyX::ControlBase::DrawChild ( )

protectedvirtual

绘制子控件

在文件 ControlBase.cpp 第 246 行定义.

     {
         for (auto& child : m_listChild)
         {
             child->Draw();
         }
     }

◆ EnableAutoRedraw()

void HiEasyX::ControlBase::EnableAutoRedraw ( bool enable )

virtual

启用自动重绘（接受到基础消息事件时自动标识需要重绘）

参数

[in] enable 是否启用

在文件 ControlBase.cpp 第 154 行定义.

     {
         m_bAutoRedrawWhenReceiveMsg = enable;
     }

◆ EnableAutoSizeForChild()

void HiEasyX::ControlBase::EnableAutoSizeForChild ( bool enable )

virtual

为子控件自动改变大小以容纳控件（不容纳负坐标部分）

参数

[in] enable 是否启用

在文件 ControlBase.cpp 第 100 行定义.

     {
         m_bAutoSizeForChild = enable;
     }

◆ EnableBorder()

void HiEasyX::ControlBase::EnableBorder	(	bool	bEnableBorder,
		COLORREF	color = `BLACK`,
		int	thickness = `1`
	)

virtual

在文件 ControlBase.cpp 第 175 行定义.

     {
         m_bEnableBorder = bEnableBorder;
         if (bEnableBorder)
         {
             m_cBorder = color;
             m_nBorderThickness = thickness;
  
             m_canvas.SetLineColor(m_cBorder);
         }
  
         MarkNeedRedrawAndRender();
     }

◆ GetAutoRedrawState()

virtual bool HiEasyX::ControlBase::GetAutoRedrawState ( ) const

inlinevirtual

在文件 ControlBase.h 第 187 行定义.

187 { return m_bAutoRedrawWhenReceiveMsg; }

◆ GetBkColor()

virtual COLORREF HiEasyX::ControlBase::GetBkColor ( ) const

inlinevirtual

在文件 ControlBase.h 第 197 行定义.

197 { return m_cBackground; }

◆ GetCanvas()

virtual Canvas& HiEasyX::ControlBase::GetCanvas ( )

inlinevirtual

在文件 ControlBase.h 第 195 行定义.

195 { return m_canvas; }

◆ GetChildCount()

size_t HiEasyX::ControlBase::GetChildCount ( )

获取子控件总数

在文件 ControlBase.cpp 第 110 行定义.

     {
         size_t sum = m_listChild.size();
         for (auto& child : m_listChild)
             sum += child->GetChildCount();
         return sum;
     }

◆ GetChildList()

std::list< ControlBase * > & HiEasyX::ControlBase::GetChildList ( )

在文件 ControlBase.cpp 第 105 行定义.

     {
         return m_listChild;
     }

◆ GetParent()

ControlBase* HiEasyX::ControlBase::GetParent ( )

inline

在文件 ControlBase.h 第 152 行定义.

152 { return m_pParent; }

◆ GetText()

virtual std::wstring HiEasyX::ControlBase::GetText ( ) const

inlinevirtual

在文件 ControlBase.h 第 209 行定义.

209 { return m_wstrText; }

◆ GetTextColor()

virtual COLORREF HiEasyX::ControlBase::GetTextColor ( ) const

inlinevirtual

在文件 ControlBase.h 第 201 行定义.

201 { return m_cText; }

◆ IsAutoSizeForChild()

virtual bool HiEasyX::ControlBase::IsAutoSizeForChild ( ) const

inlinevirtual

在文件 ControlBase.h 第 160 行定义.

160 { return m_bAutoSizeForChild; }

◆ IsEnabled()

virtual bool HiEasyX::ControlBase::IsEnabled ( ) const

inlinevirtual

在文件 ControlBase.h 第 179 行定义.

179 { return m_bEnabled; }

◆ IsFocused()

virtual bool HiEasyX::ControlBase::IsFocused ( ) const

inlinevirtual

判断是否拥有焦点

在文件 ControlBase.h 第 261 行定义.

261 { return m_bFocused; }

◆ IsHovered()

virtual bool HiEasyX::ControlBase::IsHovered ( ) const

inlinevirtual

判断鼠标是否悬停

在文件 ControlBase.h 第 256 行定义.

256 { return m_bHovered; }

◆ IsPressed()

virtual bool HiEasyX::ControlBase::IsPressed ( ) const

inlinevirtual

判断是否按下

在文件 ControlBase.h 第 266 行定义.

266 { return m_bPressed; }

◆ IsVisible()

virtual bool HiEasyX::ControlBase::IsVisible ( ) const

inlinevirtual

在文件 ControlBase.h 第 183 行定义.

183 { return m_bVisible; }

◆ MarkNeedClearRect()

void HiEasyX::ControlBase::MarkNeedClearRect ( RECT rct )

protected

标记需要清空矩形区域

参数

[in] rct 需要清空的区域

在文件 ControlBase.cpp 第 72 行定义.

     {
         m_bClear = true;
         m_rctClear = rct;
     }

◆ MarkNeedRedrawAndRender()

void HiEasyX::ControlBase::MarkNeedRedrawAndRender ( )

protected

标记需要重绘和渲染

在文件 ControlBase.cpp 第 62 行定义.

     {
         m_bRedraw = true;
         m_bRender = true;
  
         // 重绘后，渲染时也要渲染子控件，否则会覆盖
         for (auto& child : m_listChild)
             child->m_bRender = true;
     }

◆ Redraw()

void HiEasyX::ControlBase::Redraw ( )

virtual

重绘控件

在文件 ControlBase.cpp 第 218 行定义.

     {
         MarkNeedRedrawAndRender();
         Draw();
     }

◆ RemoveChild()

void HiEasyX::ControlBase::RemoveChild ( ControlBase * p )

virtual

在文件 ControlBase.cpp 第 131 行定义.

     {
         m_listChild.remove(p);
  
         MarkNeedRedrawAndRender();
     }

◆ Render()

void HiEasyX::ControlBase::Render	(	Canvas *	dst,
		RECT *	pRct = `nullptr`,
		int *	pCount = `0`
	)

virtual

渲染控件到外部

参数

[in]	dst	渲染目标
[in]	pRct	内部使用，传入父控件渲染区域数组
[in,out]	pCount	内部使用，传入父控件渲染区域数量指针

被 HiEasyX::Page 重载.

在文件 ControlBase.cpp 第 254 行定义.

     {
         // 当前控件获取到的重绘矩形记录
         size_t size = m_bRender ? 1 : GetChildCount();  // 若自身需要绘制，则只需要记录一个矩形
         RECT* my_rct = new RECT[size];
         int my_count = 0;                               // 当前控件获取到的重绘区域数量统计
  
         // 为当前控件的子控件执行清除任务
         // 必须在 Render 前执行，否则可能覆盖效果
         for (auto& child : m_listChild)
         {
             if (child->m_bClear)
             {
                 m_canvas.ClearRectangle(child->m_rctClear);
                 MOVE_RECT(child->m_rctClear, m_rct.left, m_rct.top);
                 dst->ClearRectangle(child->m_rctClear);
  
                 child->m_bClear = false;
                 child->m_rctClear = { 0 };
             }
         }
  
         // 控件必须可显示才渲染
         if (m_bVisible)
         {
             // 子控件可能很多，开启批量绘制
             m_canvas.BeginBatchDrawing();
  
             // 如果自身需要渲染，则只需要记录自身矩形
             if (m_bRender || m_bAlwaysRedrawAndRender)
             {
                 // 子控件先绘制到此控件画布上，再绘制到 dst
                 for (auto& child : m_listChild)
                     child->Render(&m_canvas);
  
                 my_rct[my_count++] = { 0,0,GetWidth(),GetHeight() };
  
                 if (!m_bAlwaysRedrawAndRender)
                     m_bRender = false;
             }
  
             // 若自身不渲染，则必须记录子控件渲染区域
             else
             {
                 for (auto& child : m_listChild)
                 {
                     child->Render(&m_canvas, my_rct, &my_count);
                 }
             }
  
             m_canvas.EndBatchDrawing();
  
             // 渲染有更新的区域
             for (int i = 0; i < my_count; i++)
             {
                 dst->PutImageIn_Alpha(
                     m_rct.left, m_rct.top,
                     &m_canvas,
                     my_rct[i],
                     m_alpha, m_bUseCanvasAlpha, m_isAlphaCalculated
                 );
             }
  
             // 为了返回区域信息给父控件，需要转换区域坐标参考系
             if (pRct)
             {
                 for (int i = 0; i < my_count; i++)
                 {
                     MOVE_RECT(my_rct[i], m_rct.left, m_rct.top);
                     pRct[(*pCount)++] = my_rct[i];
                 }
             }
         }
  
         delete[] my_rct;
  
         /*for (auto& child : m_listChild)
             child->Render(&m_canvas);
         dst->PutImageIn_Alpha(
             m_rct.left, m_rct.top,
             &m_canvas,
             { 0 },
             m_alpha, m_bUseCanvasAlpha, m_isAlphaCalculated
         );*/
     }

◆ SetAlpha()

void HiEasyX::ControlBase::SetAlpha	(	BYTE	alpha,
		bool	bUseCanvasAlpha,
		bool	isAlphaCalculated
	)

virtual

在文件 ControlBase.cpp 第 189 行定义.

     {
         m_alpha = alpha;
         m_bUseCanvasAlpha = bUseCanvasAlpha;
         m_isAlphaCalculated = isAlphaCalculated;
  
         MarkNeedRedrawAndRender();
     }

◆ SetBkColor()

void HiEasyX::ControlBase::SetBkColor ( COLORREF color )

virtual

在文件 ControlBase.cpp 第 159 行定义.

     {
         m_cBackground = color;
         m_canvas.SetBkColor(color);
  
         MarkNeedRedrawAndRender();
     }

◆ SetEnable()

void HiEasyX::ControlBase::SetEnable ( bool enable )

virtual

被 HiEasyX::Button 重载.

在文件 ControlBase.cpp 第 78 行定义.

     {
         m_bEnabled = enable;
  
         MarkNeedRedrawAndRender();
     }

◆ SetMsgProcFunc() [1/2]

void HiEasyX::ControlBase::SetMsgProcFunc ( MESSAGE_PROC_FUNC func )

virtual

设置消息响应函数

参数

[in] func 消息响应函数

在文件 ControlBase.cpp 第 340 行定义.

     {
         m_funcMessageProc = func;
         m_funcMessageProc_Class = nullptr;
         m_pCalledClass = nullptr;
     }

◆ SetMsgProcFunc() [2/2]

void HiEasyX::ControlBase::SetMsgProcFunc	(	MESSAGE_PROC_FUNC_CLASS	static_class_func,
		void *	_this
	)

virtual

设置消息响应函数为静态类函数

参数

[in]	static_class_func	消息响应函数（静态类函数）
[in]	_this	类指针

在文件 ControlBase.cpp 第 347 行定义.

     {
         m_funcMessageProc = nullptr;
         m_funcMessageProc_Class = static_class_func;
         m_pCalledClass = _this;
     }

◆ SetParent()

void HiEasyX::ControlBase::SetParent ( ControlBase * p )

virtual

设置父控件（父控件调用 AddChild）

参数

[in] p 父控件

在文件 ControlBase.cpp 第 85 行定义.

     {
         if (m_pParent)
         {
             m_pParent->RemoveChild(this);
         }
         if (p)
         {
             m_pParent = p;
             p->AddChild(this);
         }
  
         MarkNeedRedrawAndRender();
     }

◆ SetText()

void HiEasyX::ControlBase::SetText ( std::wstring wstr )

virtual

被 HiEasyX::Static 重载.

在文件 ControlBase.cpp 第 198 行定义.

     {
         m_wstrText = wstr;
  
         MarkNeedRedrawAndRender();
     }

◆ SetTextColor()

void HiEasyX::ControlBase::SetTextColor ( COLORREF color )

virtual

在文件 ControlBase.cpp 第 167 行定义.

     {
         m_cText = color;
         m_canvas.SetTextColor(color);
  
         MarkNeedRedrawAndRender();
     }

◆ SetVisible()

void HiEasyX::ControlBase::SetVisible ( bool visible )

virtual

在文件 ControlBase.cpp 第 138 行定义.

     {
         m_bVisible = bVisible;
  
         // 设为可见时重新渲染
         if (m_bVisible)
         {
             m_bRender = true;
         }
         // 设为不可见时清除
         else
         {
             MarkNeedClearRect(m_rct);
         }
     }

◆ TransformMessage()

ExMessage & HiEasyX::ControlBase::TransformMessage ( ExMessage & msg )

protectedvirtual

转换消息

参数

[in,out] msg 要转换的消息

返回: 转换后的消息

在文件 ControlBase.cpp 第 354 行定义.

     {
         switch (GetExMessageType(msg))
         {
         case EM_MOUSE:
             msg.x -= GetX();
             msg.y -= GetY();
             break;
         default:
             break;
         }
         return msg;
     }

◆ UpdateMessage()

void HiEasyX::ControlBase::UpdateMessage ( ExMessage msg )

virtual

更新消息

参数

[in] msg 新消息

被 HiEasyX::ScrollBar , 以及 HiEasyX::Button 重载.

在文件 ControlBase.cpp 第 391 行定义.

     {
         if (m_bVisible && m_bEnabled)
         {
             TransformMessage(msg);
  
             // 标识该消息是否值得重绘
             bool msg_worth_redraw = false;
  
             // 鼠标在区域内
             if (IsInRect(msg.x, msg.y, { 0,0,GetWidth(),GetHeight() }))
             {
                 // 鼠标移入
                 if (!m_bHovered)
                 {
                     m_bHovered = true;
                     CallUserMsgProcFunc(CM_HOVER, msg);
                 }
  
                 switch (msg.message)
                 {
                 case WM_LBUTTONDOWN:
                 {
                     m_bPressed = true;
                     CallUserMsgProcFunc(CM_PRESS, msg);
                     if (!m_bFocused)
                     {
                         m_bFocused = true;
                         CallUserMsgProcFunc(CM_FOCUS, msg);
                     }
                 }
                 break;
  
                 case WM_LBUTTONUP:
                 {
                     m_bPressed = false;
                     if (m_bFocused)
                     {
                         CallUserMsgProcFunc(CM_PRESS_OVER, msg);
                         CallUserMsgProcFunc(CM_CLICK, msg);
                     }
                 }
                 break;
  
                 case WM_LBUTTONDBLCLK:
                 {
                     CallUserMsgProcFunc(CM_DOUBLE_CLICK, msg);
                 }
                 break;
  
                 default:
                 {
                     CallUserMsgProcFunc(CM_OTHER, msg);
                 }
                 break;
  
                 }
  
                 msg_worth_redraw = true;
             }
  
             // 鼠标不在区域内
             else
             {
                 // 移出
                 if (m_bHovered)
                 {
                     m_bHovered = false;
                     CallUserMsgProcFunc(CM_HOVER_OVER, msg);
  
                     msg_worth_redraw = true;
                 }
  
                 // 离开区域，按下失效
                 if (m_bPressed)
                 {
                     m_bPressed = false;
                     CallUserMsgProcFunc(CM_PRESS_OVER, msg);
  
                     msg_worth_redraw = true;
                 }
  
                 switch (msg.message)
                 {
                 case WM_LBUTTONDOWN:
                 {
                     if (m_bFocused)
                     {
                         m_bFocused = false;
                         CallUserMsgProcFunc(CM_FOCUS_OVER, msg);
  
                         msg_worth_redraw = true;
                     }
                 }
                 break;
  
                 default:
                 {
                     CallUserMsgProcFunc(CM_OTHER, msg);
                 }
                 break;
  
                 }
             }
  
             // 默认重绘，且满足条件
             if (m_bAutoRedrawWhenReceiveMsg && msg_worth_redraw)
             {
                 MarkNeedRedrawAndRender();
             }
  
             for (auto& child : m_listChild)
             {
                 child->UpdateMessage(msg);
             }
         }
     }

◆ UpdateRect()

void HiEasyX::ControlBase::UpdateRect ( RECT rctOld )

overrideprotectedvirtual

更新区域消息处理

参数

[in] rctOld 旧区域

重载 HiEasyX::Container .

被 HiEasyX::ScrollBar 重载.

在文件 ControlBase.cpp 第 36 行定义.

     {
         Container::UpdateRect(rctOld);
  
         m_canvas.Resize(GetWidth(), GetHeight());
  
         // 标识重绘和渲染
         MarkNeedRedrawAndRender();
  
         // 不是第一次设置位置时，需要清除旧区域
         if (m_bCompleteFirstSetRect)
         {
             // 标识清空旧区域
             MarkNeedClearRect(rctOld);
         }
         else
         {
             m_bCompleteFirstSetRect = true;
         }
  
         if (m_pParent)
         {
             m_pParent->ChildRectChanged(this);
         }
     }

类成员变量说明

◆ m_alpha

BYTE HiEasyX::ControlBase::m_alpha = 255

protected

透明度

在文件 ControlBase.h 第 70 行定义.

◆ m_bAlwaysRedrawAndRender

bool HiEasyX::ControlBase::m_bAlwaysRedrawAndRender = false

protected

总是重绘和渲染（占用更高）

在文件 ControlBase.h 第 65 行定义.

◆ m_bAutoRedrawWhenReceiveMsg

bool HiEasyX::ControlBase::m_bAutoRedrawWhenReceiveMsg = true

protected

当默认消息处理函数接受到消息时，是否自动标识重绘和渲染

在文件 ControlBase.h 第 60 行定义.

◆ m_bAutoSizeForChild

bool HiEasyX::ControlBase::m_bAutoSizeForChild = false

protected

为子控件自动改变大小以容纳控件

在文件 ControlBase.h 第 86 行定义.

◆ m_bClear

bool HiEasyX::ControlBase::m_bClear = false

protected

标识需要清空某区域

在文件 ControlBase.h 第 63 行定义.

◆ m_bCompleteFirstSetRect

bool HiEasyX::ControlBase::m_bCompleteFirstSetRect = false

protected

是否已经完成第一次设置区域

在文件 ControlBase.h 第 81 行定义.

◆ m_bEnableBorder

bool HiEasyX::ControlBase::m_bEnableBorder = true

protected

是否绘制边框

在文件 ControlBase.h 第 78 行定义.

◆ m_bEnabled

bool HiEasyX::ControlBase::m_bEnabled = true

protected

是否可用

在文件 ControlBase.h 第 56 行定义.

◆ m_bFocused

bool HiEasyX::ControlBase::m_bFocused = false

protected

是否拥有焦点

在文件 ControlBase.h 第 94 行定义.

◆ m_bHovered

bool HiEasyX::ControlBase::m_bHovered = false

protected

鼠标是否悬停

在文件 ControlBase.h 第 92 行定义.

◆ m_bPressed

bool HiEasyX::ControlBase::m_bPressed = false

protected

鼠标是否按下

在文件 ControlBase.h 第 93 行定义.

◆ m_bRedraw

bool HiEasyX::ControlBase::m_bRedraw = true

protected

标识需要重绘

在文件 ControlBase.h 第 61 行定义.

◆ m_bRender

bool HiEasyX::ControlBase::m_bRender = true

protected

标识需要渲染

在文件 ControlBase.h 第 62 行定义.

◆ m_bUseCanvasAlpha

bool HiEasyX::ControlBase::m_bUseCanvasAlpha = false

protected

是否使用画布自身的透明度信息

在文件 ControlBase.h 第 71 行定义.

◆ m_bVisible

bool HiEasyX::ControlBase::m_bVisible = true

protected

是否可见

在文件 ControlBase.h 第 57 行定义.

◆ m_canvas

Canvas HiEasyX::ControlBase::m_canvas

protected

画布

在文件 ControlBase.h 第 69 行定义.

◆ m_cBackground

COLORREF HiEasyX::ControlBase::m_cBackground = CLASSICGRAY

protected

背景色

在文件 ControlBase.h 第 75 行定义.

◆ m_cBorder

COLORREF HiEasyX::ControlBase::m_cBorder = MODERN_BORDER_GRAY

protected

边框颜色

在文件 ControlBase.h 第 74 行定义.

◆ m_cText

COLORREF HiEasyX::ControlBase::m_cText = BLACK

protected

文本颜色

在文件 ControlBase.h 第 76 行定义.

◆ m_funcMessageProc

MESSAGE_PROC_FUNC HiEasyX::ControlBase::m_funcMessageProc = nullptr

protected

消息处理函数

在文件 ControlBase.h 第 88 行定义.

◆ m_funcMessageProc_Class

MESSAGE_PROC_FUNC_CLASS HiEasyX::ControlBase::m_funcMessageProc_Class = nullptr

protected

若绑定的消息处理函数是静态类函数，则记录其地址

在文件 ControlBase.h 第 89 行定义.

◆ m_isAlphaCalculated

bool HiEasyX::ControlBase::m_isAlphaCalculated = false

protected

画布是否已经计算透明混合颜色

在文件 ControlBase.h 第 72 行定义.

◆ m_listChild

std::list<ControlBase*> HiEasyX::ControlBase::m_listChild

protected

子控件

在文件 ControlBase.h 第 84 行定义.

◆ m_nBorderThickness

int HiEasyX::ControlBase::m_nBorderThickness = 1

protected

边框粗细

在文件 ControlBase.h 第 79 行定义.

◆ m_pCalledClass

void* HiEasyX::ControlBase::m_pCalledClass = nullptr

protected

若绑定的消息处理函数是静态类函数，则记录该类指针

在文件 ControlBase.h 第 90 行定义.

◆ m_pParent

ControlBase* HiEasyX::ControlBase::m_pParent = nullptr

protected

父控件

在文件 ControlBase.h 第 83 行定义.

◆ m_rctClear

RECT HiEasyX::ControlBase::m_rctClear = { 0 }

protected

记录需要清空的区域

在文件 ControlBase.h 第 64 行定义.

◆ m_wstrText

std::wstring HiEasyX::ControlBase::m_wstrText

protected

控件文本

在文件 ControlBase.h 第 67 行定义.

该类的文档由以下文件生成:

E:/_MYC/_VS_Project/HiEasyX/HiEasyX/HiEasyX/HiGUI/ControlBase.h
E:/_MYC/_VS_Project/HiEasyX/HiEasyX/HiEasyX/HiGUI/ControlBase.cpp

Public 成员函数

Protected 成员函数

Protected 属性

详细描述

构造及析构函数说明

◆ ControlBase() [1/3]

◆ ControlBase() [2/3]

◆ ControlBase() [3/3]

◆ ~ControlBase()

成员函数说明

◆ AddChild()

◆ CallUserMsgProcFunc()

◆ ChildRectChanged()

◆ Draw()

◆ Draw_Text()

◆ DrawChild()

◆ EnableAutoRedraw()

◆ EnableAutoSizeForChild()

◆ EnableBorder()

◆ GetAutoRedrawState()

◆ GetBkColor()

◆ GetCanvas()

◆ GetChildCount()

◆ GetChildList()

◆ GetParent()

◆ GetText()

◆ GetTextColor()

◆ IsAutoSizeForChild()

◆ IsEnabled()

◆ IsFocused()

◆ IsHovered()

◆ IsPressed()

◆ IsVisible()

◆ MarkNeedClearRect()

◆ MarkNeedRedrawAndRender()

◆ Redraw()

◆ RemoveChild()

◆ Render()

◆ SetAlpha()

◆ SetBkColor()

◆ SetEnable()

◆ SetMsgProcFunc() [1/2]

◆ SetMsgProcFunc() [2/2]

◆ SetParent()

◆ SetText()

◆ SetTextColor()

◆ SetVisible()

◆ TransformMessage()

◆ UpdateMessage()

◆ UpdateRect()

类成员变量说明

◆ m_alpha

◆ m_bAlwaysRedrawAndRender

◆ m_bAutoRedrawWhenReceiveMsg

◆ m_bAutoSizeForChild

◆ m_bClear

◆ m_bCompleteFirstSetRect

◆ m_bEnableBorder

◆ m_bEnabled

◆ m_bFocused

◆ m_bHovered

◆ m_bPressed

◆ m_bRedraw

◆ m_bRender

◆ m_bUseCanvasAlpha

◆ m_bVisible

◆ m_canvas

◆ m_cBackground

◆ m_cBorder

◆ m_cText

◆ m_funcMessageProc

◆ m_funcMessageProc_Class

◆ m_isAlphaCalculated

◆ m_listChild

◆ m_nBorderThickness

◆ m_pCalledClass

◆ m_pParent

◆ m_rctClear

◆ m_wstrText