QPlainTextEdit Class

Documentación de las funciones miembro

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

Construye un QPlainTextEdit vacío con el padre parent.

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

Construye un QPlainTextEdit con el padre parent. La edición de texto mostrará el texto plano text.

[virtual noexcept] QPlainTextEdit::~QPlainTextEdit()

Destructor.

QString QPlainTextEdit::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 QPlainTextEdit::appendHtml(const QString &html)

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

appendPlainText()

[slot] void QPlainTextEdit::appendPlainText(const QString &text)

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

Véase también appendHtml().

[protected] QRectF QPlainTextEdit::blockBoundingGeometry(const QTextBlock &block) const

Devuelve el rectángulo delimitador del texto block en coordenadas de contenido. Traduzca el rectángulo con contentOffset() para obtener coordenadas visuales en la ventana gráfica.

Véase también firstVisibleBlock() y blockBoundingRect().

[protected] QRectF QPlainTextEdit::blockBoundingRect(const QTextBlock &block) const

Devuelve el rectángulo delimitador del texto block en las coordenadas propias del bloque.

Véase también blockBoundingGeometry().

[signal] void QPlainTextEdit::blockCountChanged(int newBlockCount)

Esta señal se emite cada vez que cambia el recuento de bloques. El nuevo recuento de bloques se pasa en newBlockCount.

[virtual protected] bool QPlainTextEdit::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 el arrastre.

bool QPlainTextEdit::canPaste() const

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

[slot] void QPlainTextEdit::centerCursor()

Desplaza el documento para centrar el cursor verticalmente.

Véase también ensureCursorVisible() y centerOnScroll.

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

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

[slot] void QPlainTextEdit::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() y setPlainText().

[protected] QPointF QPlainTextEdit::contentOffset() const

Devuelve el origen del contenido en coordenadas de la ventana gráfica.

El origen del contenido de una edición de texto plano es siempre la esquina superior izquierda del primer bloque de texto visible. El desplazamiento del contenido es diferente de (0,0) cuando el texto se ha desplazado horizontalmente, o cuando el primer bloque visible se ha desplazado parcialmente fuera de la pantalla, es decir, el texto visible no comienza con la primera línea del primer bloque visible, o cuando el primer bloque visible es el primer bloque y el editor muestra un margen.

Véase también firstVisibleBlock(), horizontalScrollBar() y verticalScrollBar().

[override virtual protected] void QPlainTextEdit::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 MyQPlainTextEdit::contextMenuEvent(QContextMenuEvent *event)
{
    QMenu *menu = createStandardContextMenu();
    menu->addAction(tr("My Menu Item"));
    //...
    menu->exec(event->globalPos());
    delete menu;
}

[slot] void QPlainTextEdit::copy()

Copia el texto seleccionado en el portapapeles.

Véase también copyAvailable().

[signal] void QPlainTextEdit::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 *QPlainTextEdit::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 *QPlainTextEdit::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 *QPlainTextEdit::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 QPlainTextEdit::currentCharFormat() const

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

Véase también setCurrentCharFormat().

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

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

[signal] void QPlainTextEdit::cursorPositionChanged()

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

QRect QPlainTextEdit::cursorRect() const

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

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

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

[slot] void QPlainTextEdit::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().

QTextDocument *QPlainTextEdit::document() const

Devuelve un puntero al documento subyacente.

Véase también setDocument().

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

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

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

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

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

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

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

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

void QPlainTextEdit::ensureCursorVisible()

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

Véase también centerCursor() y centerOnScroll.

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

Devuelve las selecciones extra establecidas previamente.

Véase también setExtraSelections().

bool QPlainTextEdit::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 QPlainTextEdit::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.

[protected] QTextBlock QPlainTextEdit::firstVisibleBlock() const

Devuelve el primer bloque visible.

Véase también blockBoundingRect().

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

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

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

Reimplementa: QWidget::focusNextPrevChild(bool next).

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

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

[protected] QAbstractTextDocumentLayout::PaintContext QPlainTextEdit::getPaintContext() const

Devuelve el contexto de pintura para viewport(), útil sólo cuando se reimplementa paintEvent().

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

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

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

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

[virtual protected] void QPlainTextEdit::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. Se llama 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.

[slot] void QPlainTextEdit::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 QPlainTextEdit::keyPressEvent(QKeyEvent *e)

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

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

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

[virtual] QVariant QPlainTextEdit::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 QPlainTextEdit::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().

[signal] void QPlainTextEdit::modificationChanged(bool changed)

Esta señal se emite siempre que el contenido del documento cambia de forma que afecta al estado de modificación. Si changed es verdadero, el documento ha sido modificado; en caso contrario, es falso.

Por ejemplo, llamar a setModified(false) en un documento y luego insertar texto hace que se emita la señal. Si deshaces esa operación, haciendo que el documento vuelva a su estado original sin modificar, la señal se emitirá de nuevo.

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

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

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

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

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

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

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

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

void QPlainTextEdit::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 QPlainTextEdit::paintEvent(QPaintEvent *e)

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

[slot] void QPlainTextEdit::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 QPlainTextEdit puede pegar y cómo se pega, reimplemente las funciones virtuales canInsertFromMimeData() y insertFromMimeData().

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

void QPlainTextEdit::print(QPagedPaintDevice *printer) const

Función de conveniencia para imprimir el documento de edición de texto en 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 QPlainTextEdit::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 QPlainTextEdit::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 QPlainTextEdit::resizeEvent(QResizeEvent *e)

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

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

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

[slot] void QPlainTextEdit::selectAll()

Selecciona todo el texto.

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

[signal] void QPlainTextEdit::selectionChanged()

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

Véase también copyAvailable().

void QPlainTextEdit::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().

void QPlainTextEdit::setDocument(QTextDocument *document)

Hace que document sea el nuevo documento del editor de texto.

El padre QObject del documento proporcionado sigue siendo el propietario del objeto. Si el documento actual es hijo del editor de texto, entonces se elimina.

El documento debe tener un diseño que herede QPlainTextDocumentLayout (véase QTextDocument::setDocumentLayout()).

Véase también document().

void QPlainTextEdit::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 QPlainTextEdit::setPlainText(const QString &text)

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

text se interpreta como texto sin formato.

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 toPlainText().

void QPlainTextEdit::setTextCursor(const QTextCursor &cursor)

Establece el visible cursor.

Véase también textCursor().

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

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

[signal] void QPlainTextEdit::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.

QTextCursor QPlainTextEdit::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 QPlainTextEdit; utilice setTextCursor() para actualizar el cursor visible.

Véase también setTextCursor().

QString QPlainTextEdit::toPlainText() const

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

Véase también QPlainTextEdit::setPlainText().

[slot] void QPlainTextEdit::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 QPlainTextEdit::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).

[signal] void QPlainTextEdit::updateRequest(const QRect &rect, int dy)

Esta señal se emite cuando el documento de texto necesita una actualización del rect especificado. Si el texto se desplaza, rect cubrirá toda el área de la ventana gráfica. Si el texto se desplaza verticalmente, dy transporta la cantidad de píxeles que se desplazó la ventana gráfica.

El propósito de la señal es soportar widgets extra en subclases de edición de texto plano que, por ejemplo, muestren números de línea, puntos de interrupción u otra información extra.

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

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

[slot] void QPlainTextEdit::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 QPlainTextEdit::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().