DialogBoxModule(3)

📦 version 3.0.1.2, in arch rolling, ubuntu resolute, ubuntu stonking

💖 DialogBoxModule(3) 💖

Library Functions Manual · DialogBoxModule


✨ NAME ✨

DialogBoxModule — bestie, it's literally DialogBoxModule. That's the whole name. Iconic of it. 🎀


🌸 SYNOPSIS 🌸

👑 Classes

  • class kdk::KAboutDialog — 关于对话框,支持两种样式,一种是无特定说明的,另一种是有特定说明的。

ok so this is the About dialog, and it comes in two flavors: one with no specific description, and one with a specific description. Two lewks, one dialog. Pick your vibe. 💅

  • class kdk::KDialog — 继承自 QDialog,支持响应式主题背景切换和图标主题切换、标题颜色响应窗口激活状态

it inherits from QDialog, and the way that it slays is: it supports responsive theme background switching and icon theme switching, plus the title colour reacts to whether the window is active or not. main character energy fr fr — the title knows when it's the center of attention. 👑

  • class kdk::KInputDialog — 输入对话框,接口与 QInputDialog 相同。

the input dialog, and no cap: its interface is the same as QInputDialog. Same API, new fit. 🦋

  • class kdk::KProgressDialog — 进度对话框,会实时显示当前进度

progress dialog! it shows you the current progress in real time, so you're never sitting there like "is it happening??" 😭 it's happening. you can see it happening. ✨

  • class kdk::KUninstallDialog — 卸载对话框,当用户卸载时可能会弹出此提示对话框

the uninstall dialog — when the user uninstalls, this lil prompt dialog may pop up. (may! not always! don't come for me, that's what it says.) 🫶


🔥 Enumerations

  • enum InputDialogOption — with these values, exactly:
enum InputDialogOption { NoButtons = 0x00000001,
    UseListViewForComboBoxItems = 0x00000002,
    UsePlainTextEditForTextInput = 0x00000004 }

look at those powers of two, they're giving flags energy. NoButtons is 0x00000001, UseListViewForComboBoxItems is 0x00000002, UsePlainTextEditForTextInput is 0x00000004. ⭐

  • enum InputMode — the modes are:
enum InputMode { TextInput, IntInput, DoubleInput }

so: text, int, or double. three little options, all valid, all gorgeous. 🌈

  • enum kdk::BarType — 支持三种样式
enum kdk::BarType { ScrollBar, NothingBar, NormalBar, SpeedBar }

and yeah, the note says it supports three styles — I'm just the messenger, the values are ScrollBar, NothingBar, NormalBar and SpeedBar, and I am not doing math on that. 🧚

lowkey obsessed with how many dialogs this one module is carrying. it's giving overachiever. and there's MORE coming — this was just part 1, so don't go anywhere. 💜

✨ Functions ✨

okay bestie, this is the big one — every single member function across all the dialog classes. buckle up, we're going class by class, and yes I kept all of them, no skipping, that's the whole vibe 💅


👑 kdk::KAboutDialog — the "about this app" glow-up

  • kdk::KAboutDialog::KAboutDialog (QWidget *parent=nullptr, const QIcon &appIcon=QIcon(), const QString &appName='', const QString &appVersion='', const QString &appInfo='') — the constructor, she's got defaults for everything: a parent widget, an app icon, an app name, an app version, and app info ✨
  • void kdk::KAboutDialog::setAppIcon (const QIcon &icon) — sets the app's icon 🎀
  • void kdk::KAboutDialog::setAppName (const QString &appName) — sets the app's name 💖
  • QString kdk::KAboutDialog::appName () — grabs the app's name back out
  • void kdk::KAboutDialog::setAppVersion (const QString &appVersion) — sets the app version number 🌸
  • QString kdk::KAboutDialog::appVersion () — grabs the app version number
  • void kdk::KAboutDialog::setBodyText (const QString &bodyText) — sets the actual body/description content
  • QString kdk::KAboutDialog::bodyText () — grabs the body/description content
  • void kdk::KAboutDialog::setAppSupport (const QString &appSupport) — sets the service & support email, and it comes with a default 💌
  • QString kdk::KAboutDialog::appSupport () — grabs the service & support email
  • void kdk::KAboutDialog::setBodyTextVisiable (bool flag) — sets whether the body/description content is shown. per design requirements, as of 1.2.0.9 the body content is no longer displayed, so heads up on that one 🙈
  • void kdk::KAboutDialog::setAppPrivacyLabelVisible (bool flag) — sets whether the privacy button is visible 🔒
  • bool kdk::KAboutDialog::AppPrivacyLabelIsVisible () — returns whether the privacy button is visible
  • void kdk::KAboutDialog::changeTheme () override — theme-swap time, overridden 🌈
  • void kdk::KAboutDialog::paintEvent (QPaintEvent *paintEvent) override — the paint event, overridden 🎨

