DialogBoxModule(3)

NAME
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 }

  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
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::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::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

Function Documentation

  QString kdk::KAboutDialog::appName ()

获取应用程序名称

Returns

  bool kdk::KAboutDialog::AppPrivacyLabelIsVisible ()

返回隐私按钮是否可见

Returns

Since
    1.2

  QString kdk::KAboutDialog::appSupport ()

获取服务与支持邮箱

Returns

  QString kdk::KAboutDialog::appVersion ()

获取应用程序版本号

Returns

  bool kdk::KProgressDialog::autoClose () const

返回是否自动关闭对话框

Returns

  bool kdk::KProgressDialog::autoReset () const

返回是否自动重置

Returns

  QString kdk::KAboutDialog::bodyText ()

获取具体的说明内容

Returns

  QString kdk::KInputDialog::cancelButtonText () const

获取cancel按钮的文本

Returns

  QPushButton* kdk::KDialog::closeButton ()

获取关闭按钮

Returns

  QStringList kdk::KInputDialog::comboBoxItems () const

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

Returns
    QStringList

  QLabel* kdk::KUninstallDialog::debAppNameLabel ()

debAppNameLabel

Returns

  QLabel* kdk::KUninstallDialog::debIconLabel ()

包IconLabel

Returns

  QLabel* kdk::KUninstallDialog::debNameLabel ()

包名Label

Returns

  QLabel* kdk::KUninstallDialog::debVersionLabel ()

包版本Label

Returns

  int kdk::KInputDialog::doubleDecimals () const

获取双自旋盒的精度

Returns
    int

  double kdk::KInputDialog::doubleMaximum () const

获取double类型最大值

Returns
    double

  double kdk::KInputDialog::doubleMinimum () const

获取double类型最小值

Returns
    double

  double kdk::KInputDialog::doubleStep () const

获取doubel类型步长

Returns
    double

  double kdk::KInputDialog::doubleValue () const

获取double类型值

Returns
    double

  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()) [static]

静态便利函数，用于从用户处获取浮点数。

Parameters
    parent
    label
    value
    minValue
    maxValue
    decimals
    ok
    flags

Returns

  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]

静态便利函数，用于从用户处获取整数输入值。

Parameters
    parent
    label
    value
    minValue
    maxValue
    step
    ok
    flags

Returns

  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]

静态便利函数，用于让用户从字符串列表中选择一个项目。

Parameters
    parent
    label
    items
    current
    editable
    ok
    flags
    inputMethodHints

Returns

  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]

静态便利函数，用于从用户处获取多行字符串。

Parameters
    parent
    label
    text
    ok
    flags
    inputMethodHints

Returns

  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]

静态便利函数，用于从用户处获取单行字符串。

Parameters
    parent
    label
    echo
    text
    ok
    flags
    inputMethodHints

Returns

  InputMode kdk::KInputDialog::inputMode () const

返回输入模式

Returns
    InputMode

  int kdk::KInputDialog::intMaximum () const

获取int类型最大值

Returns
    int

  int kdk::KInputDialog::intMinimum () const

获取int类型最小值

Returns
    int

  int kdk::KInputDialog::intStep () const

获取int类型步长

Returns
    int

  int kdk::KInputDialog::intValue () const

获取int类型值

Returns
    int

  bool kdk::KInputDialog::isComboBoxEditable () const

返回输入对话框中使用的组合框是否可编辑

Returns
    bool

  QString kdk::KInputDialog::labelText () const

获取提示信息

Returns
    QString

  QString kdk::KProgressDialog::labelText () const

返回提示内容

Returns

  QWidget* kdk::KDialog::mainWidget ()

获取主内容区Widget

Returns

  int kdk::KProgressDialog::maximum () const

返回最大值

Returns

  QPushButton* kdk::KDialog::maximumButton ()

获取最大化按钮

Returns

  KMenuButton* kdk::KDialog::menuButton ()

获取下拉菜单按钮

Returns

  int kdk::KProgressDialog::minimum () const

返回最小值

Returns

  QPushButton* kdk::KDialog::minimumButton ()

获取最小化按钮

Returns

  QSize kdk::KInputDialog::minimumSizeHint () const [override]

获取部件的推荐最小尺寸

Returns
    QSize

  QString kdk::KInputDialog::okButtonText () const

获取OK按钮的文本

Returns
    QString

  void kdk::KInputDialog::open (QObject * receiver, const char * member)

将对话框显示为窗口模式对话框，并立即返回。

Parameters
    receiver
    member

  InputDialogOptions kdk::KInputDialog::options () const

返回options类型

Returns
    InputDialogOptions

  QString kdk::KInputDialog::placeholderText () const

获取背景提示文本

Returns

Since
    1.2

  QProgressBar* kdk::KProgressDialog::progressBar ()

获取进度条

Returns

  void kdk::KAboutDialog::setAppIcon (const QIcon & icon)

设置应用程序图标

Parameters
    icon

  void kdk::KAboutDialog::setAppName (const QString & appName)

设置应用程序名称

Parameters
    appName

  void kdk::KAboutDialog::setAppPrivacyLabelVisible (bool flag)

设置隐私按钮是否可见

Parameters
    flag

