Шаг 252.
Библиотека PyQt5.
Диалоговые окна. Класс QInputDialog. Основные методы и сигналы

    На этом шаге мы перечислим основные методы и сигналы этого класса.

    Класс QInputDialog наследует все методы из базовых классов и добавляет к ним следующие собственные методы (здесь приведены только основные - полный их список доступен на странице https://doc.qt.io/qt-5/qinputdialog.html):

• setLabelText (<Текст>) - задает текст, отображаемый над полем ввода;

• setOkButtonText (<Текст>) - задает текст надписи для кнопки ОК:

  dialog,setOkButtonText("&Ввод")
  

• setCancelButtonText (<Текст>) - задает текст надписи для кнопки Cancel:

    dialog.setCancelButtonText("&Отмена")
  

• setInputMode (<Режим>) - задает режим ввода данных. В качестве параметра указываются следующие атрибуты класса QInputDialog:
  • TextInput (или 0) - ввод текста;
  • IntInput (или 1) - ввод целого числа;
  • DoubleInput (или 2) - ввод вещественного числа;

• setTextEchoMode (<Режим>) - задает режим отображения текста в поле. Могут быть указаны следующие атрибуты класса QLineEdit:
  • Normal (или 0) - показывать символы как они были введены;
  • NoEcho (или 1) - не показывать вводимые символы;
  • Password (или 2) - вместо любого символа выводится звездочка (*);
  • PasswordEchoOnEdit (или 3) - показывать символы при вводе, а при потере фокуса вместо них отображать звездочки;

• setTextValue (<Текст>) - задает текст по умолчанию, отображаемый в текстовом поле;

• textValue () - возвращает текст, введенный в текстовое поле;

• setIntValue (<Значение>) - задает целочисленное значение при использовании режима IntInput;

• intValue () - возвращает целочисленное значение, введенное в поле, при использовании режима IntInput;

• setIntRange (<Минимум>, <Максимум>), setIntMinimum (<Минимум>) и setIntMaximum (<Максимум>) - задают диапазон допустимых целочисленных значений при использовании режима IntInput;

• setIntStep (<Шаг>) - задает шаг приращения значения при нажатии кнопок со стрелками в правой части поля при использовании режима IntInput;

• setDoubleValue (<Значение>) - задает вещественное значение при использовании режима DoubleInput;

• doubleValue () - возвращает вещественное значение, введенное в поле, при использовании режима DoubleInput;

• setDoubleRange (<Минимум>, <Максимум>), setDoubleMinimum (<Минимум>) и setDoubleMaximum (<Максимум>) - задают диапазон допустимых вещественных значений При использовании режима DoubleInput;

• setDoubleDecimals (<Значение>) - задает количество цифр после десятичной точки при использовании режима DoubleInput;

• setComboBoxItems (<Список строк>) - задает пункты, которые будут присутствовать в раскрывающемся списке, выводящемся в этом случае вместо обычного поля ввода. Набор пунктов указывается в виде списка строк;

• setComboBoxEditable (<Флаг>) - если в качестве параметра указано значение True, пользователь сможет ввести произвольное значение в раскрывающийся список, как если бы он был обычным полем ввода;

• setOption (<Опция>[, on=True]) - если во втором параметре указано значение True, заданная в первом параметре опция будет установлена, а если False - сброшена. Опции указываются в виде следующих атрибутов класса QInputDialog:
  • NoButtons (или l) - не выводить кнопки ОК и Cancel;
  • UseListViewForComboBoxItems (или 2) - для отображения списка строк будет использоваться класс QListView (обычный список), а не QComboBox (раскрывающийся список);
  • UsePlainTextEditForTextInput (или 4) - вместо класса QLineEdit (однострочное текстовое поле) будет использован класс QPlainTextEdit (многострочное поле для ввода обычного текста);

• setOptions (<Опции>) - устанавливает несколько опций (см. описание метода setOption()) сразу.

    Класс QInputDialog поддерживает сигналы:

• textValueChanged (<Значение>) - генерируется при изменении значения в текстовом поле. Внутри обработчика через параметр доступно новое значение в виде строки. Сигнал генерируется при использовании режима TextInput;
• textValueSelected (<Значение>) - генерируется при нажатии кнопки ОК. Внутри обработчика через параметр доступно введенное значение в виде строки. Сигнал генерируется при использовании режима TextInput;
• intValueChanged (<Значение>) - генерируется при изменении значения в поле. Внутри обработчика через параметр доступно новое значение в виде целого числа. Сигнал генерируется при использовании режима IntInput;
• intValueSelected (<Значение>) - генерируется при нажатии кнопки ОК. Внутри обработчика через параметр доступно введенное значение в виде целого числа. Сигнал генерируется при использовании режима IntInput;
• doubleValueChanged (<Значение>) - генерируется при изменении значения в поле. Внутри обработчика через параметр доступно новое значение в виде вещественного числа. Сигнал генерируется при использовании режима DoubleInput;
• doubleValueSelected (<Значение>) - генерируется при нажатии кнопки ОК. Внутри обработчика через параметр доступно введенное значение в виде вещественного числа. Сигнал генерируется при использовании режима DoubleInput.

    На следующем шаге мы рассмотрим окно для ввода строки.

Предыдущий шаг Содержание Следующий шаг