Library Functions Manual

NAME¶

DialogBoxModule - DialogBoxModule

SYNOPSIS¶

Classes¶

class kdk::KAboutDialog
关于对话框，支持两种样式，一种是无特定说明的，另一种是有特定说明的。 class kdk::KDialog
继承自 QDialog，支持响应式主题背景切换和图标主题切换、标题颜色响应窗口激活状态 class kdk::KInputDialog
输入对话框，接口与 QInputDialog 相同。 class kdk::KProgressDialog
进度对话框，会实时显示当前进度 class kdk::KUninstallDialog
卸载对话框，当用户卸载时可能会弹出此提示对话框

Enumerations¶

enum InputDialogOption { NoButtons = 0x00000001, UseListViewForComboBoxItems = 0x00000002, UsePlainTextEditForTextInput = 0x00000004 }
enum InputMode { TextInput, IntInput, DoubleInput }
enum kdk::BarType { ScrollBar, NothingBar, NormalBar, SpeedBar }
支持三种样式

Functions¶

kdk::KAboutDialog::KAboutDialog (QWidget *parent=nullptr, const QIcon &appIcon=QIcon(), const QString &appName='', const QString &appVersion='', const QString &appInfo='')
void kdk::KAboutDialog::setAppIcon (const QIcon &icon)
设置应用程序图标 void kdk::KAboutDialog::setAppName (const QString &appName)
设置应用程序名称 QString kdk::KAboutDialog::appName ()
获取应用程序名称 void kdk::KAboutDialog::setAppVersion (const QString &appVersion)
设置应用程序版本号 QString kdk::KAboutDialog::appVersion ()
获取应用程序版本号 void kdk::KAboutDialog::setBodyText (const QString &bodyText)
设置具体的说明内容 QString kdk::KAboutDialog::bodyText ()
获取具体的说明内容 void kdk::KAboutDialog::setAppSupport (const QString &appSupport)
设置服务与支持邮箱，有默认缺省 QString kdk::KAboutDialog::appSupport ()
获取服务与支持邮箱 void kdk::KAboutDialog::setBodyTextVisiable (bool flag)
设置是否显示说明内容,应设计要求，1.2.0.9中不再显示说明内容 void kdk::KAboutDialog::setAppPrivacyLabelVisible (bool flag)
设置隐私按钮是否可见 bool kdk::KAboutDialog::AppPrivacyLabelIsVisible ()
返回隐私按钮是否可见 void kdk::KAboutDialog::changeTheme () override
void kdk::KAboutDialog::paintEvent (QPaintEvent *paintEvent) override
kdk::KDialog::KDialog (QWidget *parent=nullptr)
void kdk::KDialog::setWindowIcon (const QIcon &icon)
设置对话框图标 void kdk::KDialog::setWindowIcon (const QString &iconName)
设置对话框图标 void kdk::KDialog::setWindowTitle (const QString &)
设置对话框标题名称 QPushButton * kdk::KDialog::maximumButton ()
获取最大化按钮 QPushButton * kdk::KDialog::minimumButton ()
获取最小化按钮 QPushButton * kdk::KDialog::closeButton ()
获取关闭按钮 KMenuButton * kdk::KDialog::menuButton ()
获取下拉菜单按钮 QWidget * kdk::KDialog::mainWidget ()
获取主内容区Widget KWindowButtonBar * kdk::KDialog::windowButtonBar ()
windowButtonBar KIconBar * kdk::KDialog::iconBar ()
iconBar bool kdk::KDialog::eventFilter (QObject *target, QEvent *event) override
void kdk::KDialog::changeTheme ()
void kdk::KDialog::changeIconStyle ()
QBoxLayout * kdk::KDialog::mainLayout ()
kdk::KInputDialog::KInputDialog (QWidget *parent=nullptr)
void kdk::KInputDialog::setInputMode (InputMode mode)
设置输入模式 InputMode kdk::KInputDialog::inputMode () const
返回输入模式 void kdk::KInputDialog::setLabelText (const QString &text)
设置提示信息 QString kdk::KInputDialog::labelText () const
获取提示信息 void kdk::KInputDialog::setOption (InputDialogOption option, bool on=true)
设置option类型 bool kdk::KInputDialog::testOption (InputDialogOption option) const
返回是否设置了option类型 void kdk::KInputDialog::setOptions (InputDialogOptions options)
设置options类型 InputDialogOptions kdk::KInputDialog::options () const
返回options类型 void kdk::KInputDialog::setTextValue (const QString &text)
设置文本值 QString kdk::KInputDialog::textValue () const
获取当前文本值 void kdk::KInputDialog::setTextEchoMode (QLineEdit::EchoMode mode)
设置保存文本值的回声模式 QLineEdit::EchoMode QLineEdit::EchoMode kdk::KInputDialog::textEchoMode () const
返回保存文本值的回声模式 void kdk::KInputDialog::setComboBoxEditable (bool editable)
设置输入对话框中使用的组合框是否可编辑 bool kdk::KInputDialog::isComboBoxEditable () const
返回输入对话框中使用的组合框是否可编辑 void kdk::KInputDialog::setComboBoxItems (const QStringList &items)
设置输入对话框组合框中使用的项目 QStringList kdk::KInputDialog::comboBoxItems () const
返回输入对话框组合框中使用的项目 void kdk::KInputDialog::setIntValue (int value)
设置int类型值 int kdk::KInputDialog::intValue () const
获取int类型值 void kdk::KInputDialog::setIntMinimum (int min)
设置int类型最小值 int kdk::KInputDialog::intMinimum () const
获取int类型最小值 void kdk::KInputDialog::setIntMaximum (int max)
设置int类型最大值 int kdk::KInputDialog::intMaximum () const
获取int类型最大值 void kdk::KInputDialog::setIntRange (int min, int max)
设置int类型值范围 void kdk::KInputDialog::setIntStep (int step)
设置步长 int kdk::KInputDialog::intStep () const
获取int类型步长 void kdk::KInputDialog::setDoubleValue (double value)
设置double类型值 double kdk::KInputDialog::doubleValue () const
获取double类型值 void kdk::KInputDialog::setDoubleMinimum (double min)
设置double类型最小值 double kdk::KInputDialog::doubleMinimum () const
获取double类型最小值 void kdk::KInputDialog::setDoubleMaximum (double max)
设置double类型最大值 double kdk::KInputDialog::doubleMaximum () const
获取double类型最大值 void kdk::KInputDialog::setDoubleRange (double min, double max)
设置double类型值范围 void kdk::KInputDialog::setDoubleDecimals (int decimals)
以小数为单位设置双自旋盒的精度 int kdk::KInputDialog::doubleDecimals () const
获取双自旋盒的精度 void kdk::KInputDialog::setOkButtonText (const QString &text)
设置OK按钮的文本 QString kdk::KInputDialog::okButtonText () const
获取OK按钮的文本 void kdk::KInputDialog::setCancelButtonText (const QString &text)
设置cancel按钮的文本 QString kdk::KInputDialog::cancelButtonText () const
获取cancel按钮的文本 void kdk::KInputDialog::open (QObject *receiver, const char *member)
将对话框显示为窗口模式对话框，并立即返回。 QSize kdk::KInputDialog::minimumSizeHint () const override
获取部件的推荐最小尺寸 QSize kdk::KInputDialog::sizeHint () const override
获取保存部件的推荐尺寸 void kdk::KInputDialog::setVisible (bool visible) override
设置窗口部件是否可见 QString kdk::KInputDialog::placeholderText () const
获取背景提示文本 void kdk::KInputDialog::setPlaceholderText (const QString &)
设置背景提示文本 static QString kdk::KInputDialog::getText (QWidget *parent, const QString &label, QLineEdit::EchoMode echo=QLineEdit::Normal, const QString &text=QString(), bool *ok=nullptr, Qt::WindowFlags flags=Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints=Qt::ImhNone)
静态便利函数，用于从用户处获取单行字符串。 static QString kdk::KInputDialog::getMultiLineText (QWidget *parent, const QString &label, const QString &text=QString(), bool *ok=nullptr, Qt::WindowFlags flags=Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints=Qt::ImhNone)
静态便利函数，用于从用户处获取多行字符串。 static QString kdk::KInputDialog::getItem (QWidget *parent, const QString &label, const QStringList &items, int current=0, bool editable=true, bool *ok=nullptr, Qt::WindowFlags flags=Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints=Qt::ImhNone)
静态便利函数，用于让用户从字符串列表中选择一个项目。 static int kdk::KInputDialog::getInt (QWidget *parent, const QString &label, int value=0, int minValue=-2147483647, int maxValue=2147483647, int step=1, bool *ok=nullptr, Qt::WindowFlags flags=Qt::WindowFlags())
静态便利函数，用于从用户处获取整数输入值。 static double kdk::KInputDialog::getDouble (QWidget *parent, const QString &label, double value=0, double minValue=-2147483647, double maxValue=2147483647, int decimals=1, bool *ok=nullptr, Qt::WindowFlags flags=Qt::WindowFlags())
静态便利函数，用于从用户处获取浮点数。 void kdk::KInputDialog::setDoubleStep (double step)
设置doubel类型步长 double kdk::KInputDialog::doubleStep () const
获取doubel类型步长 void kdk::KInputDialog::done (int result) override
void kdk::KInputDialog::changeTheme ()
kdk::KProgressDialog::KProgressDialog (QWidget *parent=nullptr)
kdk::KProgressDialog::KProgressDialog (const QString &labelText, const QString &cancelButtonText='cancel', int minimum=0, int maximum=100, QWidget *parent=nullptr)
void kdk::KProgressDialog::setLabel (QLabel *label)
设置提示文字 void kdk::KProgressDialog::setCancelButton (QPushButton *button)
设置取消按钮 void kdk::KProgressDialog::setBar (QProgressBar *bar)
设置进度条 void kdk::KProgressDialog::setSuffix (const QString &suffix)
设置detail的后缀 void kdk::KProgressDialog::setSuffix (const QString &numerator, const QString &denominator)
void kdk::KProgressDialog::setSpeed (const float &speed)
void kdk::KProgressDialog::setShowDetail (bool flag)
设置是否显示详细信息 int kdk::KProgressDialog::minimum () const
返回最小值 int kdk::KProgressDialog::maximum () const
返回最大值 int kdk::KProgressDialog::value () const
返回当前值 QString kdk::KProgressDialog::labelText () const
返回提示内容 void kdk::KProgressDialog::setAutoReset (bool reset)
设置自动重置 bool kdk::KProgressDialog::autoReset () const
返回是否自动重置 void kdk::KProgressDialog::setAutoClose (bool close)
设置是否自动关闭对话框 bool kdk::KProgressDialog::autoClose () const
返回是否自动关闭对话框 QProgressBar * kdk::KProgressDialog::progressBar ()
获取进度条 void kdk::KProgressDialog::setBarType (const BarType &type)
void kdk::KProgressDialog::addButton (QPushButton *button)
void kdk::KProgressDialog::removeButton (QPushButton *button)
BarType kdk::KProgressDialog::myType ()
void kdk::KProgressDialog::changeTheme ()
kdk::KUninstallDialog::KUninstallDialog (QString appName, QString appVersion, QWidget *parent=nullptr)
QLabel * kdk::KUninstallDialog::debAppNameLabel ()
debAppNameLabel QLabel * kdk::KUninstallDialog::debNameLabel ()
包名Label QLabel * kdk::KUninstallDialog::debIconLabel ()
包IconLabel QLabel * kdk::KUninstallDialog::debVersionLabel ()
包版本Label QPushButton * kdk::KUninstallDialog::uninstallButtton ()
卸载按钮 void kdk::KUninstallDialog::changeTheme ()