🪟 kdk::KDialog — the base dialog, the main character

  • kdk::KDialog::KDialog (QWidget *parent=nullptr) — constructor, takes an optional parent widget
  • void kdk::KDialog::setWindowIcon (const QIcon &icon) — sets the dialog's icon 🎀
  • void kdk::KDialog::setWindowIcon (const QString &iconName) — also sets the dialog's icon, but from a name this time ✨
  • void kdk::KDialog::setWindowTitle (const QString &) — sets the dialog's title name 👑
  • QPushButton * kdk::KDialog::maximumButton () — grabs the maximize button
  • QPushButton * kdk::KDialog::minimumButton () — grabs the minimize button
  • QPushButton * kdk::KDialog::closeButton () — grabs the close button
  • KMenuButton * kdk::KDialog::menuButton () — grabs the dropdown menu button
  • QWidget * kdk::KDialog::mainWidget () — grabs the main content-area Widget
  • KWindowButtonBar * kdk::KDialog::windowButtonBar () — windowButtonBar
  • KIconBar * kdk::KDialog::iconBar () — iconBar
  • bool kdk::KDialog::eventFilter (QObject *target, QEvent *event) override — the event filter, overridden 🫶
  • void kdk::KDialog::changeTheme () — swap the theme 🌈
  • void kdk::KDialog::changeIconStyle () — swap the icon style 💅
  • QBoxLayout * kdk::KDialog::mainLayout () — the main layout, right there for ya

