QTextEdit Class

Documentación de las funciones miembro

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

Construye un QTextEdit vacío con el padre parent.

[explicit] QTextEdit::QTextEdit(const QString &text, QWidget *parent = nullptr)

Construye un QTextEdit con el padre parent. La edición de texto mostrará el texto text. El texto se interpreta como html.

[virtual noexcept] QTextEdit::~QTextEdit()

Destructor.

Qt::Alignment QTextEdit::alignment() const

Devuelve la alineación del párrafo actual.

Véase también setAlignment().

QString QTextEdit::anchorAt(const QPoint &pos) const

Devuelve la referencia del ancla en la posición pos, o una cadena vacía si no existe ancla en ese punto.

[slot] void QTextEdit::append(const QString &text)

Añade un nuevo párrafo con text al final de la edición de texto.

Véase también currentCharFormat() y QTextCursor::blockFormat().

[virtual protected] bool QTextEdit::canInsertFromMimeData(const QMimeData *source) const

Esta función devuelve true si el contenido del objeto de datos MIME, especificado por source, puede descodificarse e insertarse en el documento. Se llama, por ejemplo, cuando durante una operación de arrastre el ratón entra en este widget y es necesario determinar si es posible aceptar la operación de arrastrar y soltar.

Reimplemente esta función para habilitar el soporte de arrastrar y soltar para tipos MIME adicionales.

bool QTextEdit::canPaste() const

Devuelve si se puede pegar texto del portapapeles en el textedit.

[override virtual protected] void QTextEdit::changeEvent(QEvent *e)

Reimplementa: QFrame::changeEvent(QEvent *ev).

[slot] void QTextEdit::clear()

Borra todo el texto de la edición de texto.

Notas:

• El historial de deshacer/rehacer también se borra.
• currentCharFormat() se reinicia, a menos que textCursor() ya esté al principio del documento.

Véase también cut(), setPlainText(), y setHtml().

[override virtual protected] void QTextEdit::contextMenuEvent(QContextMenuEvent *event)

Reimplementa: QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e).

Muestra el menú contextual estándar creado con createStandardContextMenu().

Si no desea que la edición de texto tenga un menú contextual, puede establecer su contextMenuPolicy a Qt::NoContextMenu. Si desea personalizar el menú contextual, reimplemente esta función. Si desea ampliar el menú contextual estándar, reimplemente esta función, llame a createStandardContextMenu() y amplíe el menú devuelto.

La información sobre el evento se pasa en el objeto event.

void MyTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QTextEdit::copy()

Copia el texto seleccionado en el portapapeles.

Véase también copyAvailable().

[signal] void QTextEdit::copyAvailable(bool yes)

Esta señal se emite cuando se selecciona o deselecciona texto en la edición de texto.

Cuando se selecciona un texto, esta señal se emite con yes igual a true. Si no se ha seleccionado ningún texto o si se ha deseleccionado el texto seleccionado, esta señal se emite con yes puesto a false.

Si yes es verdadero, puede utilizarse copy() para copiar la selección en el portapapeles. Si yes es falso entonces copy() no hace nada.

Véase también selectionChanged().

[virtual protected] QMimeData *QTextEdit::createMimeDataFromSelection() const

Esta función devuelve un nuevo objeto de datos MIME para representar el contenido de la selección actual de la edición de texto. Es llamada cuando la selección necesita ser encapsulada en un nuevo objeto QMimeData; por ejemplo, cuando se inicia una operación de arrastrar y soltar, o cuando se copian datos al portapapeles.

Si reimplementa esta función, tenga en cuenta que la propiedad del objeto QMimeData devuelto se pasa a la persona que llama. La selección puede recuperarse utilizando la función textCursor().

QMenu *QTextEdit::createStandardContextMenu()

Esta función crea el menú contextual estándar que se muestra cuando el usuario hace clic en la edición de texto con el botón derecho del ratón. Se llama desde el manejador por defecto contextMenuEvent(). La propiedad del menú contextual se transfiere a la persona que realiza la llamada.

Le recomendamos que utilice en su lugar la versión createStandardContextMenu(QPoint) que habilitará las acciones sensibles al lugar donde el usuario hizo clic.

QMenu *QTextEdit::createStandardContextMenu(const QPoint &position)

Esta función crea el menú contextual estándar que se muestra cuando el usuario hace clic en la edición de texto con el botón derecho del ratón. Se llama desde el manejador por defecto contextMenuEvent() y toma el position en coordenadas del documento donde se hizo clic con el ratón. Esto puede habilitar acciones que son sensibles a la posición donde el usuario hizo clic. La propiedad del menú emergente se transfiere a quien lo llama.

QTextCharFormat QTextEdit::currentCharFormat() const