Since
    1.2

  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
    reset

Examples
testprogressdialog/widget.cpp.

  void kdk::KProgressDialog::setBar (QProgressBar * bar)

设置进度条

Parameters
    bar

  void kdk::KAboutDialog::setBodyText (const QString & bodyText)

设置具体的说明内容

Parameters
    bodyText

  void kdk::KAboutDialog::setBodyTextVisiable (bool flag)

设置是否显示说明内容,应设计要求，1.2.0.9中不再显示说明内容

Parameters
    flag

  void kdk::KProgressDialog::setCancelButton (QPushButton * button)

设置取消按钮

Parameters
    button

  void kdk::KInputDialog::setCancelButtonText (const QString & text)

设置cancel按钮的文本

Parameters
    text

  void kdk::KInputDialog::setComboBoxEditable (bool editable)

设置输入对话框中使用的组合框是否可编辑

Parameters
    editable

  void kdk::KInputDialog::setComboBoxItems (const QStringList & items)

设置输入对话框组合框中使用的项目

Parameters
    items

  void kdk::KInputDialog::setDoubleDecimals (int decimals)

以小数为单位设置双自旋盒的精度

Parameters
    decimals

  void kdk::KInputDialog::setDoubleMaximum (double max)

设置double类型最大值

Parameters
    max

  void kdk::KInputDialog::setDoubleMinimum (double min)

设置double类型最小值

Parameters
    min

  void kdk::KInputDialog::setDoubleRange (double min, double max)

设置double类型值范围

Parameters
    min
    max

  void kdk::KInputDialog::setDoubleStep (double step)

设置doubel类型步长

Parameters
    step

  void kdk::KInputDialog::setDoubleValue (double value)

设置double类型值

Parameters
    value

  void kdk::KInputDialog::setInputMode (InputMode mode)

设置输入模式

Parameters
    mode

  void kdk::KInputDialog::setIntMaximum (int max)

设置int类型最大值

Parameters
    max

  void kdk::KInputDialog::setIntMinimum (int min)

设置int类型最小值

Parameters
    min

  void kdk::KInputDialog::setIntRange (int min, int max)

设置int类型值范围

Parameters
    min
    max

  void kdk::KInputDialog::setIntStep (int step)

设置步长

Parameters
    step

  void kdk::KInputDialog::setIntValue (int value)

设置int类型值

Parameters
    value

  void kdk::KProgressDialog::setLabel (QLabel * label)

设置提示文字

Parameters
    label

  void kdk::KInputDialog::setLabelText (const QString & text)

设置提示信息

Parameters
    text

  void kdk::KInputDialog::setOkButtonText (const QString & text)

设置OK按钮的文本

Parameters
    text

  void kdk::KInputDialog::setOption (InputDialogOption option, bool on = true)

设置option类型

Parameters
    option
    on

  void kdk::KInputDialog::setOptions (InputDialogOptions options)

设置options类型

Parameters
    options

  void kdk::KInputDialog::setPlaceholderText (const QString &)

设置背景提示文本

Since
    1.2

  void kdk::KProgressDialog::setShowDetail (bool flag)

设置是否显示详细信息

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

  void kdk::KDialog::setWindowIcon (const QIcon & icon)

设置对话框图标

Parameters
    icon

Examples
testprogressdialog/widget.cpp.

  void kdk::KDialog::setWindowIcon (const QString & iconName)

设置对话框图标

Parameters
    iconName

  void kdk::KDialog::setWindowTitle (const QString &)

设置对话框标题名称

Parameters
    widgetName

Examples
testprogressdialog/widget.cpp.

  QSize kdk::KInputDialog::sizeHint () const [override]

获取保存部件的推荐尺寸

Returns

  bool kdk::KInputDialog::testOption (InputDialogOption option) const

返回是否设置了option类型

Parameters
    option

Returns
    bool

  QLineEdit::EchoMode kdk::KInputDialog::textEchoMode () const

返回保存文本值的回声模式

Returns
    QLineEdit::EchoMode

  QString kdk::KInputDialog::textValue () const

获取当前文本值

Returns
    QString

  QPushButton* kdk::KUninstallDialog::uninstallButtton ()

卸载按钮

Returns

  int kdk::KProgressDialog::value () const

返回当前值

Returns

Public Slots

  void kdk::KProgressDialog::setCancelButtonText (const QString & text) [slot]

设置取消按钮内容

Parameters
    text

  void kdk::KProgressDialog::setLabelText (const QString & text) [slot]

设置提示内容

Parameters
    text

  void kdk::KProgressDialog::setMaximum (int maximum) [slot]

设置最大值

Parameters
    maximum

  void kdk::KProgressDialog::setMinimum (int minimum) [slot]

设置最小值

Parameters
    minimum

  void kdk::KProgressDialog::setRange (int minimum, int maximum) [slot]

设置范围

Parameters
    minimum
    maximum

  void kdk::KProgressDialog::setSubContent (const QString & text) [slot]

设置次级内容

Parameters
    text

Examples
testprogressdialog/widget.cpp.

  void kdk::KProgressDialog::setValue (int progress) [slot]

设置当前值

Parameters
    progress

Examples
testprogressdialog/widget.cpp.

Author

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