En esta página

QInputDialog Class

La clase QInputDialog ofrece un cuadro de diálogo sencillo y práctico para obtener un único valor del usuario. Más información...

Encabezado: #include <QInputDialog>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: QDialog

Tipos públicos

enum InputDialogOption { NoButtons, UseListViewForComboBoxItems, UsePlainTextEditForTextInput }
flags InputDialogOptions
enum InputMode { TextInput, IntInput, DoubleInput }

Propiedades

Funciones públicas

QInputDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
virtual ~QInputDialog()
QString cancelButtonText() const
QStringList comboBoxItems() const
int doubleDecimals() const
double doubleMaximum() const
double doubleMinimum() const
double doubleStep() const
double doubleValue() const
QInputDialog::InputMode inputMode() const
int intMaximum() const
int intMinimum() const
int intStep() const
int intValue() const
bool isComboBoxEditable() const
QString labelText() const
QString okButtonText() const
void open(QObject *receiver, const char *member)
QInputDialog::InputDialogOptions options() const
void setCancelButtonText(const QString &text)
void setComboBoxEditable(bool editable)
void setComboBoxItems(const QStringList &items)
void setDoubleDecimals(int decimals)
void setDoubleMaximum(double max)
void setDoubleMinimum(double min)
void setDoubleRange(double min, double max)
void setDoubleStep(double step)
void setDoubleValue(double value)
void setInputMode(QInputDialog::InputMode mode)
void setIntMaximum(int max)
void setIntMinimum(int min)
void setIntRange(int min, int max)
void setIntStep(int step)
void setIntValue(int value)
void setLabelText(const QString &text)
void setOkButtonText(const QString &text)
void setOption(QInputDialog::InputDialogOption option, bool on = true)
void setOptions(QInputDialog::InputDialogOptions options)
void setTextEchoMode(QLineEdit::EchoMode mode)
void setTextValue(const QString &text)
bool testOption(QInputDialog::InputDialogOption option) const
QLineEdit::EchoMode textEchoMode() const
QString textValue() const

Funciones públicas reimplementadas

virtual void done(int result) override
virtual QSize minimumSizeHint() const override
virtual void setVisible(bool visible) override
virtual QSize sizeHint() const override

Señales

void doubleValueChanged(double value)
void doubleValueSelected(double value)
void intValueChanged(int value)
void intValueSelected(int value)
void textValueChanged(const QString &text)
void textValueSelected(const QString &text)

Miembros públicos estáticos

