En esta página

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

Edición de línea que muestra un mensaje de saludo

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.

TeclaAcción
Flecha izquierdaMueve el cursor un carácter hacia la izquierda.
Mayús + Flecha izquierdaMueve y selecciona el texto un carácter hacia la izquierda.
Flecha derechaMueve el cursor un carácter a la derecha.
Mayús + Flecha derechaMueve y selecciona el texto un carácter hacia la derecha.
InicioMueve el cursor al principio de la línea.
FinMueve el cursor al final de la línea.
RetrocesoBorra el carácter situado a la izquierda del cursor.
Ctrl+RetrocesoBorra la palabra situada a la izquierda del cursor.
SuprimirBorra el carácter situado a la derecha del cursor.
Ctrl+SuprElimina la palabra situada a la derecha del cursor.
Ctrl+ASelecciona todo.
Ctrl+CCopia el texto seleccionado al portapapeles.
Ctrl+InsertCopia el texto seleccionado al portapapeles.
Ctrl+KBorra hasta el final de la línea.
Ctrl+VPega el texto del portapapeles en el campo de edición.
Mayús+InsertPega el texto del portapapeles en el campo de edición.
Ctrl+XElimina el texto seleccionado y lo copia al portapapeles.
Mayús+SuprElimina el texto seleccionado y lo copia al portapapeles.
Ctrl+ZDeshace la última operación.
Ctrl+YRepite 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.

ConstanteValorDescripción
QLineEdit::LeadingPosition0El 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::TrailingPosition1El 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.

ConstanteValorDescripción
QLineEdit::Normal0Muestra los caracteres a medida que se introducen. Este es el valor por defecto.
QLineEdit::NoEcho1No muestra nada. Esto puede ser adecuado para contraseñas en las que incluso la longitud de la contraseña debe mantenerse en secreto.
QLineEdit::Password2Muestra caracteres de enmascaramiento de contraseña dependientes de la plataforma en lugar de los caracteres introducidos realmente.
QLineEdit::PasswordEchoOnEdit3Muestra 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áscaraDefine el Category de caracteres de entrada que se consideran válidos en esta posición.
MetacaracteresTienen diversos significados especiales (véanse los detalles más abajo).
SeparadoresTodos 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áscaraSignificado
ASe requiere un carácter de la categoría «Letra», como A-Z o a-z.
aSe permite un carácter de la categoría «Letra», pero no es obligatorio.
NCarácter de la categoría «Letra» o «Número» obligatorio, como A-Z, a-z, 0-9.
nSe permite un carácter de la categoría «Letra» o «Número», pero no es obligatorio.
XSe requiere cualquier carácter que no sea un espacio en blanco.
xSe permite cualquier carácter que no sea un espacio en blanco, pero no es obligatorio.
9Se requiere un carácter de la categoría «Número», como 0-9.
0Se permite un carácter de la categoría «Número», pero no es obligatorio.
DSe requiere un carácter de la categoría «Número» y mayor que cero, como 1-9.
dSe 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.
HCarácter hexadecimal obligatorio. A-F, a-f, 0-9.
hSe permite un carácter hexadecimal, pero no es obligatorio.
BSe requiere un carácter binario. 0-1.
bSe permite un carácter binario, pero no es obligatorio.
MetacarácterSignificado
>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.
;cFinaliza 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áscaraNotas
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-00Fecha 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.