跳转到主要内容

带边框的方框

TouchGFX中的带边框的方框是一种矩形形状的控件,可以为指定边框内包含的所有像素分配单一颜色,而边框的颜色和大小另行指定。 可以为带边框的方框指定任何大小和位置。

在模拟器中运行的带边框的方框

控件组

带边框的方框位于TouchGFX Designer中的“形状”控件组中。

TouchGFX Designer中的带边框的方框

属性

TouchGFX Designer中“带边框的方框”的属性。

属性组属性说明
名称控件的名称名称是TouchGFX Designer和代码中使用的唯一标识符
位置XY 指定控件左上角相对于其父的位置。

WH 指定控件的宽度和高度。

锁定指定控件是否应锁定为其当前的X、Y、W和H。
如果锁定控件,还会禁止通过屏幕与控件进行交互。

可见 指定控件的可见性。 如果将控件标记为不可见,还会禁止通过屏幕与控件进行交互。
外观颜色指定矩形中包含的所有像素的颜色。

边框颜色指定外边框的像素颜色。

边框大小指定外边框的大小。

Alpha指定控件的透明度。 控件的Alpha值介于0和255之间。 0表示完全透明,255表示不透明。
Mixin可拖动 指定在运行时控件是否可拖动。

ClickListener 指定控件被点击时是否会调用回调函数。

FadeAnimator 指定控件是否可绘制其 Alpha 值变化的动画。

MoveAnimator 指定控件是否可绘制 XY 值变化的动画。

交互

TouchGFX Designer中的“带边框的方框”支持的操作和触发条件。

动作

控件特有的动作说明
调整控件的尺寸调整控件的宽度和高度。
更改方框颜色更改“方框”控件的颜色。
标准控件动作说明
移动控件随时间的推移将控件移动到新位置。
渐隐控件随时间的推移改变控件的Alpha值。
隐藏控件隐藏控件(将可见性设置为false)。
显示控件使隐藏的控件可见(将可见性设置为true)。
调整控件的尺寸调整控件的宽度和高度。

触发

带边框的方框不会产生任何触发条件。

性能

带边框的方框是TouchGFX中最轻量级的控件之一,因为它不需要读取任何像素数据或进行任何复杂计算。 因此,大部分平台会将带边框的方框视为非常快速的控件。

更多关于绘图性能的信息,请阅读通用UI组件性能部分。

示例

生成代码

在生成的视图基类的代码中,可以查看TouchGFX Designer是如何设置带边框的方框的。

Screen1ViewBase.cpp
#include <gui_generated/screen1_screen/Screen1ViewBase.hpp>
#include <touchgfx/Color.hpp>

Screen1ViewBase::Screen1ViewBase()
{
boxWithBorderName.setPosition(240, 56, 337, 132);
boxWithBorderName.setColor(touchgfx::Color::getColorFrom24BitRGB(212, 27, 27));
boxWithBorderName.setBorderColor(touchgfx::Color::getColorFrom24BitRGB(21, 24, 202));
boxWithBorderName.setBorderSize(20);

add(boxWithBorderName);
}
Tip
- 可在用户代码中使用这些函数以及BoxWithBorder类中提供的其他函数。 如果更改控件的外观,请必须调用 boxWithBorderName.invalidate() 强制进行重新绘制。

API参考