💬 kdk::KInputDialog — she asks the questions

  • kdk::KInputDialog::KInputDialog (QWidget *parent=nullptr) — constructor, optional parent widget
  • void kdk::KInputDialog::setInputMode (InputMode mode) — sets the input mode
  • InputMode kdk::KInputDialog::inputMode () const — returns the input mode
  • void kdk::KInputDialog::setLabelText (const QString &text) — sets the prompt/label text
  • QString kdk::KInputDialog::labelText () const — grabs the prompt/label text
  • void kdk::KInputDialog::setOption (InputDialogOption option, bool on=true) — sets an option type
  • bool kdk::KInputDialog::testOption (InputDialogOption option) const — returns whether that option type is set
  • void kdk::KInputDialog::setOptions (InputDialogOptions options) — sets the options
  • InputDialogOptions kdk::KInputDialog::options () const — returns the options
  • void kdk::KInputDialog::setTextValue (const QString &text) — sets the text value
  • QString kdk::KInputDialog::textValue () const — grabs the current text value
  • void kdk::KInputDialog::setTextEchoMode (QLineEdit::EchoMode mode) — sets the echo mode for the stored text value, a QLineEdit::EchoMode 🙈
  • QLineEdit::EchoMode kdk::KInputDialog::textEchoMode () const — returns the echo mode for the stored text value
  • void kdk::KInputDialog::setComboBoxEditable (bool editable) — sets whether the combo box used in the input dialog is editable
  • bool kdk::KInputDialog::isComboBoxEditable () const — returns whether the combo box used in the input dialog is editable
  • void kdk::KInputDialog::setComboBoxItems (const QStringList &items) — sets the items used in the input dialog's combo box
  • QStringList kdk::KInputDialog::comboBoxItems () const — returns the items used in the input dialog's combo box
  • void kdk::KInputDialog::setIntValue (int value) — sets the int value
  • int kdk::KInputDialog::intValue () const — grabs the int value
  • void kdk::KInputDialog::setIntMinimum (int min) — sets the int minimum
  • int kdk::KInputDialog::intMinimum () const — grabs the int minimum
  • void kdk::KInputDialog::setIntMaximum (int max) — sets the int maximum
  • int kdk::KInputDialog::intMaximum () const — grabs the int maximum
  • void kdk::KInputDialog::setIntRange (int min, int max) — sets the int value range
  • void kdk::KInputDialog::setIntStep (int step) — sets the step
  • int kdk::KInputDialog::intStep () const — grabs the int step
  • void kdk::KInputDialog::setDoubleValue (double value) — sets the double value
  • double kdk::KInputDialog::doubleValue () const — grabs the double value
  • void kdk::KInputDialog::setDoubleMinimum (double min) — sets the double minimum
  • double kdk::KInputDialog::doubleMinimum () const — grabs the double minimum
  • void kdk::KInputDialog::setDoubleMaximum (double max) — sets the double maximum
  • double kdk::KInputDialog::doubleMaximum () const — grabs the double maximum
  • void kdk::KInputDialog::setDoubleRange (double min, double max) — sets the double value range
  • void kdk::KInputDialog::setDoubleDecimals (int decimals) — sets the precision of the double spin box, in units of decimals 🔢
  • int kdk::KInputDialog::doubleDecimals () const — grabs the precision of the double spin box
  • void kdk::KInputDialog::setOkButtonText (const QString &text) — sets the OK button's text
  • QString kdk::KInputDialog::okButtonText () const — grabs the OK button's text
  • void kdk::KInputDialog::setCancelButtonText (const QString &text) — sets the cancel button's text
  • QString kdk::KInputDialog::cancelButtonText () const — grabs the cancel button's text
  • void kdk::KInputDialog::open (QObject *receiver, const char *member) — shows the dialog as a window-modal dialog and returns immediately 🏃‍♀️
  • QSize kdk::KInputDialog::minimumSizeHint () const override — grabs the widget's recommended minimum size, overridden
  • QSize kdk::KInputDialog::sizeHint () const override — grabs the widget's recommended size, overridden
  • void kdk::KInputDialog::setVisible (bool visible) override — sets whether the widget is visible, overridden 👀
  • QString kdk::KInputDialog::placeholderText () const — grabs the placeholder (background hint) text
  • void kdk::KInputDialog::setPlaceholderText (const QString &) — sets the placeholder (background hint) text
  • 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 convenience function for getting a single-line string from the user ⭐
  • 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 convenience function for getting a multi-line string from the user 📝
  • 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 convenience function that lets the user pick one item from a string list ✨
  • 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 convenience function for getting an integer input value from the user 🔢
  • 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 convenience function for getting a floating-point number from the user 🌊
  • void kdk::KInputDialog::setDoubleStep (double step) — sets the double step
  • double kdk::KInputDialog::doubleStep () const — grabs the double step
  • void kdk::KInputDialog::done (int result) override — the done handler, overridden ✅
  • void kdk::KInputDialog::changeTheme () — swap the theme 🌈

⏳ kdk::KProgressDialog — the "are we there yet" queen

  • kdk::KProgressDialog::KProgressDialog (QWidget *parent=nullptr) — constructor, optional parent widget
  • kdk::KProgressDialog::KProgressDialog (const QString &labelText, const QString &cancelButtonText='cancel', int minimum=0, int maximum=100, QWidget *parent=nullptr) — the fuller constructor: label text, cancel button text (defaults to 'cancel'), a minimum of 0, a maximum of 100, and an optional parent widget 🎀
  • void kdk::KProgressDialog::setLabel (QLabel *label) — sets the prompt text label
  • void kdk::KProgressDialog::setCancelButton (QPushButton *button) — sets the cancel button
  • void kdk::KProgressDialog::setBar (QProgressBar *bar) — sets the progress bar
  • void kdk::KProgressDialog::setSuffix (const QString &suffix) — sets the detail suffix
  • void kdk::KProgressDialog::setSuffix (const QString &numerator, const QString &denominator) — the two-arg suffix setter, numerator and denominator 🧮
  • void kdk::KProgressDialog::setSpeed (const float &speed) — sets the speed
  • void kdk::KProgressDialog::setShowDetail (bool flag) — sets whether the detailed info is shown
  • int kdk::KProgressDialog::minimum () const — returns the minimum value
  • int kdk::KProgressDialog::maximum () const — returns the maximum value
  • int kdk::KProgressDialog::value () const — returns the current value
  • QString kdk::KProgressDialog::labelText () const — returns the prompt content
  • void kdk::KProgressDialog::setAutoReset (bool reset) — sets auto-reset
  • bool kdk::KProgressDialog::autoReset () const — returns whether auto-reset is on
  • void kdk::KProgressDialog::setAutoClose (bool close) — sets whether the dialog auto-closes
  • bool kdk::KProgressDialog::autoClose () const — returns whether the dialog auto-closes
  • QProgressBar * kdk::KProgressDialog::progressBar () — grabs the progress bar
  • void kdk::KProgressDialog::setBarType (const BarType &type) — sets the bar type
  • void kdk::KProgressDialog::addButton (QPushButton *button) — adds a button
  • void kdk::KProgressDialog::removeButton (QPushButton *button) — removes a button
  • BarType kdk::KProgressDialog::myType () — returns the BarType
  • void kdk::KProgressDialog::changeTheme () — swap the theme 🌈

