DSettingsWidgetFactory是一个用于构造Deepin风格的设置对话框的控件. 更多...

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

Public 类型
typedef QWidget *()	WidgetCreateHandler(QObject *)
	自定义的控件构建函数,一般接受一个 Dtk::Core::DSettingsOption 作为参数.

Public 成员函数
typedef	QPair (ItemCreateHandler)(QObject *)

	DSettingsWidgetFactory (QObject *parent=Q_NULLPTR)

void	registerWidget (const QString &viewType, std::function< WidgetCreateHandler > handler)
	DSettingsWidgetFactory::registerWidget 向Factory注册一种类型viewType。注册该类型后，可以通过在DSettings的DOption中，设置type为对应的viewType，这样Factory在构建viewType对应的控件时，会调用handler所指定的方法来构建.

void	registerWidget (const QString &viewType, std::function< ItemCreateHandler > handler)

QWidget *	createWidget (QPointer< DTK_CORE_NAMESPACE::DSettingsOption > option)
	DSettingsWidgetFactory::createWidget 创建一个option对应的配置控件，一般是需要自定义控件时使用，可以通过translateContext设置翻译上下文.

QWidget *	createWidget (const QByteArray &translateContext, QPointer< DTK_CORE_NAMESPACE::DSettingsOption > option)
	DSettingsWidgetFactory::createWidget 创建一个option对应的配置控件，一般是需要自定义控件时使用.

QPair< QWidget , QWidget >	createItem (QPointer< DTK_CORE_NAMESPACE::DSettingsOption > option) const

QPair< QWidget , QWidget >	createItem (const QByteArray &translateContext, QPointer< DTK_CORE_NAMESPACE::DSettingsOption > option) const

静态 Public 成员函数
static QPair< QWidget , QWidget >	createStandardItem (const QByteArray &translateContext, DTK_CORE_NAMESPACE::DSettingsOption option, QWidget rightWidget)
	DSettingsWidgetFactory::createTwoColumWidget 返回一个水平布局的控件，左边为option的名称标签，右边为设置的自定义控件rightWidget.

详细描述

DSettingsWidgetFactory是一个用于构造Deepin风格的设置对话框的控件.

\inmodule dtkwidget

对于每种控件，均由一个id和对应的构造函数来组成，DSettingsWidgetFactory内置了许多基础的控件，包括： checkbox/lineedit/combobox/spinbutton/buttongroup/radiogroup/slider等。

成员函数说明

◆ createStandardItem()

QPair< QWidget , QWidget > Dtk::Widget::DSettingsWidgetFactory::createStandardItem	(	const QByteArray &	translateContext,
		DTK_CORE_NAMESPACE::DSettingsOption *	option,
		QWidget *	rightWidget
	)

static

DSettingsWidgetFactory::createTwoColumWidget 返回一个水平布局的控件，左边为option的名称标签，右边为设置的自定义控件rightWidget.

option 设置项，包含改配置的名称 rightWidget 自定义控件

返回: 生成的水平布局配置项控件

参见: Dtk::Widget::DSettingsWidgetFactory::createTwoColumWidget(const QByteArray &translateContext, Dtk::Core::DSettingsOption *option, QWidget *rightWidget)

DSettingsWidgetFactory::createTwoColumWidget 返回一个水平布局的控件，左边为option的名称标签，右边为设置的自定义控件rightWidget, 可以通过translateContext设置翻译上下文.

translateContext 自定义的翻译上下文，参考 QCoreApplication::translate(); option 设置项，包含改配置的名称 rightWidget 自定义控件

返回: 生成的水平布局配置项控件

参见: Dtk::Widget::DSettingsWidgetFactory::createTwoColumWidget(Dtk::Core::DSettingsOption *option, QWidget *rightWidget)

◆ createWidget() [1/2]

QWidget * Dtk::Widget::DSettingsWidgetFactory::createWidget	(	const QByteArray &	translateContext,
		QPointer< DTK_CORE_NAMESPACE::DSettingsOption >	option
	)

DSettingsWidgetFactory::createWidget 创建一个option对应的配置控件，一般是需要自定义控件时使用.

translateContext 自定义的翻译上下文，参考 QCoreApplication::translate(); option 需要构建的配置项

返回: 根据option的type属性创建的配置控件

参见: Dtk::Widget::DSettingsWidgetFactory::createWidget(QPointer<Dtk::Core::DSettingsOption> option)

◆ createWidget() [2/2]

QWidget * Dtk::Widget::DSettingsWidgetFactory::createWidget ( QPointer< DTK_CORE_NAMESPACE::DSettingsOption > option )

DSettingsWidgetFactory::createWidget 创建一个option对应的配置控件，一般是需要自定义控件时使用，可以通过translateContext设置翻译上下文.

option 需要构建的配置项

返回: 根据option的type属性创建的配置控件

参见: Dtk::Widget::DSettingsWidgetFactory::createWidget(const QByteArray &translateContext, QPointer<Dtk::Core::DSettingsOption> option)

◆ registerWidget()

void Dtk::Widget::DSettingsWidgetFactory::registerWidget	(	const QString &	viewType,
		std::function< WidgetCreateHandler >	handler
	)

DSettingsWidgetFactory::registerWidget 向Factory注册一种类型viewType。注册该类型后，可以通过在DSettings的DOption中，设置type为对应的viewType，这样Factory在构建viewType对应的控件时，会调用handler所指定的方法来构建.

viewType 控件类型，建议为全局唯一的字符串，且不要和内部类型重复，参考 Dtk::Widget::DSettingsWidgetFactory handler 自定义的控件构建函数，参考 Dtk::Widget::DSettingsWidgetFactory::WidgetCreateHandler

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

include/widgets/dsettingswidgetfactory.h
src/widgets/dsettingswidgetfactory.cpp

Public 类型

Public 成员函数