Devuelve el formato char que se utiliza al insertar texto nuevo.

Véase también setCurrentCharFormat().

[signal] void QTextEdit::currentCharFormatChanged(const QTextCharFormat &f)

Esta señal se emite si el formato actual de los caracteres ha cambiado, por ejemplo a causa de un cambio de posición del cursor.

El nuevo formato es f.

Véase también setCurrentCharFormat().

QFont QTextEdit::currentFont() const

Devuelve la fuente del formato actual.

Véase también setCurrentFont(), setFontFamily() y setFontPointSize().

QTextCursor QTextEdit::cursorForPosition(const QPoint &pos) const

devuelve un QTextCursor en la posición pos (en coordenadas de la ventana gráfica).

[signal] void QTextEdit::cursorPositionChanged()

Esta señal se emite cada vez que cambia la posición del cursor.

QRect QTextEdit::cursorRect() const

devuelve un rectángulo (en coordenadas de la ventana gráfica) que incluye el cursor de la edición de texto.

QRect QTextEdit::cursorRect(const QTextCursor &cursor) const

devuelve un rectángulo (en coordenadas de la ventana gráfica) que incluye cursor.

[slot] void QTextEdit::cut()

Copia el texto seleccionado en el portapapeles y lo borra de la edición de texto.

Si no hay texto seleccionado no ocurre nada.

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

[override virtual protected] void QTextEdit::dragEnterEvent(QDragEnterEvent *e)

Reimplementa: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QTextEdit::dragLeaveEvent(QDragLeaveEvent *e)

Reimplementa: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QTextEdit::dragMoveEvent(QDragMoveEvent *e)

Reimplementa: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QTextEdit::dropEvent(QDropEvent *e)

Reimplementa: QAbstractScrollArea::dropEvent(QDropEvent *event).

void QTextEdit::ensureCursorVisible()

Asegura que el cursor es visible desplazando la edición de texto si es necesario.

QList<QTextEdit::ExtraSelection> QTextEdit::extraSelections() const

Devuelve las selecciones extra establecidas previamente.

Véase también setExtraSelections().

bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

Busca la siguiente ocurrencia de la cadena, exp, utilizando la options dada. Devuelve true si se ha encontrado exp y cambia el cursor para seleccionar la coincidencia; en caso contrario devuelve false.

bool QTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

Busca la siguiente ocurrencia que coincida con la expresión regular, exp, utilizando la dirección options.

Devuelve true si se ha encontrado una coincidencia y cambia el cursor para seleccionar la coincidencia; en caso contrario devuelve false.

[override virtual protected] void QTextEdit::focusInEvent(QFocusEvent *e)

Reimplementa: QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] bool QTextEdit::focusNextPrevChild(bool next)

Reimplementa: QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QTextEdit::focusOutEvent(QFocusEvent *e)

Reimplementa: QWidget::focusOutEvent(QFocusEvent *event).

QString QTextEdit::fontFamily() const

Devuelve la familia de fuentes del formato actual.

Véase también setFontFamily(), setCurrentFont() y setFontPointSize().

bool QTextEdit::fontItalic() const

Devuelve true si la fuente del formato actual es cursiva; en caso contrario devuelve false.

Véase también setFontItalic().

qreal QTextEdit::fontPointSize() const

Devuelve el tamaño en puntos de la fuente del formato actual.

Véase también setFontFamily(), setCurrentFont() y setFontPointSize().

bool QTextEdit::fontUnderline() const

Devuelve true si la fuente del formato actual está subrayada; en caso contrario devuelve false.

Véase también setFontUnderline().

int QTextEdit::fontWeight() const

Devuelve el peso de la fuente del formato actual.

Véase también setFontWeight(), setCurrentFont(), setFontPointSize() y QFont::Weight.

[override virtual protected] void QTextEdit::inputMethodEvent(QInputMethodEvent *e)

Reimplementa: QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QTextEdit::inputMethodQuery(Qt::InputMethodQuery property) const

Reimplementa: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[virtual protected] void QTextEdit::insertFromMimeData(const QMimeData *source)

Esta función inserta el contenido del objeto de datos MIME, especificado por source, en la edición de texto en la posición actual del cursor. Es llamada siempre que se inserta texto como resultado de una operación de pegado en el portapapeles, o cuando la edición de texto acepta datos de una operación de arrastrar y soltar.

Reimplemente esta función para habilitar el soporte de arrastrar y soltar para tipos MIME adicionales.

[slot] void QTextEdit::insertHtml(const QString &text)

Ranura de conveniencia que inserta text que se asume que es de formato html en la posición actual del cursor.

Es equivalente a:

edit->textCursor().insertHtml(fragment);

[slot] void QTextEdit::insertPlainText(const QString &text)