🗑️ kdk::KUninstallDialog — the goodbye era

  • kdk::KUninstallDialog::KUninstallDialog (QString appName, QString appVersion, QWidget *parent=nullptr) — constructor, takes an app name, an app version, and an optional parent widget
  • QLabel * kdk::KUninstallDialog::debAppNameLabel () — debAppNameLabel
  • QLabel * kdk::KUninstallDialog::debNameLabel () — the package-name Label 🏷️
  • QLabel * kdk::KUninstallDialog::debIconLabel () — the package-icon Label 🎀
  • QLabel * kdk::KUninstallDialog::debVersionLabel () — the package-version Label 🌸
  • QPushButton * kdk::KUninstallDialog::uninstallButtton () — the uninstall button (yes, that's spelled uninstallButtton, three t's, I don't make the rules bestie 🙈)
  • void kdk::KUninstallDialog::changeTheme () — swap the theme 🌈

and that's the whole function roster, no cap 🫶 next part's got more coming so don't go anywhere 💖

💫 Signals 💫

okay so these are the signals — the little "hey bestie something changed!!" broadcasts that this thing emits. 📣✨

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 ()

like. textValueChanged vs textValueSelected?? one is "you're typing", one is "you committed". the difference matters, iykyk. 💅


🎀 Public Slots 🎀

these are the slots, aka the lil buttons you can poke from outside, all on kdk::KProgressDialog:

  • void kdk::KProgressDialog::cancel () — 取消进度条 / cancels the progress bar 🛑
  • void kdk::KProgressDialog::reset () — 重置进度条 / resets the progress bar 🔄
  • void kdk::KProgressDialog::setMaximum (int maximum) — 设置最大值 / sets the maximum value ⬆️
  • void kdk::KProgressDialog::setMinimum (int minimum) — 设置最小值 / sets the minimum value ⬇️
  • void kdk::KProgressDialog::setRange (int minimum, int maximum) — 设置范围 / sets the range 📏
  • void kdk::KProgressDialog::setValue (int progress) — 设置当前值 / sets the current value 🎚️
  • void kdk::KProgressDialog::setLabelText (const QString &text) — 设置提示内容 / sets the prompt text 💬
  • void kdk::KProgressDialog::setCancelButtonText (const QString &text) — 设置取消按钮内容 / sets the cancel button's text 🔤
  • void kdk::KProgressDialog::setSubContent (const QString &text) — 设置次级内容 / sets the secondary content 🧁

🫧 Detailed Description 🫧

so the entire detailed description is this:

{

yeah. that's it. that's the whole thing. it's giving "submitted the assignment with only my name on it" 💀 iconic honestly


🌈 Enumeration Type Documentation 🌈

enum kdk::BarType

支持三种样式 — it supports three styles. 🎨✨

Since — 1.0.0


🔥 Function Documentation 🔥

buckle up bestie, this is the long part. every single one, no skips. 💖

QString kdk::KAboutDialog::appName ()

获取应用程序名称 — grabs the app name. 🏷️

Returns — the page just says Returns and then nothing 🙈

bool kdk::KAboutDialog::AppPrivacyLabelIsVisible ()

返回隐私按钮是否可见 — tells you whether the privacy button is visible or not. 👀

Returns — nope, blank 😭

Since — 1.2.0

QString kdk::KAboutDialog::appSupport ()

获取服务与支持邮箱 — grabs the service & support email. 📧

Returns — blank, bestie

QString kdk::KAboutDialog::appVersion ()

获取应用程序版本号 — grabs the application's version number. 🔢

Returns — blank again

bool kdk::KProgressDialog::autoClose () const

返回是否自动关闭对话框 — returns whether the dialog auto-closes. 🚪

Returns — blank

bool kdk::KProgressDialog::autoReset () const

返回是否自动重置 — returns whether it auto-resets. 🔁

Returns — blank

QString kdk::KAboutDialog::bodyText ()

获取具体的说明内容 — grabs the actual description body content. 📝

Returns — blank

QString kdk::KInputDialog::cancelButtonText () const

获取cancel按钮的文本 — grabs the text of the cancel button. ❌

Returns — blank

QPushButton * kdk::KDialog::closeButton ()

获取关闭按钮 — grabs the close button. ✖️

Returns — blank

QStringList kdk::KInputDialog::comboBoxItems () const

返回输入对话框组合框中使用的项目 — returns the items used in the input dialog's combo box. 📋

Returns — QStringList

QLabel * kdk::KUninstallDialog::debAppNameLabel ()

debAppNameLabel — yeah that's the entire description, it just says its own name 💀

Returns — blank

QLabel * kdk::KUninstallDialog::debIconLabel ()

包IconLabel — the package IconLabel. 🖼️

Returns — blank

QLabel * kdk::KUninstallDialog::debNameLabel ()

包名Label — the package name Label. 📦

Returns — blank

QLabel * kdk::KUninstallDialog::debVersionLabel ()

包版本Label — the package version Label. 🏷️

Returns — blank

int kdk::KInputDialog::doubleDecimals () const

获取双自旋盒的精度 — grabs the double spin box's precision. 🎯

Returns — int

double kdk::KInputDialog::doubleMaximum () const

获取double类型最大值 — grabs the double max. ⬆️

Returns — double

double kdk::KInputDialog::doubleMinimum () const

获取double类型最小值 — grabs the double min. ⬇️

Returns — double

double kdk::KInputDialog::doubleStep () const

获取doubel类型步长 — grabs the step size for doubel... yes that's a typo in the original, bestie, we're keeping it, no notes 💀

Returns — double

double kdk::KInputDialog::doubleValue () const

获取double类型值 — grabs the double value. 💫

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]

静态便利函数,用于从用户处获取浮点数。— a static convenience function for getting a floating-point number out of the user. 🎈

Parameters

  • parent
  • label
  • value
  • minValue
  • maxValue
  • decimals
  • ok
  • flags

Returns — blank 🙈

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]