Signals¶

void kdk::KInputDialog::textValueChanged (const QString &text)
void kdk::KInputDialog::textValueSelected (const QString &text)
void kdk::KInputDialog::intValueChanged (int value)
void kdk::KInputDialog::intValueSelected (int value)
void kdk::KInputDialog::doubleValueChanged (double value)
void kdk::KInputDialog::doubleValueSelected (double value)
void kdk::KProgressDialog::canceled ()

Public Slots¶

void kdk::KProgressDialog::cancel ()
取消进度条 void kdk::KProgressDialog::reset ()
重置进度条 void kdk::KProgressDialog::setMaximum (int maximum)
设置最大值 void kdk::KProgressDialog::setMinimum (int minimum)
设置最小值 void kdk::KProgressDialog::setRange (int minimum, int maximum)
设置范围 void kdk::KProgressDialog::setValue (int progress)
设置当前值 void kdk::KProgressDialog::setLabelText (const QString &text)
设置提示内容 void kdk::KProgressDialog::setCancelButtonText (const QString &text)
设置取消按钮内容 void kdk::KProgressDialog::setSubContent (const QString &text)
设置次级内容

Detailed Description¶

{

Enumeration Type Documentation¶

enum kdk::BarType¶

支持三种样式

Since

1.0.0

Function Documentation¶

QString kdk::KAboutDialog::appName ()¶

获取应用程序名称

Returns

bool kdk::KAboutDialog::AppPrivacyLabelIsVisible ()¶

返回隐私按钮是否可见

Returns

返回输入对话框组合框中使用的项目

Returns

QStringList

QLabel * kdk::KUninstallDialog::debAppNameLabel ()¶

debAppNameLabel

Returns

QLabel * kdk::KUninstallDialog::debIconLabel ()¶

包IconLabel

Returns

QLabel * kdk::KUninstallDialog::debNameLabel ()¶

包名Label

Returns

获取部件的推荐最小尺寸

Returns

QSize

QString kdk::KInputDialog::okButtonText () const¶

1.2.0

void kdk::KAboutDialog::setAppSupport (const QString & appSupport)¶

设置服务与支持邮箱，有默认缺省

Parameters

appSupport

void kdk::KAboutDialog::setAppVersion (const QString & appVersion)¶

设置应用程序版本号

Parameters

appVersion

void kdk::KProgressDialog::setAutoClose (bool close)¶

设置是否自动关闭对话框

Parameters

close

void kdk::KProgressDialog::setAutoReset (bool reset)¶

设置自动重置

设置是否显示详细信息

Parameters

flag

Examples
testprogressdialog/widget.cpp.

void kdk::KProgressDialog::setSuffix (const QString & suffix)¶

设置detail的后缀

Parameters

suffix

Examples
testprogressdialog/widget.cpp.

void kdk::KInputDialog::setTextEchoMode (QLineEdit::EchoMode mode)¶

设置保存文本值的回声模式 QLineEdit::EchoMode

Parameters

mode

void kdk::KInputDialog::setTextValue (const QString & text)¶

设置文本值

Parameters

text

void kdk::KInputDialog::setVisible (bool visible) [override]¶

设置窗口部件是否可见

Parameters

visible

QString kdk::KInputDialog::textValue () const¶

获取当前文本值

Returns

QString

QPushButton * kdk::KUninstallDialog::uninstallButtton ()¶

卸载按钮

Returns

int kdk::KProgressDialog::value () const¶

返回当前值

Returns

KWindowButtonBar * kdk::KDialog::windowButtonBar ()¶

windowButtonBar

Generated automatically by Doxygen for LIBKYSDK-APPLICATIONS from the source code.

Version version:3.0

LIBKYSDK-APPLICATIONS

Source file:	DialogBoxModule.3.en.gz (from libkysdk-applications-dev 3.0.1.1-1+b1)
Source last updated:	2026-03-20T20:25:36Z
Converted to HTML:	2026-03-21T02:48:40Z