特性介绍对话框，展示应用更新的新特性更多...

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

Public 成员函数
	DFeatureDisplayDialog (QWidget *parent=nullptr)
	特性介绍对话框的构造函数

	~DFeatureDisplayDialog () override
	特性介绍对话框的析构函数

void	setTitle (const QString &title)
	设置特性介绍对话框的主题

void	addItem (DFeatureItem *item)
	增加特性介绍对话框的特性项

void	removeItem (DFeatureItem *item)
	移除特性介绍对话框的特性项

void	addItems (QList< DFeatureItem * > items)
	增加多个特性介绍对话框的特性项

void	clearItems ()
	清除特性介绍对话框的所有特性项

void	setLinkButtonVisible (bool isVisible)
	设置链接按钮是否可见

void	setLinkUrl (const QString &url)
	设置链接按钮链接地址

void	show ()
	显示特性介绍对话框

bool	isEmpty () const
	假如特性介绍对话框没有特性项返回true，否则返回false

Public 成员函数继承自 Dtk::Widget::DDialog
	DDialog (QWidget *parent=nullptr)
	构造一个 DDialog 对话框

	DDialog (const QString &title, const QString &message, QWidget *parent=0)
	构造一个 DDialog 对话框

int	getButtonIndexByText (const QString &text) const
	通过按钮文字获取按钮下标

int	buttonCount () const
	获得对话框包含的按钮数量

int	contentCount () const
	获得对话框包含的所有内容控件的数量

QList< QAbstractButton * >	getButtons () const
	获得对话框的按钮列表

QList< QWidget * >	getContents () const
	获得对话框包含的所有内容控件列表

QAbstractButton *	getButton (int index) const
	获得指定下标所对应的按钮

QWidget *	getContent (int index) const
	获取指定下标对应的内容控件

QString	title () const
	返回对话框标题

QString	message () const
	返回对话框消息文本

QIcon	icon () const
	返回对话框图标

Qt::TextFormat	textFormat () const
	返回对话框的文本格式

bool	onButtonClickedClose () const
	检查在点击任何按钮后是否都会关闭对话框

void	setContentLayoutContentsMargins (const QMargins &margins)
	设定内容布局的内容 margin

QMargins	contentLayoutContentsMargins () const
	返回内容布局的边距.

bool	closeButtonVisible () const
	关闭按钮的可见属性.

Public 成员函数继承自 Dtk::Widget::DAbstractDialog
	DAbstractDialog (QWidget *parent=nullptr)
	构造一个DAbstractDialog实例

	DAbstractDialog (bool blurIfPossible, QWidget *parent=nullptr)
	构造一个 DAbstractDialog 实例

DisplayPosition	displayPosition () const

void	move (const QPoint &pos)
	将窗口移动到指定坐标

void	move (int x, int y)
	将窗口移动到指定坐标

void	setGeometry (const QRect &rect)
	构造一个矩形

void	setGeometry (int x, int y, int width, int height)

额外继承的成员函数
Public 类型继承自 Dtk::Widget::DDialog
enum	ButtonType { ButtonNormal , ButtonWarning , ButtonRecommend }
	表示按钮类型

Public 类型继承自 Dtk::Widget::DAbstractDialog
enum	DisplayPosition { Center , TopRight }
	对话框显示位置更多...

enum	DisplayPostion { DisplayCenter = Center , DisplayTopRight = TopRight }

Public 槽继承自 Dtk::Widget::DDialog
int	addButton (const QString &text, bool isDefault=false, ButtonType type=ButtonNormal)
	向对话框添加按钮

int	addButtons (const QStringList &text)
	向对话框添加按钮

void	insertButton (int index, const QString &text, bool isDefault=false, ButtonType type=ButtonNormal)
	向对话框插入按钮

void	insertButton (int index, QAbstractButton *button, bool isDefault=false)
	向对话框插入按钮

void	insertButtons (int index, const QStringList &text)
	向对话框插入按钮

void	removeButton (int index)
	从对话框移除按钮

void	removeButton (QAbstractButton *button)
	从对话框移除按钮

void	removeButtonByText (const QString &text)
	从对话框移除按钮

void	clearButtons ()
	清除所有按钮

bool	setDefaultButton (int index)
	设置默认按钮

bool	setDefaultButton (const QString &str)
	设置默认按钮

void	setDefaultButton (QAbstractButton *button)
	设置默认按钮

void	addContent (QWidget *widget, Qt::Alignment alignment={})
	添加控件到对话框内容布局.

void	insertContent (int index, QWidget *widget, Qt::Alignment alignment={})
	在对话框内容布局指定位置插入控件.

void	removeContent (QWidget *widget, bool isDelete=true)
	从对话框内容布局中移除指定控件

void	clearContents (bool isDelete=true)
	清空对话框内容布局中的所有内容.

void	setSpacing (int spacing)
	设置对话框内容间隔

void	addSpacing (int spacing)
	追加对话框内容间隔.

void	insertSpacing (int index, int spacing)
	插入对话框内容间隔

void	clearSpacing ()
	清除内容间隔

void	setButtonText (int index, const QString &text)
	设置按钮文字

void	setButtonIcon (int index, const QIcon &icon)
	设置按钮图标

void	setTitle (const QString &title)
	设置对话框标题

void	setWordWrapTitle (bool wordWrap)
	设定标题Label内容是否可截断换行

void	setMessage (const QString &message)
	设置对话框消息内容

void	setWordWrapMessage (bool wordWrap)
	设置对话框消息内容

void	setIcon (const QIcon &icon)
	设置对话框图标

void	setTextFormat (Qt::TextFormat textFormat)
	设置文字格式

