GFt::Widget::Label类 参考

文本标签控件 更多...

#include <Label.h>

类 GFt::Widget::Label 继承关系图:

Public 成员函数
	Label (const iRect &rect, Block *parent=nullptr, int zIndex=0)
	Label (const std::wstring &text, const iRect &rect, Block *parent=nullptr, int zIndex=0)
	构造函数
	~Label () override=default
int &	bottomPadding ()
	下边距
int	bottomPadding () const
BrushSet &	brushSet ()
	画刷集
const BrushSet &	brushSet () const
int &	leftPadding ()
	左边距
int	leftPadding () const
int &	rightPadding ()
	右边距
int	rightPadding () const
void	setPadding (int left, int right, int top, int bottom)
	设置边距
void	setPadding (int leftRight, int topBottom)
	设置边距
void	setPadding (int padding)
	设置边距
std::wstring &	text ()
	文本内容
const std::wstring &	text () const
int &	textAlignment ()
	文本对齐方式
int	textAlignment () const
TextSet &	textSet ()
	文本集
const TextSet &	textSet () const
int &	topPadding ()
	上边距
int	topPadding () const
Public 成员函数 继承自 GFt::Block
	Block (const iRect &rect, Block *parent=nullptr, int zIndex=0)
	构造函数
virtual	~Block ()
iPoint	absolutePosition () const
	计算相对于屏幕的绝对坐标
void	addChild (Block *child)
	添加子对象
Block *	getParent () const
	获取父对象
int	getZIndex () const
	获取层级
void	hide ()
	隐藏块对象
bool	isHide () const
	获取块当前是否被隐藏
iPoint	relativePosFrom (Block *block) const
	计算相对于指定对象的相对坐标
void	removeChild (Block *child)
	移除子对象
void	setParent (Block *parent)
	设置父对象
void	setZIndex (int zIndex)
	设置层级
void	show ()
	显示块对象
Public 成员函数 继承自 GFt::GraphInterface
	GraphInterface (iRect rect)
	构造函数
virtual	~GraphInterface ()
const iRect &	rect () const
void	setHeight (int height)
void	setPosition (const iPoint &pos)
void	setRect (const iRect &rect)
void	setSize (const iSize &size)
void	setWidth (int width)
void	setX (int x)
void	setY (int y)

Protected 成员函数
void	onDraw (Graphics &g) override
	此函数用于绘制内容
void	onMouseButtonPress (MouseButtonPressEvent *event) override
	此函数用于处理鼠标按钮按下事件
Protected 成员函数 继承自 GFt::Block
void	onKeyPress (KeyPressEvent *event) override
	此函数用于处理键盘按键按下事件
void	onKeyRelease (KeyReleaseEvent *event) override
	此函数用于处理键盘按键释放事件
void	onMouseButtonRelease (MouseButtonReleaseEvent *event) override
	此函数用于处理鼠标按钮释放事件
void	onMouseMove (MouseMoveEvent *event) override
	此函数用于处理鼠标移动事件
void	onMouseWheel (MouseWheelEvent *event) override
	此函数用于处理鼠标滚轮事件
void	onTextInput (TextInputEvent *event) override
	此函数用于处理文本输入事件
Protected 成员函数 继承自 GFt::GraphInterface
Protected 成员函数 继承自 GFt::MouseButtonPressEventMonitor
Protected 成员函数 继承自 GFt::MouseButtonReleaseEventMonitor
Protected 成员函数 继承自 GFt::MouseMoveEventMonitor
Protected 成员函数 继承自 GFt::MouseWheelEventMonitor
Protected 成员函数 继承自 GFt::KeyPressEventMonitor
Protected 成员函数 继承自 GFt::KeyReleaseEventMonitor
Protected 成员函数 继承自 GFt::TextInputEventMonitor

额外继承的成员函数
Public 属性 继承自 GFt::Block
Signal< Block * >	FocusOff
	当该对象失去焦点时触发该信号
Signal< Block * >	FocusOn
	当该对象获得焦点时触发该信号
Signal< Block * >	HoverOff
	当鼠标移开该对象时之上时触发该信号
Signal< Block * >	HoverOn
	当鼠标悬停该对象时之上时触发该信号
Signal< bool >	ViewChanged
	当该对象显示状态变化时触发该信号
Public 属性 继承自 GFt::GraphInterface
Signal< const iPoint & >	onPositionChanged
Signal< const iSize & >	onSizeChanged

