QLineEdit Class

Documentación de funciones miembro

[explicit] QLineEdit::QLineEdit(QWidget *parent = nullptr)

Construye una edición de línea sin texto.

La longitud máxima del texto es de 32767 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)

Construye una edición de línea que contiene el texto contents como hijo de parent.

La posición del cursor se fija al final de la línea y la longitud máxima del texto a 32767 caracteres.

Véase también text() y setMaxLength().

[virtual noexcept] QLineEdit::~QLineEdit()

Destruye la edición de línea.

void QLineEdit::addAction(QAction *action, QLineEdit::ActionPosition position)

Añade action a la lista de acciones en position.

QAction *QLineEdit::addAction(const QIcon &icon, QLineEdit::ActionPosition position)

Crea una nueva acción con el icon dado en el position.

void QLineEdit::backspace()

Si no hay ningún 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 algún texto seleccionado, el cursor se desplaza al principio del texto seleccionado, y se borra el texto seleccionado.

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 de la edición de línea.

Véase también setText() y insert().

QCompleter *QLineEdit::completer() const

Devuelve el QCompleter actual que proporciona terminaciones.

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 desea que la línea de edición tenga un menú contextual, puede establecer su contextMenuPolicy a Qt::NoContextMenu. Para personalizar el menú contextual, reimplemente esta función. Para ampliar el menú contextual estándar, reimplemente esta función, llame a createStandardContextMenu(), y amplíe 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 en el portapapeles, si existe, 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 pulsa sobre la línea de edición con el botón derecho del ratón. Se llama desde el manejador por defecto contextMenuEvent(). La propiedad del menú emergente se transfiere al llamador.

void QLineEdit::cursorBackward(bool mark, int steps = 1)

Desplaza el cursor hacia atrás steps caracteres. Si mark es verdadero, cada carácter desplazado 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 delante steps caracteres. Si mark es verdadero, cada carácter desplazado 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 bajo el 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éase también setCursorPosition() y cursorPosition().

[protected] QRect QLineEdit::cursorRect() const

Devuelve un rectángulo que incluye el cursor de edición de línea.

void QLineEdit::cursorWordBackward(bool mark)

Mueve el cursor una palabra hacia atrás. Si mark es verdadero, la palabra también se selecciona.

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 se selecciona.

Véase también cursorWordBackward().

[slot] void QLineEdit::cut()

Copia el texto seleccionado en el portapapeles y lo borra, si lo hay, y si echoMode() es Normal.

Si el validador actual no permite borrar el texto seleccionado, cut() copiará sin borrar.

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 se borra el texto seleccionado.

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 utiliza la tecla Retorno o Intro, o si la edición de línea pierde el foco y su contenido ha cambiado desde la última vez que se emitió esta señal.

void QLineEdit::end(bool mark)

Mueve el cursor de texto al final de la línea a menos que ya esté allí. Si mark es verdadero, el texto se selecciona hacia la última posición. En caso contrario, cualquier texto seleccionado se deselecciona si se mueve 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 esté allí. Si mark es verdadero, el texto se selecciona hacia la primera posición. En caso contrario, cualquier texto seleccionado se deselecciona si se mueve el cursor.

Véase también end().

[virtual protected] void QLineEdit::initStyleOption(QStyleOptionFrame *option) const

Inicializa option con los valores de este QLineEdit. Este método es útil para subclases cuando necesitan un QStyleOptionFrame, pero no quieren rellenar toda la información ellos mismos.

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(Qt::InputMethodQuery query) const.

[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 el uso de una tecla hace que la llamada a validate() de un validador devuelva Invalid. Otro caso es cuando se intenta introducir más caracteres por encima de la longitud máxima de la línea de edición.

void QLineEdit::insert(const QString &newText)

Elimina cualquier texto seleccionado, inserta newText, y valida el resultado. Si es válido, establece el nuevo texto como el nuevo contenido de la edición de línea.

Véase también setText() y clear().

[override virtual protected] void QLineEdit::keyPressEvent(QKeyEvent *event)

Reimplementa: QWidget::keyPressEvent(QKeyEvent *event).

Convierte la pulsación de tecla dada event en una acción de edición de línea.

Si se utiliza Return o Enter 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 un tamaño mínimo para la edición de la 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, borrando cualquier texto seleccionado, siempre que la edición de línea no sea read-only.

Si el resultado final no es válido para la actual validator, no ocurre nada.

Véase también copy() y cut().

[slot] void QLineEdit::redo()

Rehace la última operación si rehacer es available.

[signal] void QLineEdit::returnPressed()

Esta señal se emite cuando se utiliza la tecla Return o Enter.

[slot] void QLineEdit::selectAll()

Selecciona todo el texto (lo resalta) y mueve el cursor hasta el final.

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 directamente después de la selección en la 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 la edición de línea (o -1 si no hay texto seleccionado).

Véase también selectedText(), selectionEnd() y selectionLength().

void QLineEdit::setCompleter(QCompleter *c)

Establece esta edición de línea para proporcionar autocompletado desde el completador, c. El modo de completado se establece utilizando QCompleter::setCompletionMode().

Para utilizar QCompleter con QValidator o QLineEdit::inputMask, debe asegurarse de que el modelo proporcionado a QCompleter contiene entradas válidas. Puede utilizar QSortFilterProxyModel para asegurarse de que el modelo de QCompleter sólo contiene entradas válidas.

Para eliminar el completador y desactivar el autocompletado, pase un nullptr.

Véase también completer() y QCompleter.

void QLineEdit::setSelection(int start, int length)

Selecciona texto a partir de la posición start y para length caracteres. Se permiten longitudes negativas.

Véase también deselect(), selectAll() y selectedText().

void QLineEdit::setTextMargins(const QMargins &margins)

Establece el margins alrededor del texto 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 para que tengan los tamaños left, top, right, y bottom.

Véase también textMargins().

void QLineEdit::setValidator(const QValidator *v)

Establece el validador de valores de edición de línea en v.

Las señales de edición de línea returnPressed() y editingFinished() sólo se emitirán si v valida el contenido de la edición de línea como Acceptable. El usuario puede cambiar el contenido a cualquier valor de 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á cuando se realice la edición, dejando al mismo tiempo a los usuarios la libertad suficiente para editar el texto de un estado válido a otro.

Para eliminar el validador de entrada actual, pase nullptr. La configuración inicial es no tener validador de entrada (cualquier entrada es aceptada 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.

La anchura devuelta, en píxeles, suele ser suficiente para unos 15 o 20 caracteres.

[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, llamando a setText().

[signal] void QLineEdit::textEdited(const QString &text)

Esta señal se emite cada vez que se edita 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, llamando 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 deshacer es available. Deselecciona cualquier selección actual y actualiza el inicio 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().