table of contents
| kdk::KMessageBox(3) | Library Functions Manual | kdk::KMessageBox(3) |
NAME¶
kdk::KMessageBox - 继承自KDialog,提供一个可自定义设置按钮和图标的对话框,类似QMessageBox
SYNOPSIS¶
#include <kmessagebox.h>
Inherits kdk::KDialog.
Public Types¶
enum Icon { NoIcon = 0, Information = 1,
Warning = 2, Critical = 3, Question = 4 }
The Icon
enum,icon的五种类型,与
QMessageDialogOptions::Icon 保持同步 enum
ButtonRole { InvalidRole = -1, AcceptRole,
RejectRole, DestructiveRole, ActionRole,
HelpRole, YesRole, NoRole, ResetRole,
ApplyRole, NRoles }
The ButtonRole
enum,可供设置的按钮role.
enum StandardButton { NoButton = 0x00000000, Ok =
0x00000400, Save = 0x00000800, SaveAll = 0x00001000,
Open = 0x00002000, Yes = 0x00004000, YesToAll =
0x00008000, No = 0x00010000, NoToAll = 0x00020000,
Abort = 0x00040000, Retry = 0x00080000, Ignore =
0x00100000, Close = 0x00200000, Cancel = 0x00400000,
Discard = 0x00800000, Help = 0x01000000, Apply =
0x02000000, Reset = 0x04000000, RestoreDefaults = 0x08000000,
FirstButton = Ok, LastButton = RestoreDefaults, YesAll
= YesToAll, NoAll = NoToAll, Default = 0x00000100,
Escape = 0x00000200, FlagMask = 0x00000300, ButtonMask
= ~FlagMask }
The StandardButton
enum,可供添加的按钮类型,与
QDialogButtonBox::StandardButton 和
QPlatformDialogHelper::StandardButton 保持同步
typedef StandardButton Button
Signals¶
void buttonClicked (QAbstractButton *button)
Public Member Functions¶
KMessageBox (QWidget *parent=nullptr)
void setCustomIcon (const QIcon &icon)
自定义KMessageBox的提示图标
void addButton (QAbstractButton *button, ButtonRole
role)
添加一个自定义按钮
QPushButton * addButton (const QString &text,
ButtonRole role)
添加设置好文本的按钮
QPushButton * addButton (StandardButton button)
添加一个标准按钮并且返回这个按钮
void removeButton (QAbstractButton *button)
移除一个按钮 QAbstractButton *
button (StandardButton which) const
返回与标准按钮对应的指针,如果此消息框中不存在标准按钮,则返回0。
QList< QAbstractButton * > buttons () const
返回已添加到消息框中的所有按钮的列表
KMessageBox::ButtonRole buttonRole (QAbstractButton
*button) const
返回指定按钮的按钮角色,如果按钮为0或尚未添加到消息框中,此函数将返回InvalidRole
QCheckBox * checkBox () const
返回KMessageBox中显示的复选框
void setCheckBox (QCheckBox *cb)
设置KMessageBox显示的复选框,未设置则为0
QString text () const
获取KMessageBox的文本 void setText (const
QString &text)
设置KMessageBox的文本 QString
informativeText () const
获取KMessageBox信息性文本的描述
void setInformativeText (const QString &text)
设置KMessageBox信息性文本的描述
Icon icon () const
获取KMessageBox的图标 void setIcon
(Icon icon)
设置KMessageBox的图标 QPixmap iconPixmap
() const
返回当前KMessageBox的icon void
setIconPixmap (const QPixmap &pixmap)
设置当前KMessageBox的icon
KMessageBox::StandardButtons standardButtons () const
KMessageBox中标准按钮的集合
void setStandardButtons (KMessageBox::StandardButtons buttons)
设置多个标准按钮
KMessageBox::StandardButton standardButton (QAbstractButton
*button) const
返回与给定按钮对应的标准按钮枚举值,如果给定按钮不是标准按钮,则返回NoButton
QPushButton * defaultButton () const
返回KMessageBox的默认按钮 void
setDefaultButton (QPushButton *button)
设置KMessageBox的默认按钮 void
setDefaultButton (KMessageBox::StandardButton button)
设置KMessageBox的默认按钮
QAbstractButton * clickedButton () const
返回被点击的按钮 QLabel *
informativeLabel ()
返回informativeLabel
Public Member Functions inherited from kdk::KDialog
KDialog (QWidget *parent=nullptr)
void setWindowIcon (const QIcon &icon)
设置对话框图标 void
setWindowIcon (const QString &iconName)
设置对话框图标 void
setWindowTitle (const QString &)
设置对话框标题名称
QPushButton * maximumButton ()
获取最大化按钮 QPushButton *
minimumButton ()
获取最小化按钮 QPushButton *
closeButton ()
获取关闭按钮 KMenuButton *
menuButton ()
获取下拉菜单按钮 QWidget *
mainWidget ()
获取主内容区Widget KWindowButtonBar
* windowButtonBar ()
windowButtonBar KIconBar * iconBar ()
iconBar
Static Public Member Functions¶
static QPixmap standardIcon (Icon icon)
返回用于标准图标的pixmap。
static StandardButton information (QWidget *parent, const
QString &title, const QString &text, StandardButtons
buttons=Ok, StandardButton defaultButton=NoButton)
打开带有给定标题和文本的信息消息框。对话框最多可以有三个按钮
static StandardButton question (QWidget *parent, const QString
&title, const QString &text, StandardButtons
buttons=StandardButtons(Yes|No), StandardButton
defaultButton=NoButton)
打开一个带有给定标题和文本的问题消息框
static StandardButton warning (QWidget *parent, const QString
&title, const QString &text, StandardButtons
buttons=Ok, StandardButton defaultButton=NoButton)
打开一个带有给定标题和文本的警告消息框
static StandardButton critical (QWidget *parent, const QString
&title, const QString &text, StandardButtons
buttons=Ok, StandardButton defaultButton=NoButton)
用给定的标题和文本打开一个关键信息框
static StandardButton success (QWidget *parent, const QString
&title, const QString &text, StandardButtons
buttons=Ok, StandardButton defaultButton=NoButton)
用给定的标题和文本打开一个成功消息框
Protected Member Functions¶
bool event (QEvent *e) override
Protected Member Functions inherited from kdk::KDialog
bool eventFilter (QObject *target, QEvent *event) override
void changeTheme ()
void changeIconStyle ()
QBoxLayout * mainLayout ()
Detailed Description¶
继承自KDialog,提供一个可自定义设置按钮和图标的对话框,类似QMessageBox
Since
Member Function Documentation¶
QPushButton * kdk::KMessageBox::addButton (const QString & text, ButtonRole role)¶
添加设置好文本的按钮
Parameters
role
Returns
void kdk::KMessageBox::addButton (QAbstractButton * button, ButtonRole role)¶
添加一个自定义按钮
Parameters
role
QPushButton * kdk::KMessageBox::addButton (StandardButton button)¶
添加一个标准按钮并且返回这个按钮
Parameters
Returns
QAbstractButton * kdk::KMessageBox::button (StandardButton which) const¶
返回与标准按钮对应的指针,如果此消息框中不存在标准按钮,则返回0。
Parameters
Returns
KMessageBox::ButtonRole kdk::KMessageBox::buttonRole (QAbstractButton * button) const¶
返回指定按钮的按钮角色,如果按钮为0或尚未添加到消息框中,此函数将返回InvalidRole
Parameters
Returns
QList< QAbstractButton * > kdk::KMessageBox::buttons () const¶
返回已添加到消息框中的所有按钮的列表
Returns
QCheckBox * kdk::KMessageBox::checkBox () const¶
返回KMessageBox中显示的复选框
Returns
QAbstractButton * kdk::KMessageBox::clickedButton () const¶
返回被点击的按钮
Returns
static StandardButton kdk::KMessageBox::critical (QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton) [static]¶
用给定的标题和文本打开一个关键信息框
Parameters
title
text
buttons
defaultButton
Returns
QPushButton * kdk::KMessageBox::defaultButton () const¶
返回KMessageBox的默认按钮
Returns
Icon kdk::KMessageBox::icon () const¶
获取KMessageBox的图标
Returns
QPixmap kdk::KMessageBox::iconPixmap () const¶
返回当前KMessageBox的icon
Returns
static StandardButton kdk::KMessageBox::information (QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton) [static]¶
打开带有给定标题和文本的信息消息框。对话框最多可以有三个按钮
Parameters
title
text
buttons
defaultButton
Returns
QLabel * kdk::KMessageBox::informativeLabel ()¶
返回informativeLabel
Returns
Since
QString kdk::KMessageBox::informativeText () const¶
获取KMessageBox信息性文本的描述
Returns
static StandardButton kdk::KMessageBox::question (QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = StandardButtons(Yes|No), StandardButton defaultButton = NoButton) [static]¶
打开一个带有给定标题和文本的问题消息框
Parameters
title
text
buttons
defaultButton
Returns
void kdk::KMessageBox::removeButton (QAbstractButton * button)¶
移除一个按钮
Parameters
void kdk::KMessageBox::setCheckBox (QCheckBox * cb)¶
设置KMessageBox显示的复选框,未设置则为0
Parameters
void kdk::KMessageBox::setCustomIcon (const QIcon & icon)¶
自定义KMessageBox的提示图标
Parameters
void kdk::KMessageBox::setDefaultButton (KMessageBox::StandardButton button)¶
设置KMessageBox的默认按钮
Parameters
void kdk::KMessageBox::setDefaultButton (QPushButton * button)¶
设置KMessageBox的默认按钮
Parameters
void kdk::KMessageBox::setIcon (Icon icon)¶
设置KMessageBox的图标
Parameters
void kdk::KMessageBox::setIconPixmap (const QPixmap & pixmap)¶
设置当前KMessageBox的icon
Parameters
void kdk::KMessageBox::setInformativeText (const QString & text)¶
设置KMessageBox信息性文本的描述
Parameters
void kdk::KMessageBox::setStandardButtons (KMessageBox::StandardButtons buttons)¶
设置多个标准按钮
Parameters
void kdk::KMessageBox::setText (const QString & text)¶
设置KMessageBox的文本
Parameters
KMessageBox::StandardButton kdk::KMessageBox::standardButton (QAbstractButton * button) const¶
返回与给定按钮对应的标准按钮枚举值,如果给定按钮不是标准按钮,则返回NoButton
Parameters
Returns
KMessageBox::StandardButtons kdk::KMessageBox::standardButtons () const¶
KMessageBox中标准按钮的集合
Returns
static QPixmap kdk::KMessageBox::standardIcon (Icon icon) [static]¶
返回用于标准图标的pixmap。
Parameters
Returns
static StandardButton kdk::KMessageBox::success (QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton) [static]¶
用给定的标题和文本打开一个成功消息框
Parameters
title
text
buttons
defaultButton
Returns
QString kdk::KMessageBox::text () const¶
获取KMessageBox的文本
Returns
static StandardButton kdk::KMessageBox::warning (QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton) [static]¶
打开一个带有给定标题和文本的警告消息框
Parameters
title
text
buttons
defaultButton
Returns
Author¶
Generated automatically by Doxygen for LIBKYSDK-APPLICATIONS from the source code.
| Version version:3.0 | LIBKYSDK-APPLICATIONS |