Ranura de conveniencia que inserta text en la posición actual del cursor.

Equivale a

edit->textCursor().insertText(text);

[override virtual protected] void QTextEdit::keyPressEvent(QKeyEvent *e)

Reimplementa: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

[override virtual protected] void QTextEdit::keyReleaseEvent(QKeyEvent *e)

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

[virtual invokable] QVariant QTextEdit::loadResource(int type, const QUrl &name)

Carga el recurso especificado por los campos type y name.

Esta función es una extensión de QTextDocument::loadResource().

Véase también QTextDocument::loadResource().

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

Fusiona las propiedades especificadas en modifier en el formato de caracteres actual llamando a QTextCursor::mergeCharFormat en el cursor del editor. Si el editor tiene una selección, las propiedades de modifier se aplican directamente a la selección.

Véase también QTextCursor::mergeCharFormat().

[override virtual protected] void QTextEdit::mouseDoubleClickEvent(QMouseEvent *e)

Reimplementa: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

[override virtual protected] void QTextEdit::mouseMoveEvent(QMouseEvent *e)

Reimplementa: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

[override virtual protected] void QTextEdit::mousePressEvent(QMouseEvent *e)

Reimplementa: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

[override virtual protected] void QTextEdit::mouseReleaseEvent(QMouseEvent *e)

Reimplementa: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

void QTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)

Mueve el cursor realizando la operación dada operation.

Si mode es QTextCursor::KeepAnchor, el cursor selecciona el texto sobre el que se mueve. Es el mismo efecto que consigue el usuario cuando mantiene pulsada la tecla Mayúsculas y mueve el cursor con las teclas del cursor.

Véase también QTextCursor::movePosition().

[override virtual protected] void QTextEdit::paintEvent(QPaintEvent *event)

Reimplementa: QAbstractScrollArea::paintEvent(QPaintEvent *event).

Este manejador de eventos puede ser reimplementado en una subclase para recibir eventos de pintura pasados en event. Normalmente no es necesario reimplementar esta función en una subclase de QTextEdit.

[slot] void QTextEdit::paste()

Pega el texto del portapapeles en la edición de texto en la posición actual del cursor.

Si no hay texto en el portapapeles no ocurre nada.

Para cambiar el comportamiento de esta función, es decir, para modificar lo que QTextEdit puede pegar y cómo se pega, reimplemente las funciones virtuales canInsertFromMimeData() y insertFromMimeData().

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

void QTextEdit::print(QPagedPaintDevice *printer) const

Función de conveniencia para imprimir el documento de edición de texto a la dirección printer. Esto es equivalente a llamar directamente al método print en el documento excepto que esta función también soporta QPrinter::Selection como rango de impresión.

Ver también QTextDocument::print().

[slot] void QTextEdit::redo()

Rehace la última operación.

Si no hay ninguna operación que rehacer, es decir, no hay ningún paso de rehacer en el historial de deshacer/rehacer, no ocurre nada.

Véase también undo().

[signal] void QTextEdit::redoAvailable(bool available)

Esta señal se emite cuando las operaciones de rehacer están disponibles (available es verdadero) o no disponibles (available es falso).

[override virtual protected] void QTextEdit::resizeEvent(QResizeEvent *e)

Reimplementa: QAbstractScrollArea::resizeEvent(QResizeEvent *event).

[override virtual protected] void QTextEdit::scrollContentsBy(int dx, int dy)

Reimplementa: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

[slot] void QTextEdit::scrollToAnchor(const QString &name)

Desplaza la edición de texto para que el ancla con el name dado sea visible; no hace nada si el name está vacío, o ya es visible, o no se encuentra.

[slot] void QTextEdit::selectAll()

Selecciona todo el texto.

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

[signal] void QTextEdit::selectionChanged()

Esta señal se emite cada vez que cambia la selección.

Véase también copyAvailable().

[slot] void QTextEdit::setAlignment(Qt::Alignment a)

Establece la alineación del párrafo actual en a. Las alineaciones válidas son Qt::AlignLeft, Qt::AlignRight, Qt::AlignJustify y Qt::AlignCenter (que se centra horizontalmente).

Véase también alignment().

void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

Establece el formato char que se utilizará al insertar texto nuevo en format llamando a QTextCursor::setCharFormat() en el cursor del editor. Si el editor tiene una selección, el formato char se aplica directamente a la selección.

Véase también currentCharFormat().

[slot] void QTextEdit::setCurrentFont(const QFont &f)

Establece la fuente del formato actual en f.

Véase también currentFont(), setFontPointSize() y setFontFamily().

void QTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)