静态便利函数,用于从用户处获取整数输入值。— static convenience function for getting an integer input from the user. 🔢

Parameters

  • parent
  • label
  • value
  • minValue
  • maxValue
  • step
  • ok
  • flags

Returns — blank

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]

静态便利函数,用于让用户从字符串列表中选择一个项目。— static convenience function that lets the user pick one item from a list of strings. 🍒

Parameters

  • parent
  • label
  • items
  • current
  • editable
  • ok
  • flags
  • inputMethodHints

Returns — blank

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]

静态便利函数,用于从用户处获取多行字符串。— static convenience function for getting a multi-line string out of the user. 📄

Parameters

  • parent
  • label
  • text
  • ok
  • flags
  • inputMethodHints

Returns — blank

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]

静态便利函数,用于从用户处获取单行字符串。— static convenience function for getting a single-line string out of the user. ✏️

Parameters

  • parent
  • label
  • echo
  • text
  • ok
  • flags
  • inputMethodHints

Returns — blank

KIconBar * kdk::KDialog::iconBar ()

iconBar — that's the description. it's just its own name again, the confidence 🫶

Returns — @2.5.2.0

InputMode kdk::KInputDialog::inputMode () const

返回输入模式 — returns the input mode. 🎛️

Returns — InputMode

int kdk::KInputDialog::intMaximum () const

获取int类型最大值 — grabs the int max. ⬆️

Returns — int

int kdk::KInputDialog::intMinimum () const

获取int类型最小值 — grabs the int min. ⬇️

Returns — int

int kdk::KInputDialog::intStep () const

获取int类型步长 — grabs the int step size. 👟

Returns — int

int kdk::KInputDialog::intValue () const

获取int类型值 — grabs the int value. 🔢

Returns — int

bool kdk::KInputDialog::isComboBoxEditable () const

返回输入对话框中使用的组合框是否可编辑 — returns whether the combo box used in the input dialog is editable. ✍️

Returns — bool