double getDouble(QWidget *parent, const QString &title, const QString &label, double value = 0, double min = -2147483647, double max = 2147483647, int decimals = 1, bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), double step = 1)
int getInt(QWidget *parent, const QString &title, const QString &label, int value = 0, int min = -2147483647, int max = 2147483647, int step = 1, bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
QString getItem(QWidget *parent, const QString &title, 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)
QString getMultiLineText(QWidget *parent, const QString &title, const QString &label, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)
QString getText(QWidget *parent, const QString &title, const QString &label, QLineEdit::EchoMode mode = QLineEdit::Normal, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

Descripción detallada

El valor de entrada puede ser una cadena, un número o un elemento de una lista. Se debe establecer una etiqueta para indicar al usuario qué debe introducir.

Se proporcionan cinco funciones estáticas de conveniencia: getText(), getMultiLineText(), getInt(), getDouble() y getItem(). Todas las funciones se pueden utilizar de forma similar; por ejemplo:

    bool ok{};
    QString text = QInputDialog::getText(this, tr("QInputDialog::getText()"),
                                         tr("User name:"), QLineEdit::Normal,
                                         QDir::home().dirName(), &ok);
    if (ok && !text.isEmpty())
        textLabel->setText(text);

La variable ` ok ` se establece en `true` si el usuario hace clic en ` OK`; en caso contrario, se establece en `false`.

Cuadros de diálogo de entrada

El ejemplo «Diálogos estándar» muestra cómo utilizar QInputDialog, así como otros diálogos integrados de Qt.

Véase también QMessageBox y el ejemplo «Diálogos estándar».

Documentación sobre los tipos de miembro

enum QInputDialog::InputDialogOption
flags QInputDialog::InputDialogOptions

Esta enumeración especifica diversas opciones que afectan al aspecto y el comportamiento de un cuadro de diálogo de entrada.

ConstanteValorDescripción
QInputDialog::NoButtons0x00000001No mostrar los botones « OK » y « Cancel » (útil para «cuadros de diálogo en tiempo real»).
QInputDialog::UseListViewForComboBoxItems0x00000002Utiliza un « QListView » en lugar de un « QComboBox » no editable para mostrar los elementos establecidos con ` setComboBoxItems()`.
QInputDialog::UsePlainTextEditForTextInput0x00000004Utiliza un QPlainTextEdit para la introducción de texto multilínea. Este valor se introdujo en la versión 5.2.

El tipo `InputDialogOptions` es un `typedef` para ` QFlags<InputDialogOption>`. Almacena una combinación OR de valores de `InputDialogOption`.

Véase también options, setOption() y testOption().

enum QInputDialog::InputMode

Esta enumeración describe los diferentes modos de entrada que se pueden seleccionar para el cuadro de diálogo.

ConstanteValorDescripción
QInputDialog::TextInput0Se utiliza para introducir cadenas de texto.
QInputDialog::IntInput1Se utiliza para introducir números enteros.
QInputDialog::DoubleInput2Se utiliza para introducir números de coma flotante con precisión de doble precisión.

Véase también inputMode.

Documentación de propiedades

cancelButtonText : QString

Esta propiedad contiene el texto del botón que se utiliza para cancelar el cuadro de diálogo

Funciones de Access:

QString cancelButtonText() const
void setCancelButtonText(const QString &text)

comboBoxEditable : bool

Esta propiedad indica si el cuadro combinado utilizado en el cuadro de diálogo de entrada es editable o no

Funciones de Access:

bool isComboBoxEditable() const
void setComboBoxEditable(bool editable)

comboBoxItems : QStringList

Esta propiedad contiene los elementos que se utilizan en el cuadro combinado del cuadro de diálogo de entrada

Funciones de Access:

QStringList comboBoxItems() const
void setComboBoxItems(const QStringList &items)

doubleDecimals : int

establece la precisión del cuadro de selección de valores «double» en decimales

Funciones de acceso:

int doubleDecimals() const
void setDoubleDecimals(int decimals)

Véase también QDoubleSpinBox::setDecimals().

doubleMaximum : double

Esta propiedad contiene el valor máximo de coma flotante de doble precisión que se acepta como entrada

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « DoubleInput ».

Funciones de acceso:

double doubleMaximum() const
void setDoubleMaximum(double max)

doubleMinimum : double

Esta propiedad contiene el valor mínimo de coma flotante de doble precisión que se acepta como entrada

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « DoubleInput ».

Funciones de acceso:

double doubleMinimum() const
void setDoubleMinimum(double min)

doubleStep : double

Esta propiedad define el incremento o decremento en el que se modifica el valor de tipo «double»

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « DoubleInput ».

Funciones de acceso:

double doubleStep() const
void setDoubleStep(double step)

doubleValue : int

Esta propiedad contiene el valor actual de coma flotante de doble precisión aceptado como entrada

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « DoubleInput ».

Funciones de acceso:

double doubleValue() const
void setDoubleValue(double value)

Señal de notificación:

void doubleValueChanged(double value)

inputMode : InputMode

Esta propiedad indica el modo utilizado para la introducción de datos

Esta propiedad ayuda a determinar qué control se utiliza para introducir datos en el cuadro de diálogo.

Funciones de acceso:

QInputDialog::InputMode inputMode() const
void setInputMode(QInputDialog::InputMode mode)

intMaximum : int

Esta propiedad contiene el valor entero máximo que se acepta como entrada

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « IntInput ».

Funciones de acceso:

int intMaximum() const
void setIntMaximum(int max)

intMinimum : int

Esta propiedad indica el valor entero mínimo que se acepta como entrada

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « IntInput ».

Funciones de acceso:

int intMinimum() const
void setIntMinimum(int min)

intStep : int

Esta propiedad define el incremento o decremento en el que se modifica el valor entero

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « IntInput ».

Funciones de acceso:

int intStep() const
void setIntStep(int step)

intValue : int

Esta propiedad contiene el valor entero actual aceptado como entrada

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « IntInput ».

Funciones de acceso:

int intValue() const
void setIntValue(int value)

Señal de notificación:

void intValueChanged(int value)

labelText : QString

Esta propiedad contiene el texto de la etiqueta que describe lo que hay que introducir

Funciones de acceso:

QString labelText() const
void setLabelText(const QString &text)

okButtonText : QString

Esta propiedad contiene el texto del botón que se utiliza para aceptar la entrada en el cuadro de diálogo

Funciones de Access:

QString okButtonText() const
void setOkButtonText(const QString &text)

options : InputDialogOptions

Esta propiedad contiene las distintas opciones que influyen en el aspecto y el comportamiento del cuadro de diálogo

De forma predeterminada, todas las opciones están desactivadas.

Funciones de Access:

QInputDialog::InputDialogOptions options() const
void setOptions(QInputDialog::InputDialogOptions options)

Véase también setOption() y testOption().

textEchoMode : QLineEdit::EchoMode

Esta propiedad define el modo de eco para el valor del texto

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « TextInput ».

Funciones de acceso:

QLineEdit::EchoMode textEchoMode() const
void setTextEchoMode(QLineEdit::EchoMode mode)

textValue : QString

Esta propiedad contiene el valor de texto del cuadro de diálogo de entrada

Esta propiedad solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « TextInput ».

Funciones de acceso:

QString textValue() const
void setTextValue(const QString &text)

Señal de notificación:

void textValueChanged(const QString &text)

Documentación de funciones de miembro

QInputDialog::QInputDialog(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Crea un nuevo cuadro de diálogo de entrada con el parent y el flags indicados.

[virtual noexcept] QInputDialog::~QInputDialog()

Cierra el cuadro de diálogo de entrada.

[override virtual] void QInputDialog::done(int result)

Reimplementa: ` QDialog::done(int r)`.

Cierra el cuadro de diálogo y establece su código de resultado en « result ». Si este cuadro de diálogo se muestra con « exec()», la función «done()» provoca que finalice el bucle de eventos local y que « exec()» devuelva « result ».

Véase también QDialog::done().

[signal] void QInputDialog::doubleValueChanged(double value)

Esta señal se emite cada vez que cambia el valor del número doble en el cuadro de diálogo. El valor actual se especifica mediante value.

Esta señal solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « DoubleInput ».

Nota: Señalde notificación para la propiedad doubleValue.

[signal] void QInputDialog::doubleValueSelected(double value)

Esta señal se emite cada vez que el usuario selecciona un valor doble al aceptar el cuadro de diálogo; por ejemplo, al hacer clic en el botón « OK ». El valor seleccionado se especifica mediante value.

Esta señal solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « DoubleInput ».

[static] double QInputDialog::getDouble(QWidget *parent, const QString &title, const QString &label, double value = 0, double min = -2147483647, double max = 2147483647, int decimals = 1, bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), double step = 1)

Función estática de conveniencia para obtener un número de coma flotante del usuario.

title es el texto que se muestra en la barra de título del cuadro de diálogo. label es el texto que se muestra al usuario (debe indicar qué hay que introducir). value es el número de coma flotante predeterminado al que se establecerá el campo de edición de línea. min y max son los valores mínimo y máximo que el usuario puede seleccionar. decimals es el número máximo de decimales que puede tener el número. step es la cantidad en la que cambian los valores cuando el usuario pulsa los botones de flecha para incrementar o decrementar el valor.

Si ok no es nulo, *ok se establecerá en «true» si el usuario ha pulsado OK y en «false» si ha pulsado Cancel. El elemento padre del cuadro de diálogo es parent. El cuadro de diálogo será modal y utilizará el widget flags.

Esta función devuelve el número de coma flotante que ha introducido el usuario.

Utiliza esta función estática de la siguiente manera:

    bool ok{};
    double d = QInputDialog::getDouble(this, tr("QInputDialog::getDouble()"),
                                       tr("Amount:"), 37.56, -10000, 10000, 2, &ok,
                                       Qt::WindowFlags(), 1);
    if (ok)
        doubleLabel->setText(QStringLiteral("$%1").arg(d));

Véase también getText(), getInt(), getItem() y getMultiLineText().

[static] int QInputDialog::getInt(QWidget *parent, const QString &title, const QString &label, int value = 0, int min = -2147483647, int max = 2147483647, int step = 1, bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())

Función estática de conveniencia para obtener un valor entero introducido por el usuario.

title es el texto que se muestra en la barra de título del cuadro de diálogo. label es el texto que se muestra al usuario (debe indicar qué se debe introducir). value es el número entero por defecto al que se establecerá el cuadro de selección. min y max son los valores mínimo y máximo que el usuario puede elegir. step es la cantidad en la que cambian los valores cuando el usuario pulsa los botones de flecha para incrementar o disminuir el valor.

Si ok es distinto de nulo, *ok se establecerá en «true» si el usuario ha pulsado OK y en «false» si ha pulsado Cancel. El elemento padre del cuadro de diálogo es parent. El cuadro de diálogo será modal y utilizará el widget flags.

Si la operación se realiza correctamente, esta función devuelve el número entero introducido por el usuario; en caso de error, devuelve el valor inicial value.

Utiliza esta función estática de la siguiente manera:

    bool ok;
    int i = QInputDialog::getInt(this, tr("QInputDialog::getInt()"),
                                 tr("Percentage:"), 25, 0, 100, 1, &ok);
    if (ok)
        integerLabel->setText(tr("%1%").arg(i));

Véase también getText(), getDouble(), getItem() y getMultiLineText().

[static] QString QInputDialog::getItem(QWidget *parent, const QString &title, 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)

Función estática de conveniencia que permite al usuario seleccionar un elemento de una lista de cadenas.

title es el texto que se muestra en la barra de título del cuadro de diálogo. label es el texto que se muestra al usuario (debe indicar qué hay que introducir). items es la lista de cadenas que se inserta en el cuadro combinado. current es el número del elemento que debe ser el elemento actual. inputMethodHints son las sugerencias del método de entrada que se utilizarán si el cuadro combinado es editable y hay un método de entrada activo.

Si editable es verdadero, el usuario puede introducir su propio texto; de lo contrario, solo podrá seleccionar uno de los elementos existentes.

Si ok no es nulo, *ok se establecerá en «true» si el usuario ha pulsado OK y en «false» si ha pulsado Cancel. El elemento padre del cuadro de diálogo es parent. El cuadro de diálogo será modal y utilizará el widget flags.

Esta función devuelve el texto del elemento actual o, si editable es «true», el texto actual del cuadro combinado.

Utiliza esta función estática de la siguiente manera:

    const QStringList items{tr("Spring"), tr("Summer"), tr("Fall"), tr("Winter")};

    bool ok{};
    QString item = QInputDialog::getItem(this, tr("QInputDialog::getItem()"),
                                         tr("Season:"), items, 0, false, &ok);
    if (ok && !item.isEmpty())
        itemLabel->setText(item);

Véase también getText(), getInt(), getDouble() y getMultiLineText().

[static] QString QInputDialog::getMultiLineText(QWidget *parent, const QString &title, const QString &label, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

Función estática de conveniencia para obtener una cadena de varias líneas del usuario.

title es el texto que se muestra en la barra de título del cuadro de diálogo. label es el texto que se muestra al usuario (debe indicar lo que hay que introducir). text es el texto predeterminado que se coloca en el campo de edición de texto sin formato. inputMethodHints son las sugerencias del método de entrada que se utilizarán en el widget de edición si hay un método de entrada activo.

Si ok no es nulo, *ok se establecerá en «true» si el usuario ha pulsado OK y en «false» si ha pulsado Cancel. El elemento padre del cuadro de diálogo es parent. El cuadro de diálogo será modal y utilizará el widget especificado flags.

Si se acepta el cuadro de diálogo, esta función devuelve el texto del campo de edición de texto sin formato del cuadro de diálogo. Si se rechaza el cuadro de diálogo, se devuelve un valor nulo QString.

Utiliza esta función estática de la siguiente manera:

    bool ok{};
    QString text = QInputDialog::getMultiLineText(this, tr("QInputDialog::getMultiLineText()"),
                                                  tr("Address:"), "John Doe\nFreedom Street"_L1, &ok);
    if (ok && !text.isEmpty())
        multiLineTextLabel->setText(text);

Véase también getInt(), getDouble(), getItem() y getText().

[static] QString QInputDialog::getText(QWidget *parent, const QString &title, const QString &label, QLineEdit::EchoMode mode = QLineEdit::Normal, const QString &text = QString(), bool *ok = nullptr, Qt::WindowFlags flags = Qt::WindowFlags(), Qt::InputMethodHints inputMethodHints = Qt::ImhNone)

Función estática de conveniencia para obtener una cadena del usuario.

title es el texto que se muestra en la barra de título del cuadro de diálogo. label es el texto que se muestra al usuario (debe indicar qué se debe introducir). text es el texto predeterminado que se coloca en el campo de edición. mode es el modo de eco que utilizará el campo de edición. inputMethodHints son las sugerencias del método de entrada que se utilizarán en el widget de edición si hay un método de entrada activo.

Si ok no es nulo, *ok se establecerá en true si el usuario ha pulsado OK y en false si ha pulsado Cancel. El elemento padre del cuadro de diálogo es parent. El cuadro de diálogo será modal y utilizará el widget especificado flags.

Si se acepta el cuadro de diálogo, esta función devuelve el texto del campo de edición de línea del cuadro de diálogo. Si se rechaza el cuadro de diálogo, se devuelve un valor nulo QString.

Utiliza esta función estática de la siguiente manera:

    bool ok{};
    QString text = QInputDialog::getText(this, tr("QInputDialog::getText()"),
                                         tr("User name:"), QLineEdit::Normal,
                                         QDir::home().dirName(), &ok);
    if (ok && !text.isEmpty())
        textLabel->setText(text);

Véase también getInt(), getDouble(), getItem() y getMultiLineText().

[signal] void QInputDialog::intValueChanged(int value)

Esta señal se emite cada vez que cambia el valor entero en el cuadro de diálogo. El valor actual se especifica mediante value.

Esta señal solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « IntInput ».

Nota: Señalde notificación para la propiedad intValue.

[signal] void QInputDialog::intValueSelected(int value)

Esta señal se emite cada vez que el usuario selecciona un valor entero al aceptar el cuadro de diálogo; por ejemplo, al hacer clic en el botón « OK ». El valor seleccionado se especifica mediante « value ».

Esta señal solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « IntInput ».

[override virtual] QSize QInputDialog::minimumSizeHint() const

Reimplementa: ` QDialog::minimumSizeHint()` const.

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

Esta función conecta una de sus señales a la ranura especificada por ` receiver ` y ` member`. La señal concreta depende de los argumentos que se especifiquen en ` member`. Estos son:

La señal se desconectará de la ranura cuando se cierre el cuadro de diálogo.

void QInputDialog::setDoubleRange(double min, double max)

Establece el rango de valores de coma flotante de doble precisión que admite el cuadro de diálogo cuando se utiliza en modo « DoubleInput », con los valores mínimo y máximo especificados por min y max, respectivamente.

void QInputDialog::setIntRange(int min, int max)

Establece el rango de valores enteros que admite el cuadro de diálogo cuando se utiliza en modo « IntInput », siendo los valores mínimo y máximo los especificados en « min » y « max », respectivamente.

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

Establece que el option especificado esté habilitado si on es verdadero; en caso contrario, deshabilita el option especificado.

Véase también options y testOption().

[override virtual] void QInputDialog::setVisible(bool visible)

Reimplementa: ` QDialog::setVisible` (bool visible).

[override virtual] QSize QInputDialog::sizeHint() const

Reimplementa: ` QDialog::sizeHint()` const.

bool QInputDialog::testOption(QInputDialog::InputDialogOption option) const

Devuelve « true » si la opción « option » está activada; en caso contrario, devuelve «false».

Véase también options y setOption().

[signal] void QInputDialog::textValueChanged(const QString &text)

Esta señal se emite cada vez que cambia la cadena de texto en el cuadro de diálogo. La cadena actual se especifica mediante ` text`.

Esta señal solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « TextInput ».

Nota: Señalde notificación para la propiedad textValue.

[signal] void QInputDialog::textValueSelected(const QString &text)

Esta señal se emite cada vez que el usuario selecciona una cadena de texto al aceptar el cuadro de diálogo; por ejemplo, al hacer clic en el botón « OK ». La cadena seleccionada se especifica mediante « text ».

Esta señal solo es relevante cuando el cuadro de diálogo de entrada se utiliza en modo « TextInput ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.