详细描述

文本标签控件

构造及析构函数说明

Label() [1/2]

GFt::Widget::Label::Label	(	const std::wstring &	text,
		const iRect &	rect,
		Block *	parent = nullptr,
		int	zIndex = 0 )

构造函数

参数

text	文本内容
rect	位置大小
parent	父控件
zIndex	层级

Label() [2/2]

GFt::Widget::Label::Label	(	const iRect &	rect,
		Block *	parent = nullptr,
		int	zIndex = 0 )

~Label()

GFt::Widget::Label::~Label ( )

overridedefault

成员函数说明

bottomPadding() [1/2]

int & GFt::Widget::Label::bottomPadding

(

)

下边距

bottomPadding() [2/2]

int GFt::Widget::Label::bottomPadding

(

)

const

参见

bottomPadding()

brushSet() [1/2]

BrushSet & GFt::Widget::Label::brushSet

(

)

画刷集

brushSet() [2/2]

const BrushSet & GFt::Widget::Label::brushSet

(

)

const

参见

brushSet()

leftPadding() [1/2]

int & GFt::Widget::Label::leftPadding

(

)

左边距

leftPadding() [2/2]

int GFt::Widget::Label::leftPadding

(

)

const

参见

leftPadding()

onDraw()

void GFt::Widget::Label::onDraw ( Graphics & g )

overrideprotectedvirtual

此函数用于绘制内容

参数

g

绘图设备对象

此函数会在每一帧绘制时被调用, 用于绘制内容

注解

若启用了裁剪优化，且此对象所在位置不与父对象的区域存在交集, 则此函数不会被调用

由于此函数会在每帧渲染时调用，因而应尽量避免过多的计算、创建和销毁临时对象，以提高效率。

渲染帧时长(可通过 Application::getRenderTime() 获取)最好控制在16ms以内，否则会引发较为明显的卡顿

重载 GFt::Block .

onMouseButtonPress()

void GFt::Widget::Label::onMouseButtonPress ( MouseButtonPressEvent * event )

overrideprotectedvirtual

此函数用于处理鼠标按钮按下事件

此函数存在默认行为：当此对象被点击时捕获焦点

参数

event

鼠标按钮按下事件

注解

鼠标处理函数会依据鼠标位置进行事件的捕获决断, 并将事件传递给相应的对象进行处理

具体的决断逻辑为：从根节点开始，查找首个满足鼠标位置在其区域内的对象，以该对象 为根节点再次重复此操作，直到某个对象不存在满足条件的子对象，则将事件传递给该对 象进行处理。该对象处理后若冒泡行为未被阻止，则再向上冒泡(即向父对象传递事件)， 直到根节点。

鼠标事件处理示意图

重载 GFt::Block .

rightPadding() [1/2]

int & GFt::Widget::Label::rightPadding

(

)

右边距

rightPadding() [2/2]

int GFt::Widget::Label::rightPadding

(

)

const

参见

rightPadding()

setPadding() [1/3]

void GFt::Widget::Label::setPadding	(	int	left,
		int	right,
		int	top,
		int	bottom )

设置边距

参数

left	左边距
right	右边距
top	上边距
bottom	下边距

setPadding() [2/3]

void GFt::Widget::Label::setPadding	(	int	leftRight,
		int	topBottom )

设置边距

参数

leftRight	左右边距
topBottom	上下边距

setPadding() [3/3]

void GFt::Widget::Label::setPadding

(

int

padding

)

设置边距

参数

padding

统一设置边距

text() [1/2]

std::wstring & GFt::Widget::Label::text

(

)

文本内容

text() [2/2]

const std::wstring & GFt::Widget::Label::text

(

)

const

参见

text()

textAlignment() [1/2]

int & GFt::Widget::Label::textAlignment

(

)

文本对齐方式

textAlignment() [2/2]

int GFt::Widget::Label::textAlignment

(

)

const

参见

textAlignment()

textSet() [1/2]

TextSet & GFt::Widget::Label::textSet

(

)

文本集

textSet() [2/2]

const TextSet & GFt::Widget::Label::textSet

(

)

const

参见

textSet()

topPadding() [1/2]

int & GFt::Widget::Label::topPadding

(

)

上边距

topPadding() [2/2]

int GFt::Widget::Label::topPadding

(

)

const

参见

topPadding()