QString kdk::KInputDialog::labelText () const

获取提示信息 — grabs the prompt text. 💬

Returns — QString

QString kdk::KProgressDialog::labelText () const

返回提示内容 — returns the prompt content. 💬

Returns — blank

QWidget * kdk::KDialog::mainWidget ()

获取主内容区Widget — grabs the main content area Widget. 🖥️

Returns — blank

int kdk::KProgressDialog::maximum () const

返回最大值 — returns the max value. ⬆️

Returns — blank

QPushButton * kdk::KDialog::maximumButton ()

获取最大化按钮 — grabs the maximize button. 🔲

Returns — blank

KMenuButton * kdk::KDialog::menuButton ()

获取下拉菜单按钮 — grabs the dropdown menu button. 🔽

Returns — blank

int kdk::KProgressDialog::minimum () const

返回最小值 — returns the min value. ⬇️

Returns — blank

QPushButton * kdk::KDialog::minimumButton ()

获取最小化按钮 — grabs the minimize button. 🔽

Returns — blank

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

获取部件的推荐最小尺寸 — grabs the widget's recommended minimum size. 📐

Returns — QSize

QString kdk::KInputDialog::okButtonText () const

获取OK按钮的文本 — grabs the OK button's text. ✅

Returns — QString

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

将对话框显示为窗口模式对话框,并立即返回。— shows the dialog as a window-modal dialog, and returns immediately. 👋

Parameters

  • receiver
  • member

InputDialogOptions kdk::KInputDialog::options () const

返回options类型 — returns the options type. ⚙️

Returns — InputDialogOptions

QString kdk::KInputDialog::placeholderText () const

获取背景提示文本 — grabs the placeholder text. 🪧

Returns — blank

Since — 1.2.0

QProgressBar * kdk::KProgressDialog::progressBar ()

获取进度条 — grabs the progress bar. 📊

Returns — blank

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

设置应用程序图标 — sets the application icon. 🎨

Parameters

  • icon

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

设置应用程序名称 — sets the application name. 🏷️

Parameters

  • appName

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

设置隐私按钮是否可见 — sets whether the privacy button is visible. 👀

Parameters

  • flag

Since — 1.2.0

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

设置服务与支持邮箱,有默认缺省 — sets the service & support email, and it has a default. 📧

Parameters

  • appSupport

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

设置应用程序版本号 — sets the application version number. 🔢

Parameters

  • appVersion

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

设置是否自动关闭对话框 — sets whether the dialog auto-closes. 🚪

Parameters

  • close

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

设置自动重置 — sets auto-reset. 🔁

Parameters

  • reset

Examples — testprogressdialog/widget.cpp.

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

设置进度条 — sets the progress bar. 📊

Parameters

  • bar

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

设置具体的说明内容 — sets the actual body description content. 📝

Parameters

  • bodyText

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

设置是否显示说明内容,应设计要求,1.2.0.9中不再显示说明内容 — sets whether the description content is shown; per design requirements, the description content is no longer displayed as of 1.2.0.9.

Parameters

  • flag
⚠️ bestie listen — as of 1.2.0.9 the body text is not displayed anymore. it's giving deprecated-by-design 😭 don't build your whole UI around it.

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

设置取消按钮 — sets the cancel button. ❌

Parameters

  • button

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

设置cancel按钮的文本 — sets the text of the cancel button. 🔤

Parameters

  • text

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

设置输入对话框中使用的组合框是否可编辑 — sets whether the combo box used in the input dialog is editable. ✍️

Parameters

  • editable

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

设置输入对话框组合框中使用的项目 — sets the items used in the input dialog's combo box. 📋

Parameters

  • items

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

以小数为单位设置双自旋盒的精度 — sets the double spin box's precision, measured in decimal places. 🎯

Parameters

  • decimals

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

设置double类型最大值 — sets the double max. ⬆️

Parameters

  • max

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

设置double类型最小值 — sets the double min. ⬇️

Parameters

  • min

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

设置double类型值范围 — sets the double value range. 📏

Parameters

  • min
  • max

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

设置doubel类型步长 — sets the step size for doubel (their spelling, not mine 🫶). 👟

Parameters

  • step

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

设置double类型值 — sets the double value. 💫

Parameters

  • value

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

设置输入模式 — sets the input mode. 🎛️

Parameters

  • mode

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

设置int类型最大值 — sets the int max. ⬆️

