QLineEdit Class
El widget QLineEdit es un editor de texto de una sola línea. Más información...
| Encabezado: | #include <QLineEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredan: | QWidget |
Tipos públicos
| enum | ActionPosition { LeadingPosition, TrailingPosition } |
| enum | EchoMode { Normal, NoEcho, Password, PasswordEchoOnEdit } |
Propiedades
|
|
Funciones públicas
| QLineEdit(QWidget *parent = nullptr) | |
| QLineEdit(const QString &contents, QWidget *parent = nullptr) | |
| virtual | ~QLineEdit() |
| void | addAction(QAction *action, QLineEdit::ActionPosition position) |
| QAction * | addAction(const QIcon &icon, QLineEdit::ActionPosition position) |
| Qt::Alignment | alignment() const |
| void | backspace() |
| QCompleter * | completer() const |
| QMenu * | createStandardContextMenu() |
| void | cursorBackward(bool mark, int steps = 1) |
| void | cursorForward(bool mark, int steps = 1) |
| Qt::CursorMoveStyle | cursorMoveStyle() const |
| int | cursorPosition() const |
| int | cursorPositionAt(const QPoint &pos) |
| void | cursorWordBackward(bool mark) |
| void | cursorWordForward(bool mark) |
| void | del() |
| void | deselect() |
| QString | displayText() const |
| bool | dragEnabled() const |
| QLineEdit::EchoMode | echoMode() const |
| void | end(bool mark) |
| bool | hasAcceptableInput() const |
| bool | hasFrame() const |
| bool | hasSelectedText() const |
| void | home(bool mark) |
| QString | inputMask() const |
| void | insert(const QString &newText) |
| bool | isClearButtonEnabled() const |
| bool | isModified() const |
| bool | isReadOnly() const |
| bool | isRedoAvailable() const |
| bool | isUndoAvailable() const |
| int | maxLength() const |
| QString | placeholderText() const |
| QString | selectedText() const |
| int | selectionEnd() const |
| int | selectionLength() const |
| int | selectionStart() const |
| void | setAlignment(Qt::Alignment flag) |
| void | setClearButtonEnabled(bool enable) |
| void | setCompleter(QCompleter *c) |
| void | setCursorMoveStyle(Qt::CursorMoveStyle style) |
| void | setCursorPosition(int) |
| void | setDragEnabled(bool b) |
| void | setEchoMode(QLineEdit::EchoMode) |
| void | setFrame(bool) |
| void | setInputMask(const QString &inputMask) |
| void | setMaxLength(int) |
| void | setModified(bool) |
| void | setPlaceholderText(const QString &) |
| void | setReadOnly(bool) |
| void | setSelection(int start, int length) |
| void | setTextMargins(const QMargins &margins) |
| void | setTextMargins(int left, int top, int right, int bottom) |
| void | setValidator(const QValidator *v) |
| QString | text() const |
| QMargins | textMargins() const |
| const QValidator * | validator() const |
Funciones públicas reimplementadas
| virtual bool | event(QEvent *e) override |
| virtual QVariant | inputMethodQuery(Qt::InputMethodQuery property) const override |
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
| virtual void | timerEvent(QTimerEvent *e) override |
Ranuras públicas
| void | clear() |
| void | copy() const |
| void | cut() |
| void | paste() |
| void | redo() |
| void | selectAll() |
| void | setText(const QString &) |
| void | undo() |
Señales
| void | cursorPositionChanged(int oldPos, int newPos) |
| void | editingFinished() |
| void | inputRejected() |
| void | returnPressed() |
| void | selectionChanged() |
| void | textChanged(const QString &text) |
| void | textEdited(const QString &text) |
Funciones protegidas
| QRect | cursorRect() const |
| virtual void | initStyleOption(QStyleOptionFrame *option) const |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *ev) override |
| virtual void | contextMenuEvent(QContextMenuEvent *event) override |
| virtual void | dragEnterEvent(QDragEnterEvent *e) override |
| virtual void | dragLeaveEvent(QDragLeaveEvent *e) override |
| virtual void | dragMoveEvent(QDragMoveEvent *e) override |
| virtual void | dropEvent(QDropEvent *e) override |
| virtual void | focusInEvent(QFocusEvent *e) override |
| virtual void | focusOutEvent(QFocusEvent *e) override |
| virtual void | inputMethodEvent(QInputMethodEvent *e) override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | keyReleaseEvent(QKeyEvent *e) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *e) override |
| virtual void | mouseMoveEvent(QMouseEvent *e) override |
| virtual void | mousePressEvent(QMouseEvent *e) override |
| virtual void | mouseReleaseEvent(QMouseEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
Descripción detallada

Un campo de edición de línea permite a los usuarios introducir y editar una sola línea de texto sin formato con útiles funciones de edición, como deshacer y rehacer, cortar y pegar, y arrastrar y soltar.
Al cambiar el valor de « echoMode » () de un campo de edición de línea, también puede utilizarse como campo de solo escritura para datos como contraseñas.
QTextEdit es una clase relacionada que permite la edición de texto enriquecido en varias líneas.
Restricciones de texto
Utiliza ` maxLength ` para definir la longitud máxima permitida de un texto. Puedes utilizar ` inputMask ` y ` setValidator()` para restringir aún más el contenido del texto.
Edición de texto
Puedes modificar el texto con setText() o insert(). Utiliza text() para recuperar el texto y displayText() para recuperar el texto mostrado (que puede ser diferente; consulta EchoMode). Puedes seleccionar el texto con setSelection() o selectAll(), y puedes aplicar cut(), copy() y paste() a la selección. Para alinear el texto, utiliza setAlignment().
Cuando el texto cambia, se emite la señal « textChanged » (). Cuando el texto cambia de alguna otra forma que no sea llamando a « setText » (), se emite la señal « textEdited » (). Cuando se mueve el cursor, se emite la señal « cursorPositionChanged » (). Y cuando se pulsa la tecla «Return» o «Enter», se emite la señal « returnPressed » ().
Cuando finaliza la edición de texto, ya sea porque el campo de edición ha perdido el foco o porque se ha pulsado la tecla «Return» o «Enter», se emite la señal editingFinished().
Si el campo de edición de línea pierde el foco sin que se haya modificado el texto, no se emitirá la señal editingFinished().
Si hay un validador configurado en el campo de edición de línea, las señales « returnPressed » ()/«editingFinished » () solo se emitirán si el validador devuelve « QValidator::Acceptable ».
Para obtener más información sobre las múltiples formas en que se puede utilizar QLineEdit, consulta el ejemplo «Line Edits Example», que también ofrece una selección de ejemplos de campos de edición de línea que muestran los efectos de diversas propiedades y validadores sobre la entrada y la salida proporcionadas por el usuario.
Configuración de un marco
Por defecto, los QLineEdit tienen un marco tal y como se especifica en las guías de estilo de la plataforma. Se puede desactivar el marco llamando a ` setFrame(false)`.
Atajos de teclado predeterminados
La tabla siguiente describe las combinaciones de teclas predeterminadas.
Nota: El campo de edición también dispone de un menú contextual (que suele activarse haciendo clic con el botón derecho del ratón) que ofrece algunas de las opciones de edición que se enumeran a continuación.
| Tecla | Acción |
|---|---|
| Flecha izquierda | Mueve el cursor un carácter hacia la izquierda. |
| Mayús + Flecha izquierda | Mueve y selecciona el texto un carácter hacia la izquierda. |
| Flecha derecha | Mueve el cursor un carácter a la derecha. |
| Mayús + Flecha derecha | Mueve y selecciona el texto un carácter hacia la derecha. |
| Inicio | Mueve el cursor al principio de la línea. |
| Fin | Mueve el cursor al final de la línea. |
| Retroceso | Borra el carácter situado a la izquierda del cursor. |
| Ctrl+Retroceso | Borra la palabra situada a la izquierda del cursor. |
| Suprimir | Borra el carácter situado a la derecha del cursor. |
| Ctrl+Supr | Elimina la palabra situada a la derecha del cursor. |
| Ctrl+A | Selecciona todo. |
| Ctrl+C | Copia el texto seleccionado al portapapeles. |
| Ctrl+Insert | Copia el texto seleccionado al portapapeles. |
| Ctrl+K | Borra hasta el final de la línea. |
| Ctrl+V | Pega el texto del portapapeles en el campo de edición. |
| Mayús+Insert | Pega el texto del portapapeles en el campo de edición. |
| Ctrl+X | Elimina el texto seleccionado y lo copia al portapapeles. |
| Mayús+Supr | Elimina el texto seleccionado y lo copia al portapapeles. |
| Ctrl+Z | Deshace la última operación. |
| Ctrl+Y | Repite la última operación deshecha. |
Cualquier otra pulsación de tecla que represente un carácter válido hará que dicho carácter se inserte en el campo de edición.
Véase también QTextEdit, QLabel, QComboBox y el ejemplo de campos de edición de línea.
Documentación sobre tipos de miembros
enum QLineEdit::ActionPosition
Este tipo de enumeración describe cómo debe mostrar un campo de texto los controles de acción que se van a añadir.
| Constante | Valor | Descripción |
|---|---|---|
QLineEdit::LeadingPosition | 0 | El widget se muestra a la izquierda del texto cuando se utiliza la dirección de diseño Qt::LeftToRight o a la derecha cuando se utiliza Qt::RightToLeft, respectivamente. |
QLineEdit::TrailingPosition | 1 | El widget se muestra a la derecha del texto cuando se utiliza la dirección de diseño « Qt::LeftToRight » o a la izquierda cuando se utiliza « Qt::RightToLeft », respectivamente. |
Véase también addAction(), removeAction() y QWidget::layoutDirection.
enum QLineEdit::EchoMode
Este tipo de enumeración describe cómo debe mostrar su contenido un campo de texto.
| Constante | Valor | Descripción |
|---|---|---|
QLineEdit::Normal | 0 | Muestra los caracteres a medida que se introducen. Este es el valor por defecto. |
QLineEdit::NoEcho | 1 | No muestra nada. Esto puede ser adecuado para contraseñas en las que incluso la longitud de la contraseña debe mantenerse en secreto. |
QLineEdit::Password | 2 | Muestra caracteres de enmascaramiento de contraseña dependientes de la plataforma en lugar de los caracteres introducidos realmente. |
QLineEdit::PasswordEchoOnEdit | 3 | Muestra los caracteres solo mientras se introducen. En caso contrario, muestra los caracteres como en ` Password`. |
Véase también setEchoMode() y echoMode().
Documentación de propiedades
[read-only] acceptableInput : bool
Esta propiedad indica si la entrada cumple con el « inputMask » y el validador.
Por defecto, esta propiedad es true.
Funciones de acceso:
| bool | hasAcceptableInput() const |
Véase también ` setInputMask()` y ` setValidator()`.
alignment : Qt::Alignment
Esta propiedad determina la alineación del campo de texto.
Aquí se permite tanto la alineación horizontal como la vertical; « Qt::AlignJustify » se corresponderá con « Qt::AlignLeft ».
Por defecto, esta propiedad contiene una combinación de « Qt::AlignLeft » y « Qt::AlignVCenter ».
Funciones de acceso:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment flag) |
Véase también « Qt::Alignment ».
clearButtonEnabled : bool
Esta propiedad determina si el campo de texto muestra un botón «Borrar» cuando no está vacío.
Si está habilitada, el campo de edición de línea muestra un botón « clear » al final cuando contiene texto. De lo contrario, el campo de edición de línea no muestra el botón « clear » (valor predeterminado).
Funciones de acceso:
| bool | isClearButtonEnabled() const |
| void | setClearButtonEnabled(bool enable) |
Véase también addAction() y removeAction().
cursorMoveStyle : Qt::CursorMoveStyle
Esta propiedad determina el estilo de desplazamiento del cursor en este campo de texto.
Cuando esta propiedad se establece en « Qt::VisualMoveStyle », el campo de edición utilizará un estilo de desplazamiento visual. Al pulsar la tecla de flecha izquierda, el cursor siempre se desplazará hacia la izquierda, independientemente de la dirección de escritura del texto. El mismo comportamiento se aplica a la tecla de flecha derecha.
Cuando la propiedad se establece en « Qt::LogicalMoveStyle » (el valor predeterminado), dentro de un bloque de texto de izquierda a derecha (LTR), al pulsar la tecla de flecha izquierda la posición del cursor aumentará, mientras que al pulsar la tecla de flecha derecha disminuirá. Si el bloque de texto es de derecha a izquierda (RTL), se aplica el comportamiento contrario.
Funciones de acceso:
| Qt::CursorMoveStyle | cursorMoveStyle() const |
| void | setCursorMoveStyle(Qt::CursorMoveStyle style) |
cursorPosition : int
Esta propiedad almacena la posición actual del cursor en este campo de texto.
Al establecer la posición del cursor, se actualiza la visualización cuando sea necesario.
Por defecto, esta propiedad tiene un valor de 0.
Funciones de acceso:
| int | cursorPosition() const |
| void | setCursorPosition(int) |
[read-only] displayText : QString
Esta propiedad contiene el texto que se muestra.
Si echoMode es Normal, devuelve lo mismo que text(). Si EchoMode es Password o PasswordEchoOnEdit, devuelve una cadena de caracteres de máscara de contraseña dependientes de la plataforma (por ejemplo, «******»). Si EchoMode es NoEcho, devuelve una cadena vacía.
Por defecto, esta propiedad contiene una cadena vacía.
Funciones de acceso:
| QString | displayText() const |
Véase también setEchoMode(), text() y EchoMode.
dragEnabled : bool
Esta propiedad determina si el campo de texto inicia una acción de arrastre cuando el usuario pulsa y mueve el ratón sobre un texto seleccionado.
El arrastre está desactivado de forma predeterminada.
Funciones de Access:
| bool | dragEnabled() const |
| void | setDragEnabled(bool b) |
echoMode : EchoMode
Esta propiedad define el modo de eco del campo de edición de línea.
El modo de eco determina cómo se muestra (o se repite) al usuario el texto introducido en el campo de edición de línea.
La configuración más habitual es « Normal », en la que el texto introducido por el usuario se muestra tal cual. « QLineEdit » también admite modos que permiten ocultar o enmascarar el texto introducido: entre ellos se incluyen « NoEcho », « Password » y « PasswordEchoOnEdit ».
Esta configuración afecta a la visualización del widget y a la posibilidad de copiar o arrastrar el texto.
Por defecto, esta propiedad está establecida en « Normal ».
Funciones de acceso:
| QLineEdit::EchoMode | echoMode() const |
| void | setEchoMode(QLineEdit::EchoMode) |
Véase también EchoMode y displayText().
frame : bool
Esta propiedad determina si el campo de texto se dibuja con un marco.
Si está habilitada (valor predeterminado), el campo de edición de línea se dibuja dentro de un marco. De lo contrario, el campo de edición de línea se dibuja sin ningún marco.
Funciones de acceso:
| bool | hasFrame() const |
| void | setFrame(bool) |
[read-only] hasSelectedText : bool
Esta propiedad indica si hay algún texto seleccionado.
hasSelectedText() devuelve « true » si el usuario ha seleccionado parte o la totalidad del texto. En caso contrario, devuelve « false ».
Por defecto, esta propiedad es false.
Funciones de acceso:
| bool | hasSelectedText() const |
Véase también ` selectedText()`.
inputMask : QString
Esta propiedad contiene la máscara de validación de la entrada.
Establece la máscara de validación de QLineEdit. Se pueden utilizar validadores en lugar de las máscaras o junto con ellas; véase setValidator(). El valor por defecto es una cadena vacía, lo que significa que no se utiliza ninguna máscara de entrada.
Para desactivar la máscara y volver al funcionamiento normal de QLineEdit, pasa una cadena vacía.
La máscara de entrada es una cadena de plantilla de entrada. Puede contener los siguientes elementos:
| Caracteres de máscara | Define el Category de caracteres de entrada que se consideran válidos en esta posición. |
| Metacaracteres | Tienen diversos significados especiales (véanse los detalles más abajo). |
| Separadores | Todos los demás caracteres se consideran separadores fijos. |
La siguiente tabla muestra los caracteres de máscara y metacaracteres que se pueden utilizar en una máscara de entrada.
| Carácter de máscara | Significado |
|---|---|
A | Se requiere un carácter de la categoría «Letra», como A-Z o a-z. |
a | Se permite un carácter de la categoría «Letra», pero no es obligatorio. |
N | Carácter de la categoría «Letra» o «Número» obligatorio, como A-Z, a-z, 0-9. |
n | Se permite un carácter de la categoría «Letra» o «Número», pero no es obligatorio. |
X | Se requiere cualquier carácter que no sea un espacio en blanco. |
x | Se permite cualquier carácter que no sea un espacio en blanco, pero no es obligatorio. |
9 | Se requiere un carácter de la categoría «Número», como 0-9. |
0 | Se permite un carácter de la categoría «Número», pero no es obligatorio. |
D | Se requiere un carácter de la categoría «Número» y mayor que cero, como 1-9. |
d | Se permite un carácter de la categoría «Número» y mayor que cero, pero no es obligatorio, como 1-9. |
# | Se permite un carácter de la categoría «Número» o el signo más o menos, aunque no es obligatorio. |
H | Carácter hexadecimal obligatorio. A-F, a-f, 0-9. |
h | Se permite un carácter hexadecimal, pero no es obligatorio. |
B | Se requiere un carácter binario. 0-1. |
b | Se permite un carácter binario, pero no es obligatorio. |
| Metacarácter | Significado |
> | Todos los caracteres alfabéticos siguientes se escriben en mayúsculas. |
< | Todos los caracteres alfabéticos siguientes se escriben en minúsculas. |
! | Desactiva la conversión de mayúsculas y minúsculas. |
;c | Finaliza la máscara de entrada y establece el carácter en blanco como «c». |
[ ] { } | Reservado. |
\ | Utiliza \ para escapar los caracteres especiales enumerados anteriormente y poder utilizarlos como separadores. |
Al crearse o borrarse, el campo de edición se rellenará con una copia de la cadena de la máscara de entrada en la que se han eliminado los metacaracteres y los caracteres de la máscara se han sustituido por el carácter en blanco (por defecto, un space).
Cuando se establece una máscara de entrada, el método text() devuelve una copia modificada del contenido del campo de edición en la que se han eliminado todos los caracteres en blanco. El contenido sin modificar se puede leer mediante displayText().
El método hasAcceptableInput() devuelve «false» si el contenido actual del campo de edición de línea no cumple los requisitos de la máscara de entrada.
Ejemplos:
| Máscara | Notas |
|---|---|
000.000.000.000;_ | Dirección IP; los espacios en blanco se sustituyen por _. |
HH:HH:HH:HH:HH:HH;_ | Dirección MAC |
0000-00-00 | Fecha ISO; los espacios en blanco se interpretan como space |
>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;# | Número de licencia; los espacios en blanco se interpretan como « # » y todos los caracteres (alfabéticos) se convierten a mayúsculas. |
Para controlar un rango (por ejemplo, para una dirección IP), utiliza máscaras junto con validators.
Funciones de acceso:
| QString | inputMask() const |
| void | setInputMask(const QString &inputMask) |
Véase también maxLength, QChar::isLetter(), QChar::isNumber() y QChar::digitValue().
maxLength : int
Esta propiedad establece la longitud máxima permitida del texto.
Si el texto es demasiado largo, se trunca al llegar al límite.
Si se produce el truncamiento, se deseleccionará cualquier texto seleccionado, la posición del cursor se establecerá en 0 y se mostrará la primera parte de la cadena.
Si el campo de edición de línea tiene una máscara de entrada, esta define la longitud máxima de la cadena.
Por defecto, esta propiedad tiene un valor de 32767.
Funciones de Access:
| int | maxLength() const |
| void | setMaxLength(int) |
Véase también inputMask.
modified : bool
Esta propiedad indica si el usuario ha modificado el contenido del campo de texto.
QLineEdit nunca lee el indicador de modificación; tiene un valor predeterminado de «false» y se cambia a «true» cada vez que el usuario modifica el contenido del campo de edición de línea.
Esto resulta útil para casos en los que es necesario proporcionar un valor por defecto, pero no se sabe desde el principio cuál debe ser dicho valor (por ejemplo, si depende de otros campos del formulario). Inicia el campo de edición de línea sin el valor por defecto óptimo y, cuando se conozca dicho valor, si modified() devuelve false (el usuario no ha introducido ningún texto), inserta el valor por defecto.
Al llamar a ` setText()` se restablece el indicador «modified» a «false».
Funciones de Access:
| bool | isModified() const |
| void | setModified(bool) |
placeholderText : QString
Esta propiedad contiene el texto de marcador de posición del campo de texto.
Al establecer esta propiedad, el campo de texto muestra un texto de marcador de posición en gris mientras el campo esté vacío.
Normalmente, un campo de edición de línea vacío muestra el texto de marcador de posición incluso cuando tiene el foco. Sin embargo, si el contenido está centrado horizontalmente, el texto de marcador de posición no se muestra debajo del cursor cuando el campo de edición de línea tiene el foco.
Por defecto, esta propiedad contiene una cadena vacía.
Funciones de acceso:
| QString | placeholderText() const |
| void | setPlaceholderText(const QString &) |
Véase también text().
readOnly : bool
Esta propiedad indica si el campo de texto es de solo lectura.
En modo de solo lectura, el usuario puede seguir copiando el texto al portapapeles o arrastrarlo y soltarlo (si echoMode() es Normal), pero no puede editarlo.
QLineEdit No muestra el cursor en modo de solo lectura.
De forma predeterminada, esta propiedad está false.
Funciones de Access:
| bool | isReadOnly() const |
| void | setReadOnly(bool) |
Véase también setEnabled().
[read-only] redoAvailable : bool
Esta propiedad indica si la función «Rehacer» está disponible.
La opción «Rehacer» queda disponible una vez que el usuario ha realizado una o más operaciones de «Deshacer» en el texto del campo de edición de línea.
Por defecto, esta propiedad tiene el valor « false ».
Funciones de acceso:
| bool | isRedoAvailable() const |
[read-only] selectedText : QString
Esta propiedad contiene el texto seleccionado.
Si no hay texto seleccionado, el valor de esta propiedad es una cadena vacía.
Por defecto, esta propiedad contiene una cadena vacía.
Funciones de acceso:
| QString | selectedText() const |
Véase también hasSelectedText().
text : QString
Esta propiedad contiene el texto del campo de edición de línea.
Al establecer esta propiedad, se borra la selección, se borra el historial de deshacer/rehacer, se desplaza el cursor al final de la línea y se restablece la propiedad modified a false. El texto no se valida cuando se inserta con setText().
El texto se trunca a la longitud especificada en maxLength().
Por defecto, esta propiedad contiene una cadena vacía.
Funciones de acceso:
| QString | text() const |
| void | setText(const QString &) |
Señal de notificador:
| void | textChanged(const QString &text) |
Véase también ` insert()` y ` clear()`.
[read-only] undoAvailable : bool
Esta propiedad indica si la función «Deshacer» está disponible.
La función «Deshacer» estará disponible una vez que el usuario haya modificado el texto en el campo de edición de línea.
Por defecto, esta propiedad es « false ».
Funciones de Access:
| bool | isUndoAvailable() const |
Documentación de las funciones de miembro
[explicit] QLineEdit::QLineEdit(QWidget *parent = nullptr)
Crea un campo de texto sin contenido.
La longitud máxima del texto se establece en 32 767 caracteres.
El argumento « parent » se envía al constructor « QWidget ».
Véase también setText() y setMaxLength().
[explicit] QLineEdit::QLineEdit(const QString &contents, QWidget *parent = nullptr)
Crea un campo de edición de línea que contiene el texto « contents » como elemento secundario de « parent ».
La posición del cursor se establece al final de la línea y la longitud máxima del texto se fija en 32 767 caracteres.
Véase también text() y setMaxLength().
[virtual noexcept] QLineEdit::~QLineEdit()
Elimina el campo de edición.
void QLineEdit::addAction(QAction *action, QLineEdit::ActionPosition position)
Añade la « action » a la lista de acciones disponible en position.
QAction *QLineEdit::addAction(const QIcon &icon, QLineEdit::ActionPosition position)
Crea una nueva acción con la « icon » indicada en « position ».
Esta es una función sobrecargada.
void QLineEdit::backspace()
Si no hay texto seleccionado, borra el carácter situado a la izquierda del cursor de texto y desplaza el cursor una posición hacia la izquierda. Si hay texto seleccionado, el cursor se desplaza al principio del texto seleccionado y este se borra.
Véase también ` del()`.
[override virtual protected] void QLineEdit::changeEvent(QEvent *ev)
Reimplementa: QWidget::changeEvent(QEvent *event).
[slot] void QLineEdit::clear()
Borra el contenido del campo de texto.
Véase también setText() y insert().
QCompleter *QLineEdit::completer() const
Devuelve el objeto ` QCompleter ` actual que proporciona sugerencias.
Véase también setCompleter().
[override virtual protected] void QLineEdit::contextMenuEvent(QContextMenuEvent *event)
Reimplementa: ` QWidget::contextMenuEvent(QContextMenuEvent *event)`.
Muestra el menú contextual estándar creado con createStandardContextMenu().
Si no deseas que el campo de edición de línea tenga un menú contextual, puedes establecer su contextMenuPolicy en Qt::NoContextMenu. Para personalizar el menú contextual, reimplementa esta función. Para ampliar el menú contextual estándar, reimplementa esta función, llama a createStandardContextMenu() y amplía el menú devuelto.
void LineEdit::contextMenuEvent(QContextMenuEvent *event)
{
QMenu *menu = createStandardContextMenu();
menu->addAction(tr("My Menu Item"));
//...
menu->exec(event->globalPos());
delete menu;
}El parámetro event se utiliza para obtener la posición en la que se encontraba el cursor del ratón cuando se generó el evento.
Véase también setContextMenuPolicy().
[slot] void QLineEdit::copy() const
Copia el texto seleccionado al portapapeles, si hay alguno, y si echoMode() es Normal.
Véase también cut() y paste().
QMenu *QLineEdit::createStandardContextMenu()
Crea el menú contextual estándar, que se muestra cuando el usuario hace clic con el botón derecho del ratón en el campo de edición de línea. Se invoca desde el controlador predeterminado ` contextMenuEvent()`. La propiedad del menú emergente se transfiere a quien lo invoca.
void QLineEdit::cursorBackward(bool mark, int steps = 1)
Mueve el cursor hacia atrás steps caracteres. Si mark es verdadero, cada carácter por el que se pasa se añade a la selección. Si mark es falso, se borra la selección.
Véase también cursorForward().
void QLineEdit::cursorForward(bool mark, int steps = 1)
Mueve el cursor hacia adelante steps caracteres. Si mark es verdadero, cada carácter por el que se pasa se añade a la selección. Si mark es falso, se borra la selección.
Véase también cursorBackward().
int QLineEdit::cursorPositionAt(const QPoint &pos)
Devuelve la posición del cursor debajo del punto pos.
[signal] void QLineEdit::cursorPositionChanged(int oldPos, int newPos)
Esta señal se emite cada vez que se mueve el cursor. La posición anterior viene dada por oldPos, y la nueva posición por newPos.
Véanse también setCursorPosition() y cursorPosition().
[protected] QRect QLineEdit::cursorRect() const
Devuelve un rectángulo que incluye el cursor del campo de texto.
void QLineEdit::cursorWordBackward(bool mark)
Mueve el cursor una palabra hacia atrás. Si mark es verdadero, la palabra también queda seleccionada.
Véase también cursorWordForward().
void QLineEdit::cursorWordForward(bool mark)
Mueve el cursor una palabra hacia delante. Si mark es verdadero, la palabra también queda seleccionada.
Véase también cursorWordBackward().
[slot] void QLineEdit::cut()
Copia el texto seleccionado al portapapeles y lo borra, si lo hay, siempre que echoMode() sea Normal.
Si el validador actual no permite eliminar el texto seleccionado, cut() lo copiará sin eliminarlo.
Véase también copy(), paste() y setValidator().
void QLineEdit::del()
Si no hay ningún texto seleccionado, borra el carácter situado a la derecha del cursor de texto. Si hay algún texto seleccionado, el cursor se desplaza al principio del texto seleccionado y este se borra.
Véase también backspace().
void QLineEdit::deselect()
Deselecciona cualquier texto seleccionado.
Véase también setSelection() y selectAll().
[override virtual protected] void QLineEdit::dragEnterEvent(QDragEnterEvent *e)
Reimplementa: QWidget::dragEnterEvent(QDragEnterEvent *event).
[override virtual protected] void QLineEdit::dragLeaveEvent(QDragLeaveEvent *e)
Reimplementa: QWidget::dragLeaveEvent(QDragLeaveEvent *event).
[override virtual protected] void QLineEdit::dragMoveEvent(QDragMoveEvent *e)
Reimplementa: ` QWidget::dragMoveEvent(QDragMoveEvent *event)`.
[override virtual protected] void QLineEdit::dropEvent(QDropEvent *e)
Reimplementa: QWidget::dropEvent(QDropEvent *event).
[signal] void QLineEdit::editingFinished()
Esta señal se emite cuando se pulsa la tecla «Retorno» o «Intro», o si el campo de edición pierde el foco y su contenido ha cambiado desde la última vez que se emitió esta señal.
Nota: Si se ha establecido un « validator » () o un « inputMask » () en el campo de edición y se pulsa Intro/Retorno, la señal «editingFinished()» solo se emitirá si la entrada cumple con « inputMask » () y « validator » () devuelve « QValidator::Acceptable ».
void QLineEdit::end(bool mark)
Mueve el cursor de texto al final de la línea, a menos que ya se encuentre allí. Si mark es verdadero, el texto se selecciona hasta la última posición. De lo contrario, cualquier texto seleccionado se deselecciona al mover el cursor.
Véase también home().
[override virtual] bool QLineEdit::event(QEvent *e)
Reimplementa: ` QWidget::event(QEvent *event)`.
[override virtual protected] void QLineEdit::focusInEvent(QFocusEvent *e)
Reimplementa: QWidget::focusInEvent(QFocusEvent *event).
[override virtual protected] void QLineEdit::focusOutEvent(QFocusEvent *e)
Reimplementa: QWidget::focusOutEvent(QFocusEvent *event).
void QLineEdit::home(bool mark)
Mueve el cursor de texto al principio de la línea, a menos que ya se encuentre allí. Si « mark » es verdadero, se selecciona texto hasta la primera posición. En caso contrario, cualquier texto seleccionado se deselecciona al mover el cursor.
Véase también end().
[virtual protected] void QLineEdit::initStyleOption(QStyleOptionFrame *option) const
Inicializa ` option ` con los valores de esta página: QLineEdit. Este método resulta útil para las subclases cuando necesitan un ` QStyleOptionFrame`, pero no quieren introducir toda la información por sí mismas.
Véase también QStyleOption::initFrom().
[override virtual protected] void QLineEdit::inputMethodEvent(QInputMethodEvent *e)
Reimplementa: ` QWidget::inputMethodEvent(QInputMethodEvent *event)`.
[override virtual] QVariant QLineEdit::inputMethodQuery(Qt::InputMethodQuery property) const
Reimplementa: ` QWidget::inputMethodQuery` (conste `Qt::InputMethodQuery query`).
[signal] void QLineEdit::inputRejected()
Esta señal se emite cuando el usuario utiliza una tecla que no se considera una entrada válida. Por ejemplo, si al pulsar una tecla la llamada validate() del validador devuelve Invalid. Otro caso es cuando se intenta introducir más caracteres de los que permite la longitud máxima del campo de texto.
Nota: Esta señal se emitirá igualmente cuando solo se acepte una parte del texto. Por ejemplo, si hay una longitud máxima establecida y el texto del portapapeles es más largo que dicha longitud máxima al pegarlo.
void QLineEdit::insert(const QString &newText)
Elimina cualquier texto seleccionado, inserta newText y comprueba la validez del resultado. Si es válido, establece el nuevo texto como el nuevo contenido del campo de edición de línea.
Véanse también setText() y clear().
[override virtual protected] void QLineEdit::keyPressEvent(QKeyEvent *event)
Reimplementa: QWidget::keyPressEvent(QKeyEvent *event).
Convierte la pulsación de tecla proporcionada event en una acción de edición de línea.
Si se pulsa «Retorno» o «Intro» y el texto actual es válido (o puede ser made valid por el validador), se emite la señal returnPressed().
Véase también Default Key Bindings.
[override virtual protected] void QLineEdit::keyReleaseEvent(QKeyEvent *e)
Reimplementa: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.
[override virtual] QSize QLineEdit::minimumSizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.
Devuelve el tamaño mínimo del campo de edición de línea.
El ancho devuelto suele ser suficiente para al menos un carácter.
[override virtual protected] void QLineEdit::mouseDoubleClickEvent(QMouseEvent *e)
Reimplementa: ` QWidget::mouseDoubleClickEvent(QMouseEvent *event)`.
[override virtual protected] void QLineEdit::mouseMoveEvent(QMouseEvent *e)
Reimplementa: QWidget::mouseMoveEvent(QMouseEvent *event).
[override virtual protected] void QLineEdit::mousePressEvent(QMouseEvent *e)
Reimplementa: ` QWidget::mousePressEvent(QMouseEvent *event)`.
[override virtual protected] void QLineEdit::mouseReleaseEvent(QMouseEvent *e)
Reimplementa: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.
[override virtual protected] void QLineEdit::paintEvent(QPaintEvent *)
Reimplementa: QWidget::paintEvent(QPaintEvent *event).
[slot] void QLineEdit::paste()
Inserta el texto del portapapeles en la posición del cursor, eliminando cualquier texto seleccionado, siempre que el campo de edición no esté en estado « read-only ».
Si el resultado final no fuera válido para el ` validator` actual, no ocurre nada.
Véanse también copy() y cut().
[slot] void QLineEdit::redo()
Vuelve a realizar la última operación si la opción «redo» es « available ».
[signal] void QLineEdit::returnPressed()
Esta señal se emite cuando se pulsa la tecla «Retorno» o «Intro».
Nota: Si se ha configurado « validator » () o « inputMask » () en el campo de edición, la señal «returnPressed()» solo se emitirá si la entrada cumple con « inputMask » () y « validator » () devuelve « QValidator::Acceptable ».
[slot] void QLineEdit::selectAll()
Selecciona todo el texto (lo resalta) y desplaza el cursor hasta el final.
Nota: Esto resulta útil cuando se ha insertado un valor por defecto, ya que si el usuario escribe antes de hacer clic en el widget, el texto seleccionado se borrará.
Véase también setSelection() y deselect().
[signal] void QLineEdit::selectionChanged()
Esta señal se emite cada vez que cambia la selección.
Véase también hasSelectedText() y selectedText().
int QLineEdit::selectionEnd() const
Devuelve el índice del carácter situado inmediatamente después de la selección en el campo de edición de línea (o -1 si no hay texto seleccionado).
Véase también selectedText(), selectionStart() y selectionLength().
int QLineEdit::selectionLength() const
Devuelve la longitud de la selección.
Véase también selectedText(), selectionStart() y selectionEnd().
int QLineEdit::selectionStart() const
Devuelve el índice del primer carácter seleccionado en el campo de edición de línea (o -1 si no hay texto seleccionado).
Véanse también selectedText(), selectionEnd() y selectionLength().
void QLineEdit::setCompleter(QCompleter *c)
Configura este campo de edición de línea para que ofrezca autocompletado a partir del complemento c. El modo de autocompletado se configura mediante QCompleter::setCompletionMode().
Para utilizar un QCompleter con un QValidator o un QLineEdit::inputMask, debes asegurarte de que el modelo proporcionado a QCompleter contenga entradas válidas. Puedes utilizar el QSortFilterProxyModel para garantizar que el modelo del QCompleter contenga únicamente entradas válidas.
Para eliminar el complemento y desactivar el autocompletado, pasa un ` nullptr`.
Véase también completer() y QCompleter.
void QLineEdit::setSelection(int start, int length)
Selecciona texto desde la posición start y con una longitud de length caracteres. Se admiten longitudes negativas.
Véase también deselect(), selectAll() y selectedText().
void QLineEdit::setTextMargins(const QMargins &margins)
Establece el ` margins ` alrededor del texto que hay dentro del marco.
Véase también textMargins().
void QLineEdit::setTextMargins(int left, int top, int right, int bottom)
Establece los márgenes alrededor del texto dentro del marco con los siguientes tamaños: left, top, right y bottom.
Véase también textMargins().
void QLineEdit::setValidator(const QValidator *v)
Establece el validador de los valores del campo de edición de línea en « v ».
Las señales « returnPressed()» y « editingFinished()» del campo de edición de línea solo se emitirán si « v » valida el contenido del campo de edición de línea como « Acceptable ». El usuario puede cambiar el contenido a cualquier valor « Intermediate » durante la edición, pero no podrá editar el texto a un valor que « v » valide como « Invalid ».
Esto permite restringir el texto que se almacenará una vez finalizada la edición, al tiempo que se deja a los usuarios suficiente libertad para editar el texto de un estado válido a otro.
Para eliminar el validador de entrada actual, pasa nullptr. La configuración inicial es no tener ningún validador de entrada (se acepta cualquier entrada hasta maxLength()).
Véase también validator(), hasAcceptableInput(), QIntValidator, QDoubleValidator y QRegularExpressionValidator.
[override virtual] QSize QLineEdit::sizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.
Devuelve un tamaño recomendado para el widget.
El ancho devuelto, en píxeles, suele ser suficiente para entre 15 y 20 caracteres aproximadamente.
[signal] void QLineEdit::textChanged(const QString &text)
Esta señal se emite cada vez que cambia el texto. El argumento « text » es el nuevo texto.
A diferencia de ` textEdited()`, esta señal también se emite cuando el texto se modifica mediante programación, por ejemplo, al llamar a ` setText()`.
Nota: Señalde notificador para la propiedad text.
[signal] void QLineEdit::textEdited(const QString &text)
Esta señal se emite cada vez que se modifica el texto. El argumento ` text ` es el nuevo texto.
A diferencia de ` textChanged()`, esta señal no se emite cuando el texto se modifica mediante programación, por ejemplo, al llamar a ` setText()`.
QMargins QLineEdit::textMargins() const
Devuelve los márgenes de texto del widget.
Véase también setTextMargins().
[override virtual] void QLineEdit::timerEvent(QTimerEvent *e)
Reimplementa: QObject::timerEvent(QTimerEvent *event).
[slot] void QLineEdit::undo()
Deshace la última operación si la opción «Deshacer» está activada ( available). Deselecciona cualquier selección actual y actualiza el punto inicial de la selección a la posición actual del cursor.
const QValidator *QLineEdit::validator() const
Devuelve un puntero al validador de entrada actual o ` nullptr ` si no se ha establecido ningún validador.
Véase también setValidator().
© 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.