Esta función permite marcar temporalmente ciertas regiones del documento con un color determinado, especificado como selections. Esto puede ser útil, por ejemplo, en un editor de programación para marcar toda una línea de texto con un color de fondo determinado para indicar la existencia de un punto de interrupción.

Véase también QTextEdit::ExtraSelection y extraSelections().

[slot] void QTextEdit::setFontFamily(const QString &fontFamily)

Establece la familia de fuentes del formato actual en fontFamily.

Véase también fontFamily() y setCurrentFont().

[slot] void QTextEdit::setFontItalic(bool italic)

Si italic es verdadero, establece el formato actual en cursiva; en caso contrario, establece el formato actual en no cursiva.

Véase también fontItalic().

[slot] void QTextEdit::setFontPointSize(qreal s)

Establece el tamaño de punto del formato actual en s.

Tenga en cuenta que si s es cero o negativo, el comportamiento de esta función no está definido.

Véase también fontPointSize(), setCurrentFont(), y setFontFamily().

[slot] void QTextEdit::setFontUnderline(bool underline)

Si underline es verdadero, establece el formato actual en subrayado; en caso contrario, establece el formato actual en no subrayado.

Véase también fontUnderline().

[slot] void QTextEdit::setFontWeight(int weight)

Establece el peso de la fuente del formato actual al valor dado weight, donde el valor utilizado está en el rango definido por el enum QFont::Weight.

Véase también fontWeight(), setCurrentFont(), y setFontFamily().

[slot] void QTextEdit::setPlainText(const QString &text)

Cambia el texto de la edición de texto a la cadena text. Se elimina cualquier texto anterior.

Notas:

• text se interpreta como texto sin formato.
• También se borra el historial de deshacer/rehacer.
• currentCharFormat() se reinicia, a menos que textCursor() ya esté al principio del documento.

Véase también toPlainText().

[slot] void QTextEdit::setText(const QString &text)

Establece la edición de texto text. El texto puede ser texto plano o HTML y la edición de texto intentará adivinar el formato correcto.

Utilice setHtml() o setPlainText() directamente para evitar que el editor de texto lo adivine.

Véase también toPlainText() y toHtml().

[slot] void QTextEdit::setTextBackgroundColor(const QColor &c)

Establece el color de fondo del texto del formato actual en c.

Véase también textBackgroundColor().

[slot] void QTextEdit::setTextColor(const QColor &c)

Establece el color del texto del formato actual en c.

Véase también textColor().

void QTextEdit::setTextCursor(const QTextCursor &cursor)

Establece el visible cursor.

Véase también textCursor().

[override virtual protected] void QTextEdit::showEvent(QShowEvent *)

Reimplementa: QWidget::showEvent(QShowEvent *event).

QColor QTextEdit::textBackgroundColor() const

Devuelve el color de fondo del texto del formato actual.

Véase también setTextBackgroundColor().

[signal] void QTextEdit::textChanged()

Esta señal se emite siempre que cambia el contenido del documento; por ejemplo, cuando se inserta o elimina texto, o cuando se aplica formato.

QColor QTextEdit::textColor() const

Devuelve el color del texto del formato actual.

Véase también setTextColor().

QTextCursor QTextEdit::textCursor() const

Devuelve una copia de QTextCursor que representa el cursor visible en ese momento. Tenga en cuenta que los cambios en el cursor devuelto no afectan al cursor de QTextEdit; utilice setTextCursor() para actualizar el cursor visible.

Véase también setTextCursor().

QString QTextEdit::toPlainText() const

QString QTextEdit::toPlainText() const

Devuelve el texto de la edición de texto como texto plano.

Ver también QTextEdit::setPlainText().

[slot] void QTextEdit::undo()

Deshace la última operación.

Si no hay ninguna operación que deshacer, es decir, no hay ningún paso de deshacer en el historial de deshacer/rehacer, no ocurre nada.

Véase también redo().

[signal] void QTextEdit::undoAvailable(bool available)

Esta señal se emite cuando las operaciones de deshacer están disponibles (available es verdadero) o no disponibles (available es falso).

[override virtual protected] void QTextEdit::wheelEvent(QWheelEvent *e)

Reimplementa: QAbstractScrollArea::wheelEvent(QWheelEvent *e).

[slot] void QTextEdit::zoomIn(int range = 1)

Amplía el texto haciendo que el tamaño de fuente base sea range puntos mayor y recalculando todos los tamaños de fuente para que sean del nuevo tamaño. Esto no cambia el tamaño de ninguna imagen.

Véase también zoomOut().

[slot] void QTextEdit::zoomOut(int range = 1)

Reduce el texto haciendo que el tamaño de la fuente base sea range puntos más pequeño y recalculando todos los tamaños de fuente para que sean del nuevo tamaño. Esto no cambia el tamaño de ninguna imagen.

Véase también zoomIn().