# QInputDialog Class Reference ## [[QtGui](index.htm) module] 該QInputDialog類提供了一個簡單方便的對話框，從用戶得到一個單一的值。[More...](#details) 繼承[QDialog](qdialog.html)。 ### Types * `enum InputDialogOption { NoButtons, UseListViewForComboBoxItems }` * `class **[InputDialogOptions](index.htm)**` * `enum InputMode { TextInput, IntInput, DoubleInput }` ### Methods * `__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0)` * `QString cancelButtonText (self)` * `QStringList comboBoxItems (self)` * `done (self, int?result)` * `int doubleDecimals (self)` * `float doubleMaximum (self)` * `float doubleMinimum (self)` * `float doubleValue (self)` * `InputMode inputMode (self)` * `int intMaximum (self)` * `int intMinimum (self)` * `int intStep (self)` * `int intValue (self)` * `bool isComboBoxEditable (self)` * `QString labelText (self)` * `QSize minimumSizeHint (self)` * `QString okButtonText (self)` * `open (self)` * `open (self, QObject?receiver, SLOT()SLOT()?member)` * `open (self, callable?receiver)` * `InputDialogOptions options (self)` * `setCancelButtonText (self, QString?text)` * `setComboBoxEditable (self, bool?editable)` * `setComboBoxItems (self, QStringList?items)` * `setDoubleDecimals (self, int?decimals)` * `setDoubleMaximum (self, float?max)` * `setDoubleMinimum (self, float?min)` * `setDoubleRange (self, float?min, float?max)` * `setDoubleValue (self, float?value)` * `setInputMode (self, InputMode?mode)` * `setIntMaximum (self, int?max)` * `setIntMinimum (self, int?min)` * `setIntRange (self, int?min, int?max)` * `setIntStep (self, int?step)` * `setIntValue (self, int?value)` * `setLabelText (self, QString?text)` * `setOkButtonText (self, QString?text)` * `setOption (self, InputDialogOption?option, bool?on?=?True)` * `setOptions (self, InputDialogOptions?options)` * `setTextEchoMode (self, QLineEdit.EchoMode?mode)` * `setTextValue (self, QString?text)` * `setVisible (self, bool?visible)` * `QSize sizeHint (self)` * `bool testOption (self, InputDialogOption?option)` * `QLineEdit.EchoMode textEchoMode (self)` * `QString textValue (self)` ### Static Methods * `(float, bool?ok) getDouble (QWidget?parent, QString?title, QString?label, float?value?=?0, float?min?=?-2147483647, float?max?=?2147483647, int?decimals?=?1, Qt.WindowFlags?flags?=?0)` * `(int, bool?ok) getInt (QWidget?parent, QString?title, QString?label, int?value?=?0, int?min?=?-2147483647, int?max?=?2147483647, int?step?=?1, Qt.WindowFlags?flags?=?0)` * `(int, bool?ok) getInteger (QWidget?parent, QString?title, QString?label, int?value?=?0, int?min?=?-2147483647, int?max?=?2147483647, int?step?=?1, Qt.WindowFlags?flags?=?0)` * `(QString, bool?ok) getItem (QWidget?parent, QString?title, QString?label, QStringList?list, int?current?=?0, bool?editable?=?True, Qt.WindowFlags?flags?=?0)` * `(QString, bool?ok) getItem (QWidget?parent, QString?title, QString?label, QStringList?list, int?current, bool?editable, Qt.WindowFlags?flags, Qt.InputMethodHints?inputMethodHints)` * `(QString, bool?ok) getText (QWidget?parent, QString?title, QString?label, QLineEdit.EchoMode?mode?=?QLineEdit.Normal, QString?text?=?QString(), Qt.WindowFlags?flags?=?0)` * `(QString, bool?ok) getText (QWidget?parent, QString?title, QString?label, QLineEdit.EchoMode?mode, QString?text, Qt.WindowFlags?flags, Qt.InputMethodHints?inputMethodHints)` ### Qt Signals * `void doubleValueChanged (double)` * `void doubleValueSelected (double)` * `void intValueChanged (int)` * `void intValueSelected (int)` * `void textValueChanged (const QString&)` * `void textValueSelected (const QString&)` * * * ## Detailed Description 該QInputDialog類提供了一個簡單方便的對話框，從用戶得到一個單一的值。 輸入值可以是一個字符串，一個數字或一個項目從一個列表中。一個標籤必須設置來告訴他們應該進入的用戶。 提供了四個靜態的便利功能：[getText](qinputdialog.html#getText)（ ）[getInt](qinputdialog.html#getInt)（ ）[getDouble](qinputdialog.html#getDouble)（）和[getItem](qinputdialog.html#getItem)（ ） 。所有的功能都可以以類似的方式被使用，例如： ``` bool ok; [QString](qstring.html) text = QInputDialog.getText(this, tr("QInputDialog.getText()"), tr("User name:"), [QLineEdit](qlineedit.html).Normal, [QDir](qdir.html).home().dirName(), &ok); if (ok && !text.isEmpty()) textLabel->setText(text); ``` 該`ok`變量被設置為True，如果用戶點擊**OK**否則它被設置為False 。  該[Standard Dialogs](index.htm)示例顯示了如何使用QInputDialog以及其他內置Qt對話框。 * * * ## Type Documentation ``` QInputDialog.InputDialogOption ``` 此枚舉指定影響的輸入對話框的外觀和感覺的各種選項。 | Constant | Value | Description | | --- | --- | --- | | `QInputDialog.NoButtons` | `0x00000001` | 不顯示**OK**和**Cancel**按鈕。 （有用的“現場對話” 。 ） | | `QInputDialog.UseListViewForComboBoxItems` | `0x00000002` | 使用[QListView](qlistview.html)而不是一個不可編輯[QComboBox](qcombobox.html)用于顯示設置的項[setComboBoxItems](qinputdialog.html#comboBoxItems-prop)（ ） 。 | 這個枚舉被引入或修改的Qt 4.5 。 該InputDialogOptions類型是一個typedef為[QFlags](index.htm)\u003cInputDialogOption\u003e 。它存儲InputDialogOption值的或組合。 **See also** [options](qinputdialog.html#options-prop)，[setOption](qinputdialog.html#setOption)（）和[testOption](qinputdialog.html#testOption)（ ） 。 ``` QInputDialog.InputMode ``` 該枚舉描述輸入的不同的模式，可以選擇對于該對話框。 | Constant | Value | Description | | --- | --- | --- | | `QInputDialog.TextInput` | `0` | 用于輸入文本字符串。 | | `QInputDialog.IntInput` | `1` | 用于輸入整數。 | | `QInputDialog.DoubleInput` | `2` | 用于輸入浮點數與雙精度的準確性。 | 這個枚舉被引入或修改的Qt 4.5 。 **See also** [inputMode](qinputdialog.html#inputMode-prop)。 * * * ## Method Documentation ``` QInputDialog.__init__ (self, QWidget?parent?=?None, Qt.WindowFlags?flags?=?0) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。 構造一個新的輸入對話框與給定_parent_和窗口_flags_。 此功能被引入Qt的4.5 。 ``` QString QInputDialog.cancelButtonText (self) ``` ``` QStringList QInputDialog.comboBoxItems (self) ``` ``` QInputDialog.done (self, int?result) ``` 從重新實現[QDialog.done](qdialog.html#done)（ ） 。 關閉對話框，并將其結果代碼_result_。如果顯示此對話框[exec_](qdialog.html#exec)（ ） ， （）完成將導致本地事件循環來完成，并[exec_](qdialog.html#exec)（ ）返回_result_。 **See also** [QDialog.done](qdialog.html#done)（ ） 。 ``` int QInputDialog.doubleDecimals (self) ``` ``` float QInputDialog.doubleMaximum (self) ``` ``` float QInputDialog.doubleMinimum (self) ``` ``` float QInputDialog.doubleValue (self) ``` ``` (float, bool?ok) QInputDialog.getDouble (QWidget?parent, QString?title, QString?label, float?value?=?0, float?min?=?-2147483647, float?max?=?2147483647, int?decimals?=?1, Qt.WindowFlags?flags?=?0) ``` 靜態方便的功能，從用戶得到一個浮點數。 _title_是顯示在對話框的標題欄中的文本。_label_是顯示給用戶的文本（它應該說些什么應該輸入） 。_value_是該行編輯將被設置為默認的浮點數。_min_和_max_是最低和最高值，用戶可以選擇。_decimals_是的小數位數可能會有的最大數量。 If _ok_非空， *_ok_將被設置為True，如果用戶按下**OK**并為False ，如果用戶按下**Cancel**。該對話框的父_parent_。該對話框將是模式，并使用小工具_flags_。 該函數返回已被用戶輸入的浮點數。 使用這個靜態函數是這樣的： ``` bool ok; double d = [QInputDialog](qinputdialog.html).getDouble(this, tr("QInputDialog.getDouble()"), tr("Amount:"), 37.56, -10000, 10000, 2, &ok); if (ok) doubleLabel->setText([QString](qstring.html)("$%1").arg(d)); ``` **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QInputDialog](qinputdialog.html)構造函數。 **See also** [getText](qinputdialog.html#getText)（ ）[getInt](qinputdialog.html#getInt)（）和[getItem](qinputdialog.html#getItem)（ ） 。 ``` (int, bool?ok) QInputDialog.getInt (QWidget?parent, QString?title, QString?label, int?value?=?0, int?min?=?-2147483647, int?max?=?2147483647, int?step?=?1, Qt.WindowFlags?flags?=?0) ``` 靜態方便的功能，從用戶得到的整數輸入。 _title_是顯示在對話框的標題欄中的文本。_label_是顯示給用戶的文本（它應該說些什么應該輸入） 。_value_是默認的整數，它的紡紗器將被設置。_min_和_max_是最低和最高值，用戶可以選擇。_step_是通過該值的變化作為用戶的數量按壓箭頭按鈕來遞增或遞減的值。 If _ok_非空*_ok_將被設置為True，如果用戶按下**OK**并為False ，如果用戶按下**Cancel**。該對話框的父_parent_。該對話框將是模式，并使用小工具_flags_。 如果成功，該函數返回已被用戶輸入的整數;失敗，返回初始_value_。 使用這個靜態函數是這樣的： ``` bool ok; int i = [QInputDialog](qinputdialog.html).getInt(this, tr("QInputDialog.getInteger()"), tr("Percentage:"), 25, 0, 100, 1, &ok); if (ok) integerLabel->setText(tr("%1%").arg(i)); ``` **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QInputDialog](qinputdialog.html)構造函數。 此功能被引入Qt的4.5 。 **See also** [getText](qinputdialog.html#getText)（ ）[getDouble](qinputdialog.html#getDouble)（）和[getItem](qinputdialog.html#getItem)（ ） 。 ``` (int, bool?ok) QInputDialog.getInteger (QWidget?parent, QString?title, QString?label, int?value?=?0, int?min?=?-2147483647, int?max?=?2147483647, int?step?=?1, Qt.WindowFlags?flags?=?0) ``` ``` (QString, bool?ok) QInputDialog.getItem (QWidget?parent, QString?title, QString?label, QStringList?list, int?current?=?0, bool?editable?=?True, Qt.WindowFlags?flags?=?0) ``` 靜態方便的功能，讓用戶從一個字符串列表中選擇一項。 _title_是顯示在對話框的標題欄中的文本。_label_是顯示給用戶的文本（它應該說些什么應該輸入） 。_items_是被插入到組合框的字符串列表。_current_是它應該是當前項的項的數目。_inputMethodHints_是輸入法的提示，如果ComboBox可編輯和輸入法被激活，將被使用。 If _editable_誠然，用戶可以輸入自己的文字，否則用戶只能選擇現有的項目之一。 If _ok_非空_*a_確定將被設置為True，如果用戶按下**OK**并為False ，如果用戶按下**Cancel**。該對話框的父_parent_。該對話框將是模式，并使用小工具_flags_。 這個函數返回當前項的文本，或者如果_editable_是真的，組合框的當前文本。 使用這個靜態函數是這樣的： ``` [QStringList](qstringlist.html) items; items << tr("Spring") << tr("Summer") << tr("Fall") << tr("Winter"); bool ok; [QString](qstring.html) item = [QInputDialog](qinputdialog.html).getItem(this, tr("QInputDialog.getItem()"), tr("Season:"), items, 0, false, &ok); if (ok && !item.isEmpty()) itemLabel->setText(item); ``` **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QInputDialog](qinputdialog.html)構造函數。 **See also** [getText](qinputdialog.html#getText)（ ）[getInt](qinputdialog.html#getInt)（）和[getDouble](qinputdialog.html#getDouble)（ ） 。 ``` (QString, bool?ok) QInputDialog.getItem (QWidget?parent, QString?title, QString?label, QStringList?list, int?current, bool?editable, Qt.WindowFlags?flags, Qt.InputMethodHints?inputMethodHints) ``` ``` (QString, bool?ok) QInputDialog.getText (QWidget?parent, QString?title, QString?label, QLineEdit.EchoMode?mode?=?QLineEdit.Normal, QString?text?=?QString(), Qt.WindowFlags?flags?=?0) ``` 靜態方便的功能，從用戶得到的字符串。 _title_是顯示在對話框的標題欄中的文本。_label_是顯示給用戶的文本（它應該說些什么應該輸入） 。_text_是這是擺在該行的編輯默認文本。_mode_是回波模式的行編輯將使用。_inputMethodHints_是輸入法的提示，將用于在編輯插件如果一個輸入法是活動的。 If _ok_非空_*a_確定將被設置為True，如果用戶按下**OK**并為False ，如果用戶按下**Cancel**。該對話框的父_parent_。該對話框將是模式，并使用指定部件_flags_。 如果接受了對話，這個函數返回在對話框的行編輯的文本。如果對話框被拒絕，空[QString](qstring.html)返回。 使用這個靜態函數是這樣的： ``` bool ok; [QString](qstring.html) text = [QInputDialog](qinputdialog.html).getText(this, tr("QInputDialog.getText()"), tr("User name:"), [QLineEdit](qlineedit.html).Normal, [QDir](qdir.html).home().dirName(), &ok); if (ok && !text.isEmpty()) textLabel->setText(text); ``` **Warning:**不要刪除_parent_在該對話框的執行。如果你想這樣做，你應該用一個自己創建的對話框[QInputDialog](qinputdialog.html)構造函數。 **See also** [getInt](qinputdialog.html#getInt)（ ）[getDouble](qinputdialog.html#getDouble)（）和[getItem](qinputdialog.html#getItem)（ ） 。 ``` (QString, bool?ok) QInputDialog.getText (QWidget?parent, QString?title, QString?label, QLineEdit.EchoMode?mode, QString?text, Qt.WindowFlags?flags, Qt.InputMethodHints?inputMethodHints) ``` ``` InputMode QInputDialog.inputMode (self) ``` [ ``` int QInputDialog.intMaximum (self) ``` ``` int QInputDialog.intMinimum (self) ``` ``` int QInputDialog.intStep (self) ``` ``` int QInputDialog.intValue (self) ``` ``` bool QInputDialog.isComboBoxEditable (self) ``` ``` QString QInputDialog.labelText (self) ``` ](qinputdialog.html#InputMode-enum) ``` QSize QInputDialog.minimumSizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.minimumSizeHint](qwidget.html#minimumSizeHint-prop)（ ） 。 ``` QString QInputDialog.okButtonText (self) ``` ``` QInputDialog.open (self) ``` 這是一個重載函數。 此功能連接它的信號之一，由指定的插槽_receiver_和_member_。具體的信號取決于在指定的參數_member_。它們是： * [textValueSelected](qinputdialog.html#textValueSelected)() if _member_ has a [QString](qstring.html) for its first argument. * [intValueSelected](qinputdialog.html#intValueSelected)() if _member_ has an int for its first argument. * [doubleValueSelected](qinputdialog.html#doubleValueSelected)() if _member_ has a double for its first argument. * [accepted](qdialog.html#accepted)() if _member_ has NO arguments. 該信號會從插槽中斷開時，關閉對話框。 此功能被引入Qt的4.5 。 ``` QInputDialog.open (self, QObject?receiver, SLOT()SLOT()?member) ``` ``` QInputDialog.open (self, callable?receiver) ``` ``` InputDialogOptions QInputDialog.options (self) ``` [ ``` QInputDialog.setCancelButtonText (self, QString?text) ``` ``` QInputDialog.setComboBoxEditable (self, bool?editable) ``` ``` QInputDialog.setComboBoxItems (self, QStringList?items) ``` ``` QInputDialog.setDoubleDecimals (self, int?decimals) ``` ``` QInputDialog.setDoubleMaximum (self, float?max) ``` ``` QInputDialog.setDoubleMinimum (self, float?min) ``` ``` QInputDialog.setDoubleRange (self, float?min, float?max) ``` ](index.htm) [設置在使用時，通過該對話框接受雙精度浮點值的范圍](index.htm)[DoubleInput](qinputdialog.html#InputMode-enum)模式，以最小的和由規定的最大數值_min_和_max_分別。 ``` QInputDialog.setDoubleValue (self, float?value) ``` ``` QInputDialog.setInputMode (self, InputMode?mode) ``` ``` QInputDialog.setIntMaximum (self, int?max) ``` ``` QInputDialog.setIntMinimum (self, int?min) ``` ``` QInputDialog.setIntRange (self, int?min, int?max) ``` 設置在使用時，通過該對話框接受整數的值的范圍[IntInput](qinputdialog.html#InputMode-enum)模式，以最小的和由規定的最大數值_min_和_max_分別。 ``` QInputDialog.setIntStep (self, int?step) ``` ``` QInputDialog.setIntValue (self, int?value) ``` ``` QInputDialog.setLabelText (self, QString?text) ``` ``` QInputDialog.setOkButtonText (self, QString?text) ``` ``` QInputDialog.setOption (self, InputDialogOption?option, bool?on?=?True) ``` 設置給定_option_被啟用，如果_on_是真的，否則，清除給定的_option_。 **See also** [options](qinputdialog.html#options-prop)和[testOption](qinputdialog.html#testOption)（ ） 。 ``` QInputDialog.setOptions (self, InputDialogOptions?options) ``` ``` QInputDialog.setTextEchoMode (self, QLineEdit.EchoMode?mode) ``` ``` QInputDialog.setTextValue (self, QString?text) ``` ``` QInputDialog.setVisible (self, bool?visible) ``` 從重新實現[QWidget.setVisible](qwidget.html#visible-prop)（ ） 。 ``` QSize QInputDialog.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（ ） 。 ``` bool QInputDialog.testOption (self, InputDialogOption?option) ``` 返回True如果給定的_option_被啟用，否則返回False 。 **See also** [options](qinputdialog.html#options-prop)和[setOption](qinputdialog.html#setOption)（ ） 。 ``` QLineEdit.EchoMode QInputDialog.textEchoMode (self) ``` [ ``` QString QInputDialog.textValue (self) ``` * * * ## Qt Signal Documentation ``` void doubleValueChanged (double) ``` 這是該信號的默認超載。 這個信號被發射在對話框中每當double值的變化。被指定的當前值_value_。 ](qlineedit.html#EchoMode-enum) [當被用在輸入對話框這個信號是唯一的相關](qlineedit.html#EchoMode-enum)[DoubleInput](qinputdialog.html#InputMode-enum)模式。 ``` void doubleValueSelected (double) ``` 這是該信號的默認超載。 每當用戶在接受該對話框中選擇一個雙精度值這個信號被發射，例如，通過點擊**OK**按鈕。是由指定的所選值_value_。 當被用在輸入對話框這個信號是唯一的相關[DoubleInput](qinputdialog.html#InputMode-enum)模式。 ``` void intValueChanged (int) ``` 這是該信號的默認超載。 這個信號被發射的對話框中，每當整數值的變化。被指定的當前值_value_。 當被用在輸入對話框這個信號是唯一的相關[IntInput](qinputdialog.html#InputMode-enum)模式。 ``` void intValueSelected (int) ``` 這是該信號的默認超載。 每當用戶通過接受對話框中選擇一個整數值，這個信號被發射，例如，通過點擊**OK**按鈕。是由指定的所選值_value_。 當被用在輸入對話框這個信號是唯一的相關[IntInput](qinputdialog.html#InputMode-enum)模式。 ``` void textValueChanged (const QString&) ``` 這是該信號的默認超載。 這個信號被發射時的文本字符串的對話框中改變。由指定當前字符串_text_。 當被用在輸入對話框這個信號是唯一的相關[TextInput](qinputdialog.html#InputMode-enum)模式。 ``` void textValueSelected (const QString&) ``` 這是該信號的默認超載。 每當用戶通過接受對話框中選擇一個文本字符串這個信號被發射，例如，通過點擊**OK**按鈕。由指定的選定字符串_text_。 當被用在輸入對話框這個信號是唯一的相關[TextInput](qinputdialog.html#InputMode-enum)模式。