QPlainTextEdit Class
La clase QPlainTextEdit proporciona un widget que se utiliza para editar y mostrar texto sin formato. Más información...
| Encabezado: | #include <QPlainTextEdit> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QAbstractScrollArea |
- Lista de todos los miembros, incluidos los heredados
- QPlainTextEdit forma parte de las API de procesamiento de texto enriquecido.
Tipos públicos
| enum | LineWrapMode { NoWrap, WidgetWidth } |
Propiedades
|
|
Funciones públicas
| QPlainTextEdit(QWidget *parent = nullptr) | |
| QPlainTextEdit(const QString &text, QWidget *parent = nullptr) | |
| virtual | ~QPlainTextEdit() |
| QString | anchorAt(const QPoint &pos) const |
| bool | backgroundVisible() const |
| int | blockCount() const |
| bool | canPaste() const |
| bool | centerOnScroll() const |
| QMenu * | createStandardContextMenu() |
| QMenu * | createStandardContextMenu(const QPoint &position) |
| QTextCharFormat | currentCharFormat() const |
| QTextCursor | cursorForPosition(const QPoint &pos) const |
| QRect | cursorRect() const |
| QRect | cursorRect(const QTextCursor &cursor) const |
| int | cursorWidth() const |
| QTextDocument * | document() const |
| QString | documentTitle() const |
| void | ensureCursorVisible() |
| QList<QTextEdit::ExtraSelection> | extraSelections() const |
| bool | find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags()) |
| bool | find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags()) |
| bool | isReadOnly() const |
| bool | isUndoRedoEnabled() const |
| QPlainTextEdit::LineWrapMode | lineWrapMode() const |
| virtual QVariant | loadResource(int type, const QUrl &name) |
| int | maximumBlockCount() const |
| void | mergeCurrentCharFormat(const QTextCharFormat &modifier) |
| void | moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor) |
| bool | overwriteMode() const |
| QString | placeholderText() const |
| void | print(QPagedPaintDevice *printer) const |
| void | setBackgroundVisible(bool visible) |
| void | setCenterOnScroll(bool enabled) |
| void | setCurrentCharFormat(const QTextCharFormat &format) |
| void | setCursorWidth(int width) |
| void | setDocument(QTextDocument *document) |
| void | setDocumentTitle(const QString &title) |
| void | setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections) |
| void | setLineWrapMode(QPlainTextEdit::LineWrapMode mode) |
| void | setMaximumBlockCount(int maximum) |
| void | setOverwriteMode(bool overwrite) |
| void | setPlaceholderText(const QString &placeholderText) |
| void | setReadOnly(bool ro) |
| void | setTabChangesFocus(bool b) |
| void | setTabStopDistance(qreal distance) |
| void | setTextCursor(const QTextCursor &cursor) |
| void | setTextInteractionFlags(Qt::TextInteractionFlags flags) |
| void | setUndoRedoEnabled(bool enable) |
| void | setWordWrapMode(QTextOption::WrapMode policy) |
| bool | tabChangesFocus() const |
| qreal | tabStopDistance() const |
| QTextCursor | textCursor() const |
| Qt::TextInteractionFlags | textInteractionFlags() const |
| QString | toPlainText() const |
| QTextOption::WrapMode | wordWrapMode() const |
Funciones públicas reimplementadas
| virtual QVariant | inputMethodQuery(Qt::InputMethodQuery property) const override |
Ranuras públicas
| void | appendHtml(const QString &html) |
| void | appendPlainText(const QString &text) |
| void | centerCursor() |
| void | clear() |
| void | copy() |
| void | cut() |
| void | insertPlainText(const QString &text) |
| void | paste() |
| void | redo() |
| void | selectAll() |
| void | setPlainText(const QString &text) |
| void | undo() |
| void | zoomIn(int range = 1) |
| void | zoomOut(int range = 1) |
Señales
| void | blockCountChanged(int newBlockCount) |
| void | copyAvailable(bool yes) |
| void | cursorPositionChanged() |
| void | modificationChanged(bool changed) |
| void | redoAvailable(bool available) |
| void | selectionChanged() |
| void | textChanged() |
| void | undoAvailable(bool available) |
| void | updateRequest(const QRect &rect, int dy) |
Funciones protegidas
| QRectF | blockBoundingGeometry(const QTextBlock &block) const |
| QRectF | blockBoundingRect(const QTextBlock &block) const |
| virtual bool | canInsertFromMimeData(const QMimeData *source) const |
| QPointF | contentOffset() const |
| virtual QMimeData * | createMimeDataFromSelection() const |
| QTextBlock | firstVisibleBlock() const |
| QAbstractTextDocumentLayout::PaintContext | getPaintContext() const |
| virtual void | insertFromMimeData(const QMimeData *source) |
Funciones protegidas reimplementadas
| virtual void | changeEvent(QEvent *e) 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 bool | focusNextPrevChild(bool next) override |
| virtual void | focusOutEvent(QFocusEvent *e) override |
| virtual void | inputMethodEvent(QInputMethodEvent *e) override |
| virtual void | keyPressEvent(QKeyEvent *e) 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 *e) override |
| virtual void | resizeEvent(QResizeEvent *e) override |
| virtual void | scrollContentsBy(int dx, int dy) override |
| virtual void | showEvent(QShowEvent *) override |
| virtual void | wheelEvent(QWheelEvent *e) override |
Descripción detallada
Introducción y conceptos
QPlainTextEdit es un visor/editor avanzado compatible con texto sin formato. Está optimizado para gestionar documentos de gran tamaño y responder rápidamente a las entradas del usuario.
QPlainText utiliza prácticamente la misma tecnología y los mismos conceptos que QTextEdit, pero está optimizado para el manejo de texto sin formato.
QPlainTextEdit opera con párrafos y caracteres. Un párrafo es una cadena formateada que se ajusta al ancho del widget mediante el ajuste de línea. Por defecto, al leer texto sin formato, un salto de línea indica un párrafo. Un documento consta de cero o más párrafos. Los párrafos están separados por saltos de línea duros. Cada carácter dentro de un párrafo tiene sus propios atributos, por ejemplo, la fuente y el color.
La forma del cursor del ratón en un QPlainTextEdit es, por defecto, « Qt::IBeamCursor ». Se puede cambiar mediante la propiedad «cursor» del objeto « viewport()».
Uso de QPlainTextEdit como widget de visualización
El texto se establece o se sustituye mediante ` setPlainText()`, que borra el texto existente y lo sustituye por el texto pasado a ` setPlainText()`.
El texto se puede insertar utilizando la clase ` QTextCursor ` o mediante las funciones de conveniencia ` insertPlainText()`, ` appendPlainText()` o ` paste()`.
Por defecto, el campo de texto ajusta las palabras en los espacios en blanco para que quepan dentro del widget de edición de texto. La función ` setLineWrapMode()` se utiliza para especificar el tipo de ajuste de línea que se desea; ` WidgetWidth ` o ` NoWrap ` si no se desea ningún ajuste. Si se utiliza el ajuste de palabras al ancho del widget ` WidgetWidth`, se puede especificar si el salto debe realizarse en un espacio en blanco o en cualquier lugar mediante ` setWordWrapMode()`.
La función find() se puede utilizar para buscar y seleccionar una cadena determinada dentro del texto.
Si quieres limitar el número total de párrafos en un QPlainTextEdit —lo cual resulta útil, por ejemplo, en un visor de registros—, puedes utilizar la propiedad maximumBlockCount. La combinación de setMaximumBlockCount() y appendPlainText() convierte a QPlainTextEdit en un visor eficiente para texto de registro. El desplazamiento se puede reducir con la propiedad ` centerOnScroll()`, lo que hace que el visor de registros sea aún más rápido. El texto se puede formatear de forma limitada, ya sea utilizando un resaltador de sintaxis (véase más abajo) o añadiendo texto con formato HTML mediante ` appendHtml()`. Aunque `QPlainTextEdit` no admite la representación compleja de texto enriquecido con tablas y elementos flotantes, sí admite un formateo limitado basado en párrafos que puede resultar necesario en un visor de registros.
Atajos de teclado en modo de solo lectura
Cuando QPlainTextEdit se utiliza en modo de solo lectura, las combinaciones de teclas se limitan a la navegación, y el texto solo se puede seleccionar con el ratón:
| Pulsaciones de teclas | Acción |
|---|---|
| Qt::UpArrow | Se desplaza una línea hacia arriba. |
| Qt::DownArrow | Se desplaza una línea hacia abajo. |
| Qt::LeftArrow | Se desplaza un carácter hacia la izquierda. |
| Qt::RightArrow | Se desplaza un carácter a la derecha. |
| RePág | Se desplaza una página (del área de visualización) hacia arriba. |
| AvPág | Desplaza una página (del área de visualización) hacia abajo. |
| Inicio | Se desplaza al principio del texto. |
| Fin | Se desplaza hasta el final del texto. |
| Alt+rueda | Desplaza la página horizontalmente (la rueda es la rueda del ratón). |
| Ctrl+rueda | Amplía el texto. |
| Ctrl+A | Selecciona todo el texto. |
Uso de QPlainTextEdit como editor
Toda la información sobre el uso de QPlainTextEdit como widget de visualización también es aplicable aquí.
La selección de texto se gestiona mediante la clase ` QTextCursor `, que proporciona funcionalidades para crear selecciones, recuperar el contenido del texto o eliminar selecciones. Puedes recuperar el objeto que corresponde al cursor visible para el usuario utilizando el método ` textCursor()`. Si desea establecer una selección en QPlainTextEdit, basta con crear una en un objeto ` QTextCursor ` y, a continuación, convertir ese cursor en el cursor visible mediante ` setCursor()`. La selección se puede copiar al portapapeles con ` copy()` o cortar al portapapeles con ` cut()`. Se puede seleccionar todo el texto mediante ` selectAll()`.
QPlainTextEdit contiene un objeto ` QTextDocument ` que se puede recuperar mediante el método ` document()`. También puede establecer su propio objeto de documento mediante setDocument(). QTextDocument emite una señal textChanged() si el texto cambia y, además, proporciona una función isModified() que devolverá «true» si el texto se ha modificado desde que se cargó o desde la última llamada a setModified con «false» como argumento. Además, proporciona métodos para deshacer y rehacer.
Resaltado de sintaxis
Al igual que QTextEdit, QPlainTextEdit funciona junto con QSyntaxHighlighter.
Atajos de teclado para la edición
La lista de atajos de teclado implementados para la edición:
| Pulsaciones de teclas | Acción |
|---|---|
| Retroceso | Elimina el carácter situado a la izquierda del cursor. |
| Suprimir | Borra el carácter situado a la derecha del cursor. |
| Ctrl+C | Copia el texto seleccionado al portapapeles. |
| Ctrl+Insert | Copia el texto seleccionado al portapapeles. |
| Ctrl+K | Borra hasta el final de la línea. |
| Ctrl+V | Pega el texto del portapapeles en el editor de texto. |
| Mayús+Insert | Pega el texto del portapapeles en el editor de texto. |
| Ctrl+X | Elimina el texto seleccionado y lo copia al portapapeles. |
| Mayús+Supr | Elimina el texto seleccionado y lo copia al portapapeles. |
| Ctrl+Z | Deshace la última operación. |
| Ctrl+Y | Repite la última operación. |
| Flecha izquierda | Mueve el cursor un carácter hacia la izquierda. |
| Ctrl+Flecha izquierda | Mueve el cursor una palabra a la izquierda. |
| Flecha derecha | Mueve el cursor un carácter a la derecha. |
| Ctrl+Flecha derecha | Mueve el cursor una palabra a la derecha. |
| Flecha arriba | Mueve el cursor una línea hacia arriba. |
| Ctrl+Flecha arriba | Mueve el cursor una palabra hacia arriba. |
| Flecha abajo | Mueve el cursor una línea hacia abajo. |
| Ctrl + Flecha abajo | Mueve el cursor una palabra hacia abajo. |
| RePág | Mueve el cursor una página hacia arriba. |
| Av Pág | Mueve el cursor una página hacia abajo. |
| Inicio | Mueve el cursor al principio de la línea. |
| Ctrl+Inicio | Mueve el cursor al principio del texto. |
| Fin | Mueve el cursor al final de la línea. |
| Ctrl+Fin | Mueve el cursor al final del texto. |
| Alt+Rueda | Desplaza la página horizontalmente (la rueda es la rueda del ratón). |
| Ctrl+rueda | Amplía el texto. |
Para seleccionar (marcar) texto, mantén pulsada la tecla Mayús mientras pulsas una de las teclas de desplazamiento; por ejemplo, Mayús+Flecha derecha seleccionará el carácter de la derecha, y Mayús+Ctrl+Flecha derecha seleccionará la palabra de la derecha, etc.
Diferencias con respecto a QTextEdit
QPlainTextEdit es una clase ligera, implementada utilizando gran parte de la tecnología que hay detrás de QTextEdit y QTextDocument. Sus ventajas de rendimiento con respecto a QTextEdit se deben principalmente al uso de un diseño de texto diferente y simplificado, denominado « QPlainTextDocumentLayout », en el documento de texto (véase QTextDocument::setDocumentLayout()). El diseño de documento de texto sin formato no admite tablas ni marcos incrustados, y sustituye el cálculo de la altura con precisión de píxeles por un enfoque de desplazamiento línea por línea o párrafo por párrafo. Esto permite gestionar documentos considerablemente más grandes y, aun así, cambiar el tamaño del editor con el ajuste de línea activado en tiempo real. También permite disponer de un visor de registros rápido (véase setMaximumBlockCount()).
{Ejemplo de resaltador de sintaxis}, {Procesamiento de texto enriquecido}
Véase también QTextDocument y QTextCursor.
Documentación sobre tipos de miembros
enum QPlainTextEdit::LineWrapMode
| Constante | Valor |
|---|---|
QPlainTextEdit::NoWrap | 0 |
QPlainTextEdit::WidgetWidth | 1 |
Documentación de la propiedad
backgroundVisible : bool
Esta propiedad determina si el fondo de la paleta es visible fuera del área del documento
Si se establece en «true», el campo de edición de texto sin formato muestra el fondo de la paleta en el área de la ventana gráfica que no está cubierta por el documento de texto. De lo contrario, si se establece en «false», no lo hará. Esta característica permite al usuario distinguir visualmente entre el área del documento, que se muestra con el color base de la paleta, y el área vacía que no está cubierta por ningún documento.
El valor por defecto es «false».
Funciones de acceso:
| bool | backgroundVisible() const |
| void | setBackgroundVisible(bool visible) |
[read-only] blockCount : int
Esta propiedad contiene el número de bloques de texto del documento.
Por defecto, en un documento vacío, esta propiedad tiene el valor 1.
Funciones de acceso:
| int | blockCount() const |
centerOnScroll : bool
Esta propiedad determina si el cursor debe estar centrado en la pantalla
Si se establece en «true», el campo de texto sin formato desplaza el documento verticalmente para que el cursor quede visible en el centro del área de visualización. Esto también permite que el campo de texto se desplace más allá del final del documento. Por el contrario, si se establece en «false», el campo de texto sin formato se desplaza lo mínimo posible para garantizar que el cursor sea visible. Se aplica el mismo algoritmo a cualquier nueva línea añadida mediante ` appendPlainText()`.
El valor por defecto es «false».
Funciones de acceso:
| bool | centerOnScroll() const |
| void | setCenterOnScroll(bool enabled) |
Véanse también centerCursor() y ensureCursorVisible().
cursorWidth : int
Esta propiedad especifica el ancho del cursor en píxeles. El valor por defecto es 1.
Funciones de Access:
| int | cursorWidth() const |
| void | setCursorWidth(int width) |
documentTitle : QString
Esta propiedad contiene el título del documento extraído del texto.
Por defecto, esta propiedad contiene una cadena vacía.
Funciones de acceso:
| QString | documentTitle() const |
| void | setDocumentTitle(const QString &title) |
lineWrapMode : LineWrapMode
Esta propiedad define el modo de ajuste de línea
El modo predeterminado es « WidgetWidth », que hace que las palabras se ajusten al margen derecho del campo de texto. El ajuste se produce en los espacios en blanco, manteniendo intactas las palabras completas. Si deseas que el ajuste se produzca dentro de las palabras, utiliza « setWordWrapMode » ().
Funciones de acceso:
| QPlainTextEdit::LineWrapMode | lineWrapMode() const |
| void | setLineWrapMode(QPlainTextEdit::LineWrapMode mode) |
maximumBlockCount : int
Esta propiedad establece el límite de bloques del documento.
Especifica el número máximo de bloques que puede tener el documento. Si hay más bloques en el documento de los especificados con esta propiedad, se eliminarán los bloques del principio del documento.
Un valor negativo o cero indica que el documento puede contener un número ilimitado de bloques.
El valor por defecto es 0.
Ten en cuenta que al configurar esta propiedad, el límite se aplicará inmediatamente al contenido del documento. Al configurar esta propiedad también se desactiva el historial de deshacer y rehacer.
Funciones de acceso:
| int | maximumBlockCount() const |
| void | setMaximumBlockCount(int maximum) |
overwriteMode : bool
Esta propiedad determina si el texto introducido por el usuario sobrescribirá el texto existente
Al igual que en muchos editores de texto, el widget del editor de texto sin formato se puede configurar para insertar o sobrescribir el texto existente con el nuevo texto introducido por el usuario.
Si esta propiedad está « true », el texto existente se sobrescribe, carácter por carácter, con el nuevo texto; en caso contrario, el texto se inserta en la posición del cursor, desplazando el texto existente.
Por defecto, esta propiedad está establecida en « false » (el nuevo texto no sobrescribe el texto existente).
Funciones de Access:
| bool | overwriteMode() const |
| void | setOverwriteMode(bool overwrite) |
placeholderText : QString
Esta propiedad contiene el texto de marcador de posición del editor
Al configurar esta propiedad, el editor muestra un texto de marcador de posición atenuado mientras el campo « document » esté vacío.
Por defecto, esta propiedad contiene una cadena vacía.
Funciones de acceso:
| QString | placeholderText() const |
| void | setPlaceholderText(const QString &placeholderText) |
Véase también document().
plainText : QString
Esta propiedad obtiene y establece el contenido del editor de texto sin formato. Al establecer esta propiedad, se elimina el contenido anterior y se restablece el historial de deshacer/rehacer. También se restablece ` currentCharFormat()`; a menos que ` textCursor()` ya se encuentre al principio del documento.
Por defecto, en un editor sin contenido, esta propiedad contiene una cadena vacía.
Funciones de acceso:
| QString | toPlainText() const |
| void | setPlainText(const QString &text) |
Señal de notificación:
| void | textChanged() |
readOnly : bool
Esta propiedad indica si el campo de texto es de solo lectura
En un campo de texto de solo lectura, el usuario solo puede desplazarse por el texto y seleccionarlo; no es posible modificarlo.
El valor predeterminado de esta propiedad es «false».
Funciones de acceso:
| bool | isReadOnly() const |
| void | setReadOnly(bool ro) |
tabChangesFocus : bool
Esta propiedad se mantiene tanto si « Tab » cambia de foco como si se acepta como entrada
En algunas ocasiones, los campos de edición de texto no deben permitir que el usuario introduzca tabulaciones ni modifique la sangría mediante la tecla « Tab », ya que esto rompe la cadena de foco. El valor por defecto es «false».
Funciones de acceso:
| bool | tabChangesFocus() const |
| void | setTabChangesFocus(bool b) |
tabStopDistance : qreal
Esta propiedad indica la distancia de la parada de tabulación en píxeles
Por defecto, esta propiedad tiene un valor de 80 píxeles.
No establezcas un valor inferior a la función « horizontalAdvance()» del carácter « QChar::VisualTabCharacter »; de lo contrario, el carácter de tabulación se dibujará de forma incompleta.
Funciones de acceso:
| qreal | tabStopDistance() const |
| void | setTabStopDistance(qreal distance) |
Véase también « QTextOption::ShowTabsAndSpaces » y « QTextDocument::defaultTextOption ».
textInteractionFlags : Qt::TextInteractionFlags
Especifica cómo debe interactuar la etiqueta con las entradas del usuario si muestra texto.
Si los indicadores contienen « Qt::LinksAccessibleByKeyboard » o « Qt::TextSelectableByKeyboard », la política de foco también se establece automáticamente en « Qt::ClickFocus ».
El valor por defecto depende de si el « QPlainTextEdit » es de solo lectura o editable.
Funciones de acceso:
| Qt::TextInteractionFlags | textInteractionFlags() const |
| void | setTextInteractionFlags(Qt::TextInteractionFlags flags) |
undoRedoEnabled : bool
Esta propiedad indica si las funciones de deshacer y rehacer están activadas
Los usuarios solo pueden deshacer o rehacer acciones si esta propiedad es «true» y si hay alguna acción que se pueda deshacer (o rehacer).
Por defecto, esta propiedad tiene el valor « true ».
Funciones de acceso:
| bool | isUndoRedoEnabled() const |
| void | setUndoRedoEnabled(bool enable) |
wordWrapMode : QTextOption::WrapMode
Esta propiedad define el modo que utilizará QPlainTextEdit al ajustar el texto por palabras
Por defecto, esta propiedad está configurada en « QTextOption::WrapAtWordBoundaryOrAnywhere ».
Funciones de acceso:
| QTextOption::WrapMode | wordWrapMode() const |
| void | setWordWrapMode(QTextOption::WrapMode policy) |
Véase también « QTextOption::WrapMode ».
Documentación de funciones de miembro
[explicit] QPlainTextEdit::QPlainTextEdit(QWidget *parent = nullptr)
Crea un objeto QPlainTextEdit vacío cuyo padre es parent.
[explicit] QPlainTextEdit::QPlainTextEdit(const QString &text, QWidget *parent = nullptr)
Crea un objeto `QPlainTextEdit` cuyo padre es ` parent`. El cuadro de edición de texto mostrará el texto sin formato ` text`.
[virtual noexcept] QPlainTextEdit::~QPlainTextEdit()
Destructor.
QString QPlainTextEdit::anchorAt(const QPoint &pos) const
Devuelve la referencia del ancla situada en la posición pos, o una cadena vacía si no existe ningún ancla en ese punto.
[slot] void QPlainTextEdit::appendHtml(const QString &html)
Añade un nuevo párrafo con el texto « html » al final del texto editado.
[slot] void QPlainTextEdit::appendPlainText(const QString &text)
Añade un nuevo párrafo con el texto « text » al final del texto editado.
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. Traslada el rectángulo con la función contentOffset() para obtener las 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 propias coordenadas 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 transmite a través de « 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 invoca, 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 desde el portapapeles en el campo de texto.
[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 del campo de edición.
Notas:
- El historial de deshacer/rehacer también se borra.
- currentCharFormat() se restablece, a menos que textCursor() ya se encuentre 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 un campo de edición de texto sin formato es siempre la esquina superior izquierda del primer bloque de texto visible. El desplazamiento del contenido es distinto 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 deseas que el campo de texto tenga un menú contextual, puedes establecer su contextMenuPolicy en Qt::NoContextMenu. Si deseas personalizar el menú contextual, reimplementa esta función. Si deseas ampliar el menú contextual estándar, reimplementa esta función, llama a createStandardContextMenu() y amplía el menú devuelto.
La información sobre el evento se pasa a través del 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 cualquier texto seleccionado al portapapeles.
Véase también copyAvailable().
[signal] void QPlainTextEdit::copyAvailable(bool yes)
Esta señal se emite cuando se selecciona o se deselecciona texto en el campo de edición de texto.
Cuando se selecciona texto, esta señal se emite con « yes » establecido en «true». Si no se ha seleccionado ningún texto o si se deselecciona el texto seleccionado, esta señal se emite con « yes » establecido en «false».
Si ` yes ` es `true`, se puede utilizar ` copy()` para copiar la selección al portapapeles. Si ` yes ` es `false`, ` copy()` no realiza ninguna acción.
Véase también selectionChanged().
[virtual protected] QMimeData *QPlainTextEdit::createMimeDataFromSelection() const
Esta función devuelve un nuevo objeto de datos MIME que representa el contenido de la selección actual del campo de edición de texto. Se invoca cuando es necesario encapsular la selección en un nuevo objeto ` QMimeData `; por ejemplo, al iniciar una operación de arrastrar y soltar, o al copiar datos al portapapeles.
Si reimplementas esta función, ten en cuenta que la propiedad del objeto ` QMimeData ` devuelto se transfiere a quien la invoca. La selección se puede recuperar utilizando la función ` textCursor()`.
QMenu *QPlainTextEdit::createStandardContextMenu()
Esta función crea el menú contextual estándar que aparece cuando el usuario hace clic con el botón derecho del ratón en el campo de edición de texto. Se invoca desde el controlador predeterminado ` contextMenuEvent()`. La propiedad del menú emergente se transfiere a quien lo invoca.
Recomendamos utilizar en su lugar la versión createStandardContextMenu(QPoint), que habilitará las acciones que dependen del lugar en el que el usuario haya hecho clic.
QMenu *QPlainTextEdit::createStandardContextMenu(const QPoint &position)
Esta función crea el menú contextual estándar que aparece cuando el usuario hace clic con el botón derecho del ratón en el campo de edición de texto. Se invoca desde el controlador predeterminado ` contextMenuEvent()` y toma como parámetro ` position `, en coordenadas del documento, el punto en el que se produjo el clic del ratón. Esto permite activar acciones que dependen de la posición en la que el usuario haya hecho clic. La propiedad del menú emergente se transfiere al llamante.
QTextCharFormat QPlainTextEdit::currentCharFormat() const
Devuelve el formato de caracteres que se utiliza al insertar texto nuevo.
Véase también setCurrentCharFormat().
QTextCursor QPlainTextEdit::cursorForPosition(const QPoint &pos) const
devuelve un objeto ` 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 del campo de edición de texto.
QRect QPlainTextEdit::cursorRect(const QTextCursor &cursor) const
devuelve un rectángulo (en coordenadas de la ventana gráfica) que incluye el ` cursor`.
[slot] void QPlainTextEdit::cut()
Copia el texto seleccionado al portapapeles y lo elimina del campo de 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()
Garantiza que el cursor sea visible desplazando el cuadro de texto si es necesario.
Véase también centerCursor() y centerOnScroll.
QList<QTextEdit::ExtraSelection> QPlainTextEdit::extraSelections() const
Devuelve las selecciones adicionales establecidas previamente.
Véase también setExtraSelections().
bool QPlainTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())
Busca la siguiente aparición de la cadena « exp » utilizando el valor dado « options ». 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 coincidencia que se ajuste a la expresión regular « exp », utilizando el « options » indicado.
Devuelve true si se ha encontrado una coincidencia y cambia el cursor para seleccionar la coincidencia; en caso contrario, devuelve false.
Advertencia: Por motivos históricos, se ignora la opción de distinción entre mayúsculas y minúsculas establecida en ` exp `. En su lugar, se utilizan los ` options ` para determinar si la búsqueda distingue entre mayúsculas y minúsculas o no.
Esta es una función sobrecargada.
[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 de la función ` viewport()`, útil únicamente al reimplementar ` 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` (conste `Qt::InputMethodQuery query`).
[virtual protected] void QPlainTextEdit::insertFromMimeData(const QMimeData *source)
Esta función inserta el contenido del objeto de datos MIME, especificado por ` source`, en el campo de texto en la posición actual del cursor. Se invoca cada vez que se inserta texto como resultado de una operación de pegado desde el portapapeles, o cuando el campo de texto acepta datos procedentes de una operación de arrastrar y soltar.
[slot] void QPlainTextEdit::insertPlainText(const QString &text)
Tecla de acceso rápido 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 valores proporcionados en ` 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)
Incorpora las propiedades especificadas en modifier al formato del carácter actual mediante la llamada a QTextCursor::mergeCharFormat sobre el cursor del editor. Si el editor tiene una selección, las propiedades de modifier se aplican directamente a dicha selección.
Véase también QTextCursor::mergeCharFormat().
[signal] void QPlainTextEdit::modificationChanged(bool changed)
Esta señal se emite cada vez 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, al llamar a setModified(false) en un documento y, a continuación, insertar texto, se emite la señal. Si deshaces esa operación, lo que hace 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 aplicando la función « operation » indicada.
Si mode es QTextCursor::KeepAnchor, el cursor selecciona el texto sobre el que se desplaza. Este es el mismo efecto que consigue el usuario cuando mantiene pulsada la tecla Mayús y mueve el cursor con las teclas de desplazamiento.
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 el campo de 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 qué puede pegar QPlainTextEdit y cómo se pega, reimplementa las funciones virtuales canInsertFromMimeData() y insertFromMimeData().
Véanse también cut() y copy().
void QPlainTextEdit::print(QPagedPaintDevice *printer) const
Función práctica para imprimir el documento del objeto TextEdit en el printer especificado. Esto equivale a llamar directamente al método `print` del documento, salvo que esta función también admite `QPrinter::Selection` como rango de impresión.
Véase también QTextDocument::print().
[slot] void QPlainTextEdit::redo()
Repite la última operación.
Si no hay ninguna operación que rehacer, es decir, si 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 cada vez que las operaciones de «redo» están disponibles (available es verdadero) o no están 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 de caracteres que se utilizará al insertar texto nuevo en format llamando a QTextCursor::setCharFormat() sobre el cursor del editor. Si el editor tiene una selección, el formato de caracteres se aplica directamente a dicha selección.
Véase también currentCharFormat().
void QPlainTextEdit::setDocument(QTextDocument *document)
Establece document como el nuevo documento del editor de texto.
El documento padre QObject del documento proporcionado sigue siendo el propietario del objeto. Si el documento actual es un documento secundario del editor de texto, se elimina.
El documento debe tener un diseño de documento que herede de ` QPlainTextDocumentLayout ` (véase ` QTextDocument::setDocumentLayout()`).
Véase también document().
void QPlainTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)
Esta función permite marcar temporalmente determinadas regiones del documento con un color determinado, especificado como « selections ». Esto puede resultar útil, por ejemplo, en un editor de programación para marcar una línea completa de texto con un color de fondo determinado, con el fin de 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 del campo de edición por 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 restablece, a menos que textCursor() ya se encuentre al principio del documento.
Nota: Funciónde asignación para la propiedad « plainText ».
Véase también toPlainText().
void QPlainTextEdit::setTextCursor(const QTextCursor &cursor)
Establece el valor de « 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 cada vez que cambia el contenido del documento; por ejemplo, cuando se inserta o se elimina texto, o cuando se aplica formato.
Nota: Señalde notificación para la propiedad « plainText ».
QTextCursor QPlainTextEdit::textCursor() const
Devuelve una copia del objeto ` QTextCursor ` que representa el cursor visible actualmente. Ten en cuenta que los cambios realizados en el cursor devuelto no afectan al cursor de ` QPlainTextEdit`; utiliza ` setTextCursor()` para actualizar el cursor visible.
Véase también setTextCursor().
QString QPlainTextEdit::toPlainText() const
Devuelve el contenido del campo de texto como texto sin formato.
Nota: Funcióngetter para la propiedad « plainText ».
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, si 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 cada vez que las operaciones de deshacer están disponibles (available es verdadero) o no están 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 se desplaza el texto, ` rect ` abarcará toda el área de la ventana de visualización. Si el texto se desplaza verticalmente, ` dy ` contiene la cantidad de píxeles que se ha desplazado la ventana de visualización.
El objetivo de la señal es permitir el uso de widgets adicionales en las subclases de edición de texto sin formato que, por ejemplo, muestren números de línea, puntos de interrupción u otra información adicional.
[override virtual protected] void QPlainTextEdit::wheelEvent(QWheelEvent *e)
Reimplementa: QAbstractScrollArea::wheelEvent(QWheelEvent *e).
[slot] void QPlainTextEdit::zoomIn(int range = 1)
Amplía el texto aumentando el tamaño de la fuente base en range puntos y recalculando todos los tamaños de fuente según el nuevo tamaño. Esto no modifica el tamaño de ninguna imagen.
Véase también zoomOut().
[slot] void QPlainTextEdit::zoomOut(int range = 1)
Reduce el tamaño del texto reduciendo el tamaño de fuente base en range puntos y recalculando todos los tamaños de fuente según el nuevo tamaño. Esto no modifica el tamaño de ninguna imagen.
Véase también zoomIn().
© 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.