Dtk::Widget::DBackgroundGroup类 参考

DBackgroundGroup提供了将布局控件改成圆角边框(将布局看成一个整体) 更多...

类 Dtk::Widget::DBackgroundGroup 继承关系图:

Public 槽
void	setItemMargins (QMargins itemMargins)
	设置控件在布局内的边距
void	setItemSpacing (int spacing)
	设置布局内控件间的距离
void	setUseWidgetBackground (bool useWidgetBackground)
	设置是否使用 QWidget 背景颜色,并发送 useWidgetBackgroundChanged 信号

信号
void	useWidgetBackgroundChanged (bool useWidgetBackground)

Public 成员函数
	DBackgroundGroup (QLayout *layout=nullptr, QWidget *parent=nullptr)
	DBackgroundGroup构造函数
QMargins	itemMargins () const
	返回控件在布局内的边距
bool	useWidgetBackground () const
	是否使用 QWidget 背景颜色
void	setLayout (QLayout *layout)
	设置布局
void	setBackgroundRole (QPalette::ColorRole role)
QPalette::ColorRole	backgroundRole () const

Protected 成员函数
void	paintEvent (QPaintEvent *event) override
bool	event (QEvent *event) override

属性
QMargins	itemMargins
bool	useWidgetBackground

详细描述

DBackgroundGroup提供了将布局控件改成圆角边框(将布局看成一个整体)

示例程序

通过一个简单的示例来了解如何使用 DBackgroundGroup 设置一个布局， 将页面分成两块，其中一块设置一个按钮，另一块使用 DBackgroundGroup 并在 DBackgroundGroup 中添加 控件。

CMakeLists.txt

cmake_minimum_required(VERSION 3.1.0) # 指定cmake最低版本
 
project(example1 VERSION 1.0.0 LANGUAGES CXX) # 指定项目名称, 版本, 语言 cxx就是c++
 
set(CMAKE_CXX_STANDARD 11) # 指定c++标准
set(CMAKE_CXX_STANDARD_REQUIRED ON) # 指定c++标准要求,至少为11以上
set(target example1) # 指定目标名称
 
set(CMAKE_AUTOMOC ON) # support qt moc # 支持qt moc
set(CMAKE_AUTORCC ON) # support qt resource file # 支持qt资源文件
set(CMAKE_AUTOUIC ON) # support qt ui file # 支持qt ui文件(非必须)
 
set(CMAKE_EXPORT_COMPILE_COMMANDS ON) # support clangd 支持 clangd
 
if (CMAKE_VERSION VERSION_LESS "3.7.0") # 如果cmake版本小于3.7.0
    set(CMAKE_INCLUDE_CURRENT_DIR ON) # 设置包含当前目录
endif()
 
find_package(Qt5 COMPONENTS Widgets REQUIRED) # 寻找Qt5组件Widgets
find_package(Qt5 COMPONENTS Gui  REQUIRED) # 寻找Qt5组件Gui
find_package(Dtk COMPONENTS Widget REQUIRED) # 寻找Dtk组件Widget
find_package(Dtk COMPONENTS Core REQUIRED) # 寻找Dtk组件Core
find_package(Dtk COMPONENTS Gui) # 寻找Dtk组件Gui
 
add_executable(example1     # 添加可执行文件
        main.cpp
)
 
target_link_libraries(example1 PRIVATE
    Qt5::Widgets
    Qt5::Gui
    dtkgui
    dtkcore
    dtkwidget
) # 链接库

main.cpp

#include <DApplication>
#include <DWidget>
#include <DBackgroundGroup>
#include <QVBoxLayout>
#include <QPushButton>
#include <QFrame>
 
DWIDGET_USE_NAMESPACE
 
int main(int argc, char *argv[]){
    DApplication app(argc, argv);
    DWidget win;
 
    //新建一个水平的主布局
    QHBoxLayout* mainlayout = new QHBoxLayout(&win);
    //在新建的主布局上添加一个按钮
    mainlayout->addWidget(new QPushButton("按钮"));
 
    //再新建一个水平布局
    QHBoxLayout *hlayout = new QHBoxLayout;
    
    //新建一个 DBackgroundGroup 组， 将布局 hlayout 放入组中
    DBackgroundGroup *group = new DBackgroundGroup(hlayout,&win);
    //将新建组添加到主布局中， 由于主布局上已有一个按钮，且为水平布局，这个 DBackgroundGroup 组会紧靠按钮右方
    mainlayout->addWidget(group);
    //给布局 hlayout 添加内容控件，此处为两个空QFrame
    hlayout->addWidget(new QFrame);
    hlayout->addWidget(new QFrame);
 
    win.resize(800,500);
    win.show();
    return app.exec();
}

依次使用以下命令编译并运行程序

cmake -B build
cmake --build build
./build/example1

程序运行效果如下

dbackgroundgroup_example

构造及析构函数说明

DBackgroundGroup()

DBackgroundGroup::DBackgroundGroup ( QLayout *  layout = nullptr, QWidget *  parent = nullptr  )

explicit

DBackgroundGroup构造函数

参数

[in]	layout	布局对象
[in]	parent	参数被发送到 QWidget 构造函数

成员函数说明

itemMargins()

QMargins DBackgroundGroup::itemMargins

(

)

const

返回控件在布局内的边距

返回

控件在布局内的边距

setItemMargins

void DBackgroundGroup::setItemMargins ( QMargins  itemMargins )

slot

设置控件在布局内的边距

参数

[in]

itemMargins

控件在布局内的边距

setItemSpacing

void DBackgroundGroup::setItemSpacing ( int  spacing )

slot

设置布局内控件间的距离

参数

[in]

spacing

距离

setLayout()

void DBackgroundGroup::setLayout

(

QLayout *

layout

)

设置布局

参数

[in]

layout

布局

setUseWidgetBackground

void DBackgroundGroup::setUseWidgetBackground ( bool  useWidgetBackground )

slot

设置是否使用 QWidget 背景颜色,并发送 useWidgetBackgroundChanged 信号

参数

[in]

useWidgetBackground

是否使用 QWidget 背景颜色

useWidgetBackground()

bool DBackgroundGroup::useWidgetBackground

(

)

const

是否使用 QWidget 背景颜色

返回

是否使用 QWidget 背景颜色

---

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

• include/widgets/dbackgroundgroup.h
• src/widgets/dbackgroundgroup.cpp
• docs/widgets/dbackgroundgroup.zh_CN.dox