void	setOnButtonClickedClose (bool onButtonClickedClose)
	设置是否在点击按钮后关闭对话框

void	setCloseButtonVisible (bool closeButtonVisible)
	设置关闭按钮的可见性

int	exec () Q_DECL_OVERRIDE
	以模态框形式显示当前对话框

Public 槽继承自 Dtk::Widget::DAbstractDialog
void	moveToCenter ()
	将对话框移动至屏幕中央或其父控件的中央

void	moveToTopRight ()
	将对话框移动至屏幕右上角或其父控件的右上角

void	moveToCenterByRect (const QRect &rect)
	移动对话框到给定`rect`区域的中央。`rect`是移动对话框要参照的`QRect`区域

void	moveToTopRightByRect (const QRect &rect)
	移动对话框到给定`rect`区域的右上角。`rect`是移动所需要参照的`QRect`位置。

void	setDisplayPosition (DisplayPosition displayPosition)
	设置对话框显示位置

信号继承自 Dtk::Widget::DDialog
void	aboutToClose ()

void	closed ()

void	buttonClicked (int index, const QString &text)

void	titleChanged (QString title)

void	messageChanged (QString massage)

void	textFormatChanged (Qt::TextFormat textFormat)

void	sizeChanged (QSize size)

void	visibleChanged (bool visible)

信号继承自 Dtk::Widget::DAbstractDialog
void	sizeChanged (QSize size)
	窗口大小发生改变

Protected 成员函数继承自 Dtk::Widget::DDialog
	DDialog (DDialogPrivate &dd, QWidget *parent=0)

void	showEvent (QShowEvent *event) Q_DECL_OVERRIDE

void	hideEvent (QHideEvent *event) Q_DECL_OVERRIDE

void	closeEvent (QCloseEvent *event) override

void	childEvent (QChildEvent *event) Q_DECL_OVERRIDE

void	resizeEvent (QResizeEvent *event) override

void	keyPressEvent (QKeyEvent *event) override

bool	eventFilter (QObject watched, QEvent event) override

void	changeEvent (QEvent *event) override

Protected 成员函数继承自 Dtk::Widget::DAbstractDialog
void	mouseMoveEvent (QMouseEvent *event) Q_DECL_OVERRIDE
	对话框的鼠标移动事件

void	mousePressEvent (QMouseEvent *event) Q_DECL_OVERRIDE
	对话框的鼠标点击事件

void	mouseReleaseEvent (QMouseEvent *event) Q_DECL_OVERRIDE
	对话框的鼠标释放事件

void	resizeEvent (QResizeEvent *event) Q_DECL_OVERRIDE
	窗口大小改变事件

void	showEvent (QShowEvent *event) override
	窗口显示事件,如果收到过鼠标移动事件不再使用自动布局

	DAbstractDialog (DAbstractDialogPrivate &dd, QWidget *parent=nullptr)

属性继承自 Dtk::Widget::DDialog
QString	title
	对话框标题属性

QString	message
	对话框消息属性

QIcon	icon
	对话框图标属性

Qt::TextFormat	textFormat
	对话框的文本格式属性

bool	onButtonClickedClose
	标志是否在点击按钮后关闭对话框的属性

bool	closeButtonVisible
	关闭按钮的可见属性

属性继承自 Dtk::Widget::DAbstractDialog
DisplayPosition	displayPosition
	获取对话框显示位置

详细描述

特性介绍对话框，展示应用更新的新特性

结果如下图

构造及析构函数说明

◆ DFeatureDisplayDialog()

Dtk::Widget::DFeatureDisplayDialog::DFeatureDisplayDialog ( QWidget * parent = nullptr )

explicit

特性介绍对话框的构造函数

参数

[in] parent 特性介绍对话框的父对象

成员函数说明

◆ addItem()

void Dtk::Widget::DFeatureDisplayDialog::addItem ( DFeatureItem * item )

增加特性介绍对话框的特性项

参数

[in] item 特性介绍对话框的特性项

◆ addItems()

void Dtk::Widget::DFeatureDisplayDialog::addItems ( QList< DFeatureItem * > items )

增加多个特性介绍对话框的特性项

参数

[in] items 特性介绍对话框的特性项列表

◆ isEmpty()

bool Dtk::Widget::DFeatureDisplayDialog::isEmpty ( ) const

假如特性介绍对话框没有特性项返回true，否则返回false

返回: 特性介绍对话框的内容是否为空

◆ removeItem()

void Dtk::Widget::DFeatureDisplayDialog::removeItem ( DFeatureItem * item )

移除特性介绍对话框的特性项

参数

[in] item 特性介绍对话框的特性项

◆ setLinkButtonVisible()

void Dtk::Widget::DFeatureDisplayDialog::setLinkButtonVisible ( bool isVisible )

设置链接按钮是否可见

参数

[in] isVisible 链接按钮是否可见

◆ setLinkUrl()

void Dtk::Widget::DFeatureDisplayDialog::setLinkUrl ( const QString & url )

设置链接按钮链接地址

参数

[in] url 链接按钮的链接地址

◆ setTitle()

void Dtk::Widget::DFeatureDisplayDialog::setTitle ( const QString & title )

设置特性介绍对话框的主题

参数

[in] title 特性介绍对话框的主题

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

include/widgets/dfeaturedisplaydialog.h
src/widgets/dfeaturedisplaydialog.cpp
docs/widgets/dfeaturedisplaydialog.zh_CN.dox

Public 成员函数

额外继承的成员函数

详细描述

构造及析构函数说明

◆ DFeatureDisplayDialog()

成员函数说明

◆ addItem()

◆ addItems()

◆ isEmpty()

◆ removeItem()

◆ setLinkButtonVisible()

◆ setLinkUrl()

◆ setTitle()