Parameters

  • max

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

设置int类型最小值 — sets the int min. ⬇️

Parameters

  • min

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

设置int类型值范围 — sets the int value range. 📏

Parameters

  • min
  • max

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

设置步长 — sets the step size. 👟

Parameters

  • step

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

okay so this one sets the int type value, bestie. like, the number value. that's it, that's the whole vibe. 💅

Parameters

  • value

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

sets the little label widget that holds your hint text ✨

Parameters

  • label

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

sets the hint / label text. the little caption situation. you know the one. 🎀

Parameters

  • text

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

sets what the OK button says. make it say something iconic, the button is literally the main character 👑

Parameters

  • text

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

sets one single option, and on defaults to true so if you don't pass anything it's just... on. slay. ✨

Parameters

  • option
  • on

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

sets the whole options bundle at once. plural. all of them. group-chat energy fr fr 🌸

Parameters

  • options

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

sets the background placeholder text — the lil ghost text that lives in the box before you type anything 👻💜

Since 1.2.0


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

decides whether the detailed info shows up or not. flag on = details, flag off = mystery 🫣

Parameters

  • flag

Examples testprogressdialog/widget.cpp.


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

sets the suffix that goes on the detail. the lil tail on the end, you know 🎀

Parameters

  • suffix

Examples testprogressdialog/widget.cpp.


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

sets the echo mode for the stored text value — that's a QLineEdit::EchoMode, so like... whether it shows the text, hides it, dots it out, whatever 👀

Parameters

  • mode

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

sets the text value. yes bestie, the text one 💅

Parameters

  • text

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

sets whether the widget is visible or not. visible true = she's here, false = she's not 🦋

Parameters

  • visible

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

sets the dialog's icon, as a whole QIcon ✨

Parameters

  • icon

Examples testprogressdialog/widget.cpp.


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

same job, different door — this one takes the icon by name instead 🎀

Parameters

  • iconName

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

sets the dialog's title name — the text up top in the title bar 👑

ngl the parameter here is unnamed in the signature, but the docs list it as widgetName. that's just how she is. we don't question it.

Parameters

  • widgetName

Examples testprogressdialog/widget.cpp.


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

gets the recommended size for the widget. like a suggestion. the widget can still choose violence, but this is the hint 💅

Returns QSize


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

returns whether that option is set or not. a lil true/false check-in 🫶

Parameters

  • option

Returns bool


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

hands you back the echo mode of the stored text value ✨

Returns QLineEdit::EchoMode


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

gets the current text value. the now version. the real-time tea ☕💜

Returns QString


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

the uninstall button. that's her. that's the whole description 🎀

(yes the name is spelled uninstallButtton with three t's. that's not a typo i made, that's canon. copy it exactly, bestie, or your build will simply not know her.)

Returns QPushButton *


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

returns the current value. how far along we are. the progress tea 🔥

Returns int


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

windowButtonBar. that's literally all the docs say and honestly? respect. she said what she said 💅

Returns @2.5.2.0


🎀 Public Slots 🎀

the slots section, aka the stuff that's happy to be called by signals. lowkey the fun part 🦋


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

sets what the cancel button says 🚫

Parameters

  • text

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

sets the hint content 🌸

Parameters

  • text

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

sets the max value. the ceiling. the limit. periodt ✨

Parameters

  • maximum

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

sets the min value. the floor. the bare minimum, which we do not accept in life but do accept in dialogs 💅

Parameters

  • minimum

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

sets the range — both ends at once, minimum and maximum, one call, iconic 🌈

Parameters

  • minimum
  • maximum

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

sets the secondary content, the sub-content, the lil bonus text underneath 👑

Parameters

  • text

Examples testprogressdialog/widget.cpp.


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

sets the current value — the progress itself. move that bar, bestie 📈🔥

Parameters

  • progress

Examples testprogressdialog/widget.cpp.


🌟 Author 🌟

Generated automatically by Doxygen for LIBKYSDK-APPLICATIONS from the source code. she wasn't written by a human hand, she was summoned ✨🤖


and that's the whole page, bestie!! 🎉 this one came from LIBKYSDK-APPLICATIONS, version version:3.0, and it's the DialogBoxModule(3) manual — go forth and set your values, your ranges, your vibes 💖✨🎀🦋🌸💅🫶

📦 where this page comes from