QTextEdit Class
QTextEdit 클래스는 일반 텍스트와 서식 있는 텍스트를 편집하고 표시하는 데 사용되는 위젯을 제공합니다. 더 보기...
Header: | #include <QTextEdit> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
상속합니다: | QAbstractScrollArea |
상속 대상: |
- 상속된 멤버를 포함한 모든 멤버 목록
- QTextEdit는 리치 텍스트 처리 API의 일부입니다.
공용 유형
struct | ExtraSelection |
flags | AutoFormatting |
enum | AutoFormattingFlag { AutoNone, AutoBulletList, AutoAll } |
enum | LineWrapMode { NoWrap, WidgetWidth, FixedPixelWidth, FixedColumnWidth } |
속성
|
|
공용 함수
QTextEdit(QWidget *parent = nullptr) | |
QTextEdit(const QString &text, QWidget *parent = nullptr) | |
virtual | ~QTextEdit() |
bool | acceptRichText() const |
Qt::Alignment | alignment() const |
QString | anchorAt(const QPoint &pos) const |
QTextEdit::AutoFormatting | autoFormatting() const |
bool | canPaste() const |
QMenu * | createStandardContextMenu() |
QMenu * | createStandardContextMenu(const QPoint &position) |
QTextCharFormat | currentCharFormat() const |
QFont | currentFont() 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()) |
QString | fontFamily() const |
bool | fontItalic() const |
qreal | fontPointSize() const |
bool | fontUnderline() const |
int | fontWeight() const |
bool | isReadOnly() const |
bool | isUndoRedoEnabled() const |
int | lineWrapColumnOrWidth() const |
QTextEdit::LineWrapMode | lineWrapMode() const |
virtual QVariant | loadResource(int type, const QUrl &name) |
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 | setAcceptRichText(bool accept) |
void | setAutoFormatting(QTextEdit::AutoFormatting features) |
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 | setLineWrapColumnOrWidth(int w) |
void | setLineWrapMode(QTextEdit::LineWrapMode mode) |
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 |
QColor | textBackgroundColor() const |
QColor | textColor() const |
QTextCursor | textCursor() const |
Qt::TextInteractionFlags | textInteractionFlags() const |
QString | toHtml() const |
QString | toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const |
QString | toPlainText() const |
QTextOption::WrapMode | wordWrapMode() const |
재구현된 공용 함수
virtual QVariant | inputMethodQuery(Qt::InputMethodQuery property) const override |
공용 슬롯
void | append(const QString &text) |
void | clear() |
void | copy() |
void | cut() |
void | insertHtml(const QString &text) |
void | insertPlainText(const QString &text) |
void | paste() |
void | redo() |
void | scrollToAnchor(const QString &name) |
void | selectAll() |
void | setAlignment(Qt::Alignment a) |
void | setCurrentFont(const QFont &f) |
void | setFontFamily(const QString &fontFamily) |
void | setFontItalic(bool italic) |
void | setFontPointSize(qreal s) |
void | setFontUnderline(bool underline) |
void | setFontWeight(int weight) |
void | setHtml(const QString &text) |
void | setMarkdown(const QString &markdown) |
void | setPlainText(const QString &text) |
void | setText(const QString &text) |
void | setTextBackgroundColor(const QColor &c) |
void | setTextColor(const QColor &c) |
void | undo() |
void | zoomIn(int range = 1) |
void | zoomOut(int range = 1) |
신호
void | copyAvailable(bool yes) |
void | currentCharFormatChanged(const QTextCharFormat &f) |
void | cursorPositionChanged() |
void | redoAvailable(bool available) |
void | selectionChanged() |
void | textChanged() |
void | undoAvailable(bool available) |
보호된 함수
virtual bool | canInsertFromMimeData(const QMimeData *source) const |
virtual QMimeData * | createMimeDataFromSelection() const |
virtual void | insertFromMimeData(const QMimeData *source) |
재구현된 보호 함수
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 *event) 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 |
상세 설명
소개 및 개념
QTextEdit는 HTML 스타일 태그 또는 마크다운 형식을 사용하여 서식 있는 텍스트 서식을 지원하는 고급 WYSIWYG 뷰어/편집기입니다. 대용량 문서를 처리하고 사용자 입력에 빠르게 응답하도록 최적화되어 있습니다.
QTextEdit는 단락과 문자에서 작동합니다. 단락은 위젯의 너비에 맞게 단어로 줄 바꿈된 형식화된 문자열입니다. 기본적으로 일반 텍스트를 읽을 때 하나의 줄 바꿈은 단락을 나타냅니다. 문서는 0개 이상의 단락으로 구성됩니다. 단락의 단어는 단락의 정렬에 따라 정렬됩니다. 단락은 하드 줄 바꿈으로 구분됩니다. 단락 내의 각 문자에는 글꼴 및 색상과 같은 고유한 속성이 있습니다.
QTextEdit는 이미지, 목록 및 표를 표시할 수 있습니다. 텍스트가 너무 커서 텍스트 편집의 뷰포트 내에서 볼 수 없는 경우 스크롤 막대가 나타납니다. 텍스트 편집은 일반 텍스트와 서식 있는 텍스트 파일을 모두 로드할 수 있습니다. 서식 있는 텍스트는 HTML 4 마크업의 하위 집합을 사용하여 설명할 수 있습니다. 자세한 내용은 지원되는 HTML 하위 집합 페이지를 참조하세요.
작은 리치 텍스트만 표시해야 하는 경우 QLabel 을 사용합니다.
Qt의 서식 있는 텍스트 지원은 애플리케이션에 합리적인 온라인 도움말 기능을 추가하고 서식 있는 텍스트 편집기의 기반을 제공하기 위한 빠르고 이식 가능하며 효율적인 방법을 제공하기 위해 고안되었습니다. HTML 지원이 필요에 충분하지 않다면 모든 기능을 갖춘 웹 브라우저 위젯을 제공하는 Qt WebKit의 사용을 고려할 수 있습니다.
QTextEdit의 마우스 커서 모양은 기본적으로 Qt::IBeamCursor 입니다. viewport ()의 커서 속성을 통해 변경할 수 있습니다.
QTextEdit를 디스플레이 위젯으로 사용하기
QTextEdit는 표와 이미지를 포함한 큰 HTML 하위 집합을 표시할 수 있습니다.
기존 텍스트를 삭제하고 setHtml() 호출에서 전달된 텍스트로 대체하는 setHtml()를 사용하여 텍스트를 설정하거나 바꿀 수 있습니다. 레거시 HTML로 setHtml()를 호출한 다음 toHtml()를 호출하면 반환되는 텍스트의 마크업은 다를 수 있지만 렌더링은 동일합니다. 전체 텍스트는 clear()로 삭제할 수 있습니다.
setMarkdown()를 사용하여 텍스트를 설정하거나 바꿀 수도 있으며, 동일한 주의 사항이 적용됩니다. toMarkdown()를 호출하면 반환되는 텍스트가 달라질 수 있지만 의미는 최대한 유지됩니다. setHtml ()와 동일한 제한 사항이 있지만, toMarkdown()은 HTML이 일부 포함된 마크다운을 파싱할 수 있지만, 포함된 HTML 없이 "순수한" 마크다운만 작성합니다.
텍스트 자체는 QTextCursor 클래스를 사용하거나 insertHtml(), insertPlainText(), append() 또는 paste() 편의 함수를 사용하여 삽입할 수 있습니다. QTextCursor 는 표나 목록 같은 복잡한 객체를 문서에 삽입할 수도 있고, 선택 영역을 만들고 선택한 텍스트에 변경 사항을 적용하는 작업을 처리할 수도 있습니다.
기본적으로 텍스트 편집은 텍스트 편집 위젯에 맞게 단어를 공백으로 줄 바꿈합니다. setLineWrapMode () 함수는 원하는 줄 바꿈 종류를 지정하는 데 사용되며, 줄 바꿈을 원하지 않는 경우 NoWrap 을 사용합니다. setLineWrapMode ()를 호출하여 고정 픽셀 너비 FixedPixelWidth 또는 문자 열(예: 80열) FixedColumnWidth 을 setLineWrapColumnOrWidth()로 지정한 픽셀 또는 열로 설정합니다. 위젯 너비 WidgetWidth 에 단어 줄 바꿈을 사용하는 경우 setWordWrapMode()로 공백 또는 아무 곳이나 줄 바꿈할지 여부를 지정할 수 있습니다.
find() 함수는 텍스트 내에서 지정된 문자열을 찾아서 선택하는 데 사용할 수 있습니다.
예를 들어 로그 뷰어에서 유용하게 사용되는 것처럼 QTextEdit의 총 단락 수를 제한하려는 경우 QTextDocument 의 maximumBlockCount 속성을 사용할 수 있습니다.
읽기 전용 키 바인딩
QTextEdit를 읽기 전용으로 사용하는 경우 키 바인딩은 탐색으로 제한되며 텍스트는 마우스로만 선택할 수 있습니다:
키 누름 | Action |
---|---|
Up | 한 줄 위로 이동합니다. |
Down | 한 줄 아래로 이동합니다. |
왼쪽 | 한 문자를 왼쪽으로 이동합니다. |
오른쪽 | 한 글자 오른쪽으로 이동합니다. |
페이지 위로 | 한 페이지(뷰포트) 위로 이동합니다. |
PageDown | 한 (뷰포트) 페이지를 아래로 이동합니다. |
홈 | 텍스트의 시작 부분으로 이동합니다. |
End | 텍스트의 끝으로 이동합니다. |
Alt+휠 | 페이지를 가로로 스크롤합니다(휠은 마우스 휠). |
Ctrl+휠 | 텍스트를 확대/축소합니다. |
Ctrl+A | 모든 텍스트를 선택합니다. |
텍스트 수정은 일부 메타 정보를 제공할 수 있습니다. 예를 들어 documentTitle() 함수는 HTML <title>
태그 내의 텍스트를 반환합니다.
참고: HTML 문서 확대/축소는 글꼴 크기가 고정된 크기로 설정되어 있지 않은 경우에만 작동합니다.
QTextEdit를 편집기로 사용하기
QTextEdit를 표시 위젯으로 사용하는 것에 대한 모든 정보가 여기에도 적용됩니다.
현재 문자 형식의 속성은 setFontItalic(), setFontWeight(), setFontUnderline(), setFontFamily(), setFontPointSize(), setTextColor() 및 setCurrentFont()로 설정됩니다. 현재 단락의 맞춤은 setAlignment()로 설정되어 있습니다.
텍스트 선택은 선택 영역 생성, 텍스트 내용 검색 또는 선택 영역 삭제 기능을 제공하는 QTextCursor 클래스에서 처리합니다. textCursor () 메서드를 사용하여 사용자에게 보이는 커서에 해당하는 객체를 검색할 수 있습니다. QTextEdit에서 선택 영역을 설정하려면 QTextCursor 객체에 선택 영역을 만든 다음 setTextCursor()를 사용하여 해당 커서를 보이는 커서로 만듭니다. 선택 영역은 copy()를 사용하여 클립보드에 복사하거나 cut()를 사용하여 클립보드에 잘라낼 수 있습니다. selectAll ()를 사용하여 전체 텍스트를 선택할 수 있습니다.
커서를 이동하고 기본 서식 속성이 변경되면 currentCharFormatChanged() 신호가 발생하여 새 커서 위치에 새 속성을 반영합니다.
textChanged() 신호는 텍스트가 변경될 때마다( setText() 또는 편집기 자체를 통해) 발생합니다.
QTextEdit는 document() 메서드를 사용하여 검색할 수 있는 QTextDocument 객체를 보유합니다. setDocument ()를 사용하여 고유한 문서 객체를 설정할 수도 있습니다.
QTextDocument 는 isModified() 함수를 제공하여 텍스트가 로드된 이후 또는 false를 인수로 사용하여 setModified를 마지막으로 호출한 이후 텍스트가 수정된 경우 true를 반환합니다. 또한 실행 취소 및 다시 실행을 위한 메서드도 제공합니다.
드래그 앤 드롭
QTextEdit는 사용자 지정 드래그 앤 드롭 동작도 지원합니다. 기본적으로 사용자가 이러한 MIME 유형의 데이터를 문서에 끌어서 놓으면 QTextEdit는 일반 텍스트, HTML 및 서식 있는 텍스트를 삽입합니다. canInsertFromMimeData () 및 insertFromMimeData()을 다시 구현하여 추가 MIME 유형에 대한 지원을 추가합니다.
예를 들어 사용자가 이미지를 QTextEdit에 끌어다 놓을 수 있도록 하려면 다음과 같은 방식으로 이러한 함수를 구현할 수 있습니다:
bool TextEdit::canInsertFromMimeData( const QMimeData *source ) const { if (source->hasImage()) return true; else return QTextEdit::canInsertFromMimeData(source); }
참을 반환하여 이미지 MIME 유형에 대한 지원을 추가합니다. 다른 모든 MIME 유형의 경우 기본 구현을 사용합니다.
void TextEdit::insertFromMimeData( const QMimeData *source ) { if (source->hasImage()) { QImage image = qvariant_cast<QImage>(source->imageData()); QTextCursor cursor = this->textCursor(); QTextDocument *document = this->document(); document->addResource(QTextDocument::ImageResource, QUrl("image"), image); cursor.insertImage("image"); } }
MIME 소스가 보유한 QVariant 에서 이미지의 압축을 풀고 문서에 리소스로 삽입합니다.
키 바인딩 편집하기
편집을 위해 구현된 키 바인딩 목록입니다:
키 프레스 | Action |
---|---|
백스페이스 | 커서 왼쪽에 있는 문자를 삭제합니다. |
Delete | 커서 오른쪽에 있는 문자를 삭제합니다. |
Ctrl+C | 선택한 텍스트를 클립보드에 복사합니다. |
Ctrl+삽입 | 선택한 텍스트를 클립보드에 복사합니다. |
Ctrl+K | 줄 끝으로 삭제합니다. |
Ctrl+V | 클립보드 텍스트를 텍스트 편집에 붙여넣습니다. |
Shift+삽입 | 클립보드 텍스트를 텍스트 편집에 붙여넣습니다. |
Ctrl+X | 선택한 텍스트를 삭제하고 클립보드에 복사합니다. |
Shift+삭제 | 선택한 텍스트를 삭제하고 클립보드에 복사합니다. |
Ctrl+Z | 마지막 작업을 실행 취소합니다. |
Ctrl+Y | 마지막 작업을 다시 실행합니다. |
왼쪽 | 커서를 한 글자 왼쪽으로 이동합니다. |
Ctrl+Left | 커서를 한 단어 왼쪽으로 이동합니다. |
오른쪽 | 커서를 한 글자 오른쪽으로 이동합니다. |
Ctrl+오른쪽 | 커서를 한 단어 오른쪽으로 이동합니다. |
Up | 커서를 한 줄 위로 이동합니다. |
Down | 커서를 한 줄 아래로 이동합니다. |
페이지 위로 | 커서를 한 페이지 위로 이동합니다. |
PageDown | 커서를 한 페이지 아래로 이동합니다. |
홈 | 커서를 줄의 시작 부분으로 이동합니다. |
Ctrl+Home | 커서를 텍스트의 시작 부분으로 이동합니다. |
End | 커서를 줄의 끝으로 이동합니다. |
Ctrl+끝 | 커서를 텍스트의 끝으로 이동합니다. |
Alt+휠 | 페이지를 가로로 스크롤합니다(휠은 마우스 휠). |
텍스트를 선택(표시)하려면 Shift 키를 누른 상태에서 이동 키 입력 중 하나를 누릅니다(예: Shift+Right는 오른쪽에 있는 문자를 선택하고, Shift+Ctrl+Right는 오른쪽에 있는 단어를 선택하는 등).
QTextDocument, QTextCursor, 구문 형광펜 예제 및 서식 있는 텍스트 처리도참조하세요 .
멤버 유형 문서
열거형 QTextEdit::AutoFormattingFlag
플래그 QTextEdit::AutoFormatting
Constant | 값 | 설명 |
---|---|---|
QTextEdit::AutoNone | 0 | 자동 서식을 지정하지 않습니다. |
QTextEdit::AutoBulletList | 0x00000001 | 글머리 기호 목록을 자동으로 생성합니다(예: 사용자가 가장 왼쪽 열에 별표('*')를 입력하거나 기존 목록 항목에서 Enter 키를 누를 때). |
QTextEdit::AutoAll | 0xffffffff | 모든 자동 서식을 적용합니다. 현재는 자동 글머리 기호 목록만 지원됩니다. |
자동 서식 지정 유형은 QFlags<AutoFormattingFlag>에 대한 타입 정의입니다. 자동 서식 지정 플래그 값의 OR 조합을 저장합니다.
enum QTextEdit::LineWrapMode
상수 | Value |
---|---|
QTextEdit::NoWrap | 0 |
QTextEdit::WidgetWidth | 1 |
QTextEdit::FixedPixelWidth | 2 |
QTextEdit::FixedColumnWidth | 3 |
속성 문서
acceptRichText : bool
이 속성은 텍스트 편집에서 사용자의 서식 있는 텍스트 삽입을 허용할지 여부를 나타냅니다.
이 속성을 false로 설정하면 텍스트 편집은 사용자의 일반 텍스트 입력만 허용합니다. 예를 들어 클립보드 또는 드래그 앤 드롭을 통해 입력할 수 있습니다.
이 속성의 기본값은 참입니다.
기능 액세스:
bool | acceptRichText() const |
void | setAcceptRichText(bool accept) |
autoFormatting : AutoFormatting
이 속성은 활성화된 자동 서식 지정 기능 집합을 보유합니다.
값은 AutoFormattingFlag 열거형에 있는 값의 모든 조합이 될 수 있습니다. 기본값은 AutoNone 입니다. 모든 자동 서식을 활성화하려면 AutoAll 을 선택합니다.
현재 제공되는 자동 서식 지정 기능은 AutoBulletList 뿐이며, 향후 Qt 버전에서는 더 많은 기능이 제공될 수 있습니다.
액세스 기능:
QTextEdit::AutoFormatting | autoFormatting() const |
void | setAutoFormatting(QTextEdit::AutoFormatting features) |
cursorWidth : int
이 속성은 커서의 너비를 픽셀 단위로 지정합니다. 기본값은 1입니다.
함수 액세스:
int | cursorWidth() const |
void | setCursorWidth(int width) |
document : QTextDocument*
이 속성은 텍스트 편집기의 기본 문서를 보유합니다.
참고: 편집기는 문서의 상위 개체가 아닌 한 문서의 소유권을 가져가지 않습니다. 제공된 문서의 부모 객체가 객체의 소유권을 유지합니다. 이전에 할당된 문서가 편집기의 자식인 경우 해당 문서는 삭제됩니다.
액세스 기능:
QTextDocument * | document() const |
void | setDocument(QTextDocument *document) |
documentTitle : QString
이 속성은 텍스트에서 파싱된 문서의 제목을 저장합니다.
기본적으로 새로 생성된 빈 문서의 경우 이 속성에는 빈 문자열이 포함됩니다.
액세스 함수:
QString | documentTitle() const |
void | setDocumentTitle(const QString &title) |
html : QString
이 속성은 텍스트 편집 텍스트에 대한 HTML 인터페이스를 제공합니다.
toHtml()은 텍스트 편집의 텍스트를 html로 반환합니다.
setHtml()은 텍스트 편집의 텍스트를 변경합니다. 이전 텍스트는 모두 제거되고 실행 취소/다시 실행 기록이 지워집니다. 입력 텍스트는 html 형식의 서식 있는 텍스트로 해석됩니다. currentCharFormat()도 textCursor()가 이미 문서의 시작 부분에 있는 경우를 제외하고는 초기화됩니다.
참고: HTML이 포함된 QString 을 생성하여 setHtml()에 전달할 때 텍스트가 올바르게 디코딩되었는지 확인하는 것은 호출자의 책임입니다.
기본적으로 새로 생성된 빈 문서의 경우 이 속성에는 본문 텍스트가 없는 HTML 4.0 문서를 설명하는 텍스트가 포함됩니다.
함수 액세스:
QString | toHtml() const |
void | setHtml(const QString &text) |
알림 신호:
void | textChanged() |
지원되는 HTML 하위 집합 및 plainText 를참조하세요 .
lineWrapColumnOrWidth : int
이 속성은 텍스트가 줄 바꿈될 위치(줄 바꿈 모드에 따라 픽셀 또는 열 단위)를 저장합니다.
줄 바꿈 모드가 FixedPixelWidth 인 경우 값은 텍스트 편집의 왼쪽 가장자리에서 텍스트를 줄 바꿈해야 하는 픽셀 수입니다. 줄 바꿈 모드가 FixedColumnWidth 인 경우 값은 텍스트가 줄 바꿈되어야 하는 텍스트 편집의 왼쪽 가장자리에서 열 번호(문자 열)입니다.
기본적으로 이 속성에는 0 값이 포함됩니다.
함수 액세스:
int | lineWrapColumnOrWidth() const |
void | setLineWrapColumnOrWidth(int w) |
lineWrapMode 를참조하세요 .
lineWrapMode : LineWrapMode
이 속성은 줄 바꿈 모드를 유지합니다.
기본 모드는 WidgetWidth 이며, 텍스트 편집의 오른쪽 가장자리에서 단어가 줄 바꿈됩니다. 줄 바꿈은 공백에서 발생하며 전체 단어는 그대로 유지됩니다. 단어 내에서 줄 바꿈을 하려면 setWordWrapMode()를 사용합니다. 줄 바꿈 모드를 FixedPixelWidth 또는 FixedColumnWidth 로 설정한 경우에는 원하는 너비로 setLineWrapColumnOrWidth()를 호출해야 합니다.
함수 액세스:
QTextEdit::LineWrapMode | lineWrapMode() const |
void | setLineWrapMode(QTextEdit::LineWrapMode mode) |
lineWrapColumnOrWidth 를참조하세요 .
markdown : QString
이 속성은 텍스트 편집 텍스트에 마크다운 인터페이스를 제공합니다.
toMarkdown()
는 텍스트 편집의 텍스트를 HTML 서식이 포함되지 않은 "순수한" 마크다운으로 반환합니다. QTextDocument 에서 지원하는 일부 기능(예: 특정 색상 및 명명된 글꼴 사용)은 "순수한" 마크다운으로 표현할 수 없으므로 생략됩니다.
setMarkdown()
텍스트 편집의 텍스트를 변경합니다. 이전 텍스트가 모두 제거되고 실행 취소/다시 실행 기록이 지워집니다. 입력 텍스트는 마크다운 형식의 서식 있는 텍스트로 해석됩니다.
markdown 문자열에 포함된 HTML의 구문 분석은 setHtml 에서와 동일한 방식으로 처리되지만, HTML 블록 내부의 마크다운 서식은 지원되지 않습니다.
구문 분석기의 일부 기능은 features 인수를 통해 활성화 또는 비활성화할 수 있습니다:
상수 | 설명 |
---|---|
MarkdownNoHTML | 마크다운 텍스트의 모든 HTML 태그가 삭제됩니다. |
MarkdownDialectCommonMark | 파서는 CommonMark에서 표준화한 기능만 지원합니다. |
MarkdownDialectGitHub | 구문 분석기는 GitHub 방언을 지원합니다. |
기본값은 MarkdownDialectGitHub
입니다.
기능에 액세스합니다:
QString | toMarkdown(QTextDocument::MarkdownFeatures features = QTextDocument::MarkdownDialectGitHub) const |
void | setMarkdown(const QString &markdown) |
알림 신호:
void | textChanged() |
plainText, html, QTextDocument::toMarkdown() 및 QTextDocument::setMarkdown()도 참조하세요 .
overwriteMode : bool
이 속성은 사용자가 입력한 텍스트를 기존 텍스트를 덮어쓸지 여부를 나타냅니다.
많은 텍스트 편집기와 마찬가지로 텍스트 편집기 위젯은 사용자가 입력한 새 텍스트로 기존 텍스트를 삽입하거나 덮어쓰도록 구성할 수 있습니다.
이 속성이 true
인 경우 기존 텍스트를 새 텍스트로 한 글자씩 덮어쓰고, 그렇지 않으면 커서 위치에 텍스트가 삽입되어 기존 텍스트를 대체합니다.
기본적으로 이 속성은 false
입니다(새 텍스트는 기존 텍스트를 덮어쓰지 않음).
함수 액세스:
bool | overwriteMode() const |
void | setOverwriteMode(bool overwrite) |
placeholderText : QString
이 속성은 편집기 플레이스홀더 텍스트를 보유합니다.
이 속성을 설정하면 document()가 비어 있는 한 편집기에 회색으로 표시된 플레이스홀더 텍스트가 표시됩니다.
기본적으로 이 속성에는 빈 문자열이 포함됩니다.
함수 액세스:
QString | placeholderText() const |
void | setPlaceholderText(const QString &placeholderText) |
document()도 참조하세요 .
plainText : QString
이 속성은 텍스트 편집기의 내용을 일반 텍스트로 유지합니다.
이 속성을 설정하면 이전 콘텐츠가 제거되고 실행 취소/다시 실행 기록이 초기화됩니다. currentCharFormat()도 textCursor()가 이미 문서의 시작 부분에 있는 경우를 제외하고는 초기화됩니다.
텍스트 편집에 다른 콘텐츠 유형이 있는 경우 toPlainText()를 호출해도 일반 텍스트로 대체되지 않습니다. 유일한 예외는 공백이 아닌 공백인 nbsp;이 표준 공백으로 변환되는 경우입니다.
기본적으로 콘텐츠가 없는 편집기의 경우 이 속성에는 빈 문자열이 포함됩니다.
함수 액세스:
QString | toPlainText() const |
void | setPlainText(const QString &text) |
html 를참조하세요 .
readOnly : bool
이 속성은 텍스트 편집이 읽기 전용인지 여부를 나타냅니다.
읽기 전용 텍스트 편집에서는 사용자가 텍스트를 탐색하고 텍스트를 선택할 수만 있으며 텍스트를 수정할 수 없습니다.
이 속성의 기본값은 거짓입니다.
액세스 기능:
bool | isReadOnly() const |
void | setReadOnly(bool ro) |
tabChangesFocus : bool
이 속성은 Tab 포커스를 변경하거나 입력으로 허용할지 여부를 보유합니다.
경우에 따라 텍스트 편집에서 사용자가 표를 입력하거나 Tab 키를 사용하여 들여쓰기를 변경할 수 없도록 해야 하는 경우가 있는데, 이는 포커스 체인을 깨뜨리기 때문입니다. 기본값은 거짓입니다.
액세스 기능:
bool | tabChangesFocus() const |
void | setTabChangesFocus(bool b) |
tabStopDistance : qreal
이 속성은 탭 정지 거리를 픽셀 단위로 저장합니다.
기본적으로 이 속성에는 80픽셀의 값이 포함됩니다.
QChar::VisualTabCharacter 문자의 horizontalAdvance()보다 작은 값으로 설정하지 마십시오. 그렇지 않으면 탭 문자가 불완전하게 그려집니다.
함수 액세스:
qreal | tabStopDistance() const |
void | setTabStopDistance(qreal distance) |
QTextOption::ShowTabsAndSpaces 및 QTextDocument::defaultTextOption 을참조하세요 .
textInteractionFlags : Qt::TextInteractionFlags
위젯이 사용자 입력과 상호 작용하는 방식을 지정합니다.
기본값은 QTextEdit 이 읽기 전용인지 편집 가능한지, QTextBrowser 인지 여부에 따라 달라집니다.
액세스 기능:
Qt::TextInteractionFlags | textInteractionFlags() const |
void | setTextInteractionFlags(Qt::TextInteractionFlags flags) |
undoRedoEnabled : bool
이 속성은 실행 취소 및 다시 실행이 활성화되어 있는지 여부를 나타냅니다.
이 속성이 참이고 실행 취소(또는 다시 실행)할 수 있는 작업이 있는 경우에만 사용자가 작업을 실행 취소하거나 다시 실행할 수 있습니다.
액세스 기능:
bool | isUndoRedoEnabled() const |
void | setUndoRedoEnabled(bool enable) |
wordWrapMode : QTextOption::WrapMode
이 속성은 단어로 텍스트를 래핑할 때 QTextEdit 모드가 사용됩니다.
기본적으로 이 속성은 QTextOption::WrapAtWordBoundaryOrAnywhere 로 설정됩니다.
함수에 액세스합니다:
QTextOption::WrapMode | wordWrapMode() const |
void | setWordWrapMode(QTextOption::WrapMode policy) |
QTextOption::WrapMode 를참조하세요 .
멤버 함수 문서
[explicit]
QTextEdit::QTextEdit(QWidget *parent = nullptr)
부모가 parent 로 빈 QTextEdit를 생성합니다.
[explicit]
QTextEdit::QTextEdit(const QString &text, QWidget *parent = nullptr)
부모 parent 를 가진 QTextEdit를 생성합니다. 텍스트 편집은 text 라는 텍스트를 표시합니다. 텍스트는 HTML로 해석됩니다.
[virtual noexcept]
QTextEdit::~QTextEdit()
파괴자.
Qt::Alignment QTextEdit::alignment() const
현재 단락의 정렬을 반환합니다.
setAlignment()도 참조하세요 .
QString QTextEdit::anchorAt(const QPoint &pos) const
pos 위치에 있는 앵커의 참조를 반환하거나 해당 지점에 앵커가 없는 경우 빈 문자열을 반환합니다.
[slot]
void QTextEdit::append(const QString &text)
텍스트 편집의 끝에 text 를 사용하여 새 단락을 추가합니다.
참고: 추가된 새 단락은 커서의 위치에 따라 현재 단락과 동일한 문자 형식 및 블록 형식을 갖습니다.
currentCharFormat() 및 QTextCursor::blockFormat()도 참조하세요 .
[virtual protected]
bool QTextEdit::canInsertFromMimeData(const QMimeData *source) const
이 함수는 source 에 지정된 MIME 데이터 객체의 내용을 디코딩하여 문서에 삽입할 수 있는 경우 true
를 반환합니다. 예를 들어 드래그 작업 중에 마우스가 이 위젯에 들어가서 드래그 앤 드롭 작업을 허용할 수 있는지 여부를 확인해야 할 때 호출됩니다.
이 함수를 다시 구현하여 추가 MIME 유형에 대한 드래그 앤 드롭 지원을 활성화합니다.
bool QTextEdit::canPaste() const
클립보드에서 텍스트 편집에 텍스트를 붙여넣을 수 있는지 여부를 반환합니다.
[override virtual protected]
void QTextEdit::changeEvent(QEvent *e)
다시 구현합니다: QFrame::changeEvent(QEvent *ev).
[slot]
void QTextEdit::clear()
텍스트 편집의 모든 텍스트를 삭제합니다.
메모:
- 실행 취소/다시 실행 기록도 지워집니다.
- currentCharFormat()는 textCursor()가 이미 문서 시작 부분에 있는 경우를 제외하고는 초기화됩니다.
cut(), setPlainText() 및 setHtml()도 참조하세요 .
[override virtual protected]
void QTextEdit::contextMenuEvent(QContextMenuEvent *event)
다시 구현합니다: QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e).
createStandardContextMenu()로 만든 표준 컨텍스트 메뉴를 표시합니다.
텍스트 편집에 컨텍스트 메뉴를 표시하지 않으려면 contextMenuPolicy 을 Qt::NoContextMenu 으로 설정하면 됩니다. 컨텍스트 메뉴를 사용자 지정하려면 이 함수를 다시 구현하세요. 표준 컨텍스트 메뉴를 확장하려면 이 함수를 다시 구현하고 createStandardContextMenu()를 호출하여 반환된 메뉴를 확장합니다.
이벤트에 대한 정보는 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()
선택한 텍스트를 클립보드에 복사합니다.
copyAvailable()도 참조하세요 .
[signal]
void QTextEdit::copyAvailable(bool yes)
이 신호는 텍스트 편집에서 텍스트를 선택하거나 선택 취소할 때 발생합니다.
텍스트가 선택된 경우 yes 을 참으로 설정하면 이 신호가 전송됩니다. 텍스트가 선택되지 않았거나 선택된 텍스트가 선택 취소된 경우 이 신호는 yes 이 거짓으로 설정된 상태로 전송됩니다.
yes 가 참이면 copy()를 사용하여 선택 내용을 클립보드에 복사할 수 있습니다. yes 이 거짓이면 copy()은 아무 작업도 수행하지 않습니다.
selectionChanged()도 참조하세요 .
[virtual protected]
QMimeData *QTextEdit::createMimeDataFromSelection() const
이 함수는 텍스트 편집기의 현재 선택 내용을 나타내는 새 MIME 데이터 객체를 반환합니다. 이 함수는 선택 영역을 새 QMimeData 객체로 캡슐화해야 할 때(예: 끌어서 놓기 작업을 시작하거나 데이터를 클립보드에 복사할 때) 호출됩니다.
이 함수를 다시 구현하는 경우 반환된 QMimeData 객체의 소유권이 호출자에게 전달된다는 점에 유의하세요. 선택 항목은 textCursor() 함수를 사용하여 검색할 수 있습니다.
QMenu *QTextEdit::createStandardContextMenu()
이 함수는 사용자가 마우스 오른쪽 버튼으로 텍스트 편집을 클릭할 때 표시되는 표준 컨텍스트 메뉴를 만듭니다. 이 함수는 기본 contextMenuEvent() 핸들러에서 호출됩니다. 팝업 메뉴의 소유권은 호출자에게 이전됩니다.
대신 사용자가 클릭한 위치에 따라 동작을 활성화하는 createStandardContextMenu(QPoint) 버전을 사용하는 것이 좋습니다.
QMenu *QTextEdit::createStandardContextMenu(const QPoint &position)
이 함수는 사용자가 마우스 오른쪽 버튼으로 텍스트 편집을 클릭할 때 표시되는 표준 상황에 맞는 메뉴를 만듭니다. 이 함수는 기본 contextMenuEvent() 핸들러에서 호출되며 마우스 클릭이 있었던 문서 좌표의 position 을 사용합니다. 이를 통해 사용자가 클릭한 위치에 민감한 작업을 활성화할 수 있습니다. 팝업 메뉴의 소유권은 호출자에게 이전됩니다.
QTextCharFormat QTextEdit::currentCharFormat() const
새 텍스트를 삽입할 때 사용되는 문자 형식을 반환합니다.
setCurrentCharFormat()도 참조하세요 .
[signal]
void QTextEdit::currentCharFormatChanged(const QTextCharFormat &f)
이 신호는 커서 위치 변경 등으로 인해 현재 문자 형식이 변경된 경우 발생합니다.
새 형식은 f 입니다.
setCurrentCharFormat()도 참조하세요 .
QFont QTextEdit::currentFont() const
현재 형식의 글꼴을 반환합니다.
setCurrentFont(), setFontFamily() 및 setFontPointSize()도 참조하세요 .
QTextCursor QTextEdit::cursorForPosition(const QPoint &pos) const
는 위치 pos (뷰포트 좌표)에 QTextCursor 를 반환합니다.
[signal]
void QTextEdit::cursorPositionChanged()
이 신호는 커서 위치가 변경될 때마다 발생합니다.
QRect QTextEdit::cursorRect() const
텍스트 편집 커서가 포함된 직사각형(뷰포트 좌표)을 반환합니다.
QRect QTextEdit::cursorRect(const QTextCursor &cursor) const
은 cursor 을 포함하는 직사각형(뷰포트 좌표)을 반환합니다.
[slot]
void QTextEdit::cut()
선택한 텍스트를 클립보드에 복사하고 텍스트 수정에서 삭제합니다.
선택한 텍스트가 없으면 아무 일도 일어나지 않습니다.
[override virtual protected]
void QTextEdit::dragEnterEvent(QDragEnterEvent *e)
다시 구현합니다: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent * 이벤트).
[override virtual protected]
void QTextEdit::dragLeaveEvent(QDragLeaveEvent *e)
다시 구현합니다: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent * 이벤트).
[override virtual protected]
void QTextEdit::dragMoveEvent(QDragMoveEvent *e)
다시 구현합니다: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent * 이벤트).
[override virtual protected]
void QTextEdit::dropEvent(QDropEvent *e)
다시 구현합니다: QAbstractScrollArea::dropEvent(QDropEvent * 이벤트).
void QTextEdit::ensureCursorVisible()
필요한 경우 텍스트 편집을 스크롤하여 커서가 보이도록 합니다.
QList<QTextEdit::ExtraSelection> QTextEdit::extraSelections() const
이전에 설정한 추가 선택 항목을 반환합니다.
setExtraSelections()도 참조하세요 .
bool QTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())
주어진 options 을 사용하여 문자열의 다음 항목인 exp 을 찾습니다. exp 이 발견되면 true
을 반환하고 일치하는 항목을 선택하도록 커서를 변경하고, 그렇지 않으면 false
을 반환합니다.
bool QTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())
이것은 오버로드된 함수입니다.
주어진 options 을 사용하여 정규식 exp 과 일치하는 다음 항목을 찾습니다.
일치하는 항목이 발견되면 true
을 반환하고 일치 항목을 선택하도록 커서를 변경하며, 그렇지 않으면 false
을 반환합니다.
경고: 역사적인 이유로 exp 에 설정된 대/소문자 구분 옵션은 무시됩니다. 대신 options 을 사용하여 검색이 대소문자를 구분하는지 여부를 결정합니다.
[override virtual protected]
void QTextEdit::focusInEvent(QFocusEvent *e)
다시 구현합니다: QWidget::focusInEvent(QFocusEvent * 이벤트).
[override virtual protected]
bool QTextEdit::focusNextPrevChild(bool next)
다시 구현합니다: QWidget::focusNextPrevChild(다음 부울).
[override virtual protected]
void QTextEdit::focusOutEvent(QFocusEvent *e)
다시 구현합니다: QWidget::focusOutEvent(QFocusEvent * 이벤트).
QString QTextEdit::fontFamily() const
현재 형식의 글꼴 패밀리를 반환합니다.
setFontFamily(), setCurrentFont() 및 setFontPointSize()도 참조하세요 .
bool QTextEdit::fontItalic() const
현재 형식의 글꼴이 이탤릭체이면 true
을 반환하고, 그렇지 않으면 false를 반환합니다.
setFontItalic()도 참조하세요 .
qreal QTextEdit::fontPointSize() const
현재 형식의 글꼴의 포인트 크기를 반환합니다.
setFontFamily(), setCurrentFont() 및 setFontPointSize()도 참조하세요 .
bool QTextEdit::fontUnderline() const
현재 형식의 글꼴에 밑줄이 그어져 있으면 true
을 반환하고, 그렇지 않으면 false를 반환합니다.
setFontUnderline()도 참조하세요 .
int QTextEdit::fontWeight() const
현재 형식의 글꼴 무게를 반환합니다.
setFontWeight(), setCurrentFont(), setFontPointSize() 및 QFont::Weight 를참조하세요 .
[override virtual protected]
void QTextEdit::inputMethodEvent(QInputMethodEvent *e)
다시 구현합니다: QWidget::inputMethodEvent(Q입력메소드이벤트 *이벤트).
[override virtual]
QVariant QTextEdit::inputMethodQuery(Qt::InputMethodQuery property) const
재구현합니다: QWidget::inputMethodQuery(Qt::InputMethodQuery 쿼리) const.
[virtual protected]
void QTextEdit::insertFromMimeData(const QMimeData *source)
이 함수는 현재 커서 위치의 텍스트 편집에 source 로 지정된 MIME 데이터 객체의 내용을 삽입합니다. 클립보드 붙여넣기 작업의 결과로 텍스트가 삽입되거나 텍스트 편집이 드래그 앤 드롭 작업의 데이터를 받아들일 때마다 호출됩니다.
이 함수를 다시 구현하여 추가 MIME 유형에 대한 드래그 앤 드롭 지원을 활성화합니다.
[slot]
void QTextEdit::insertHtml(const QString &text)
현재 커서 위치에 HTML 서식으로 가정된 text 을 삽입하는 편의 슬롯입니다.
와 동일합니다:
edit->textCursor().insertHtml(fragment);
참고: 이 함수를 스타일 시트와 함께 사용하면 스타일 시트는 문서의 현재 블록에만 적용됩니다. 문서 전체에 스타일시트를 적용하려면 QTextDocument::setDefaultStyleSheet()를 대신 사용하세요.
[slot]
void QTextEdit::insertPlainText(const QString &text)
현재 커서 위치에 text 을 삽입하는 편의 슬롯입니다.
이는 다음과 같습니다.
edit->textCursor().insertText(text);
[override virtual protected]
void QTextEdit::keyPressEvent(QKeyEvent *e)
다시 구현합니다: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).
[override virtual protected]
void QTextEdit::keyReleaseEvent(QKeyEvent *e)
다시 구현합니다: QWidget::keyReleaseEvent(QKeyEvent * 이벤트).
[virtual invokable]
QVariant QTextEdit::loadResource(int type, const QUrl &name)
주어진 type 및 name 에 지정된 리소스를 로드합니다.
이 함수는 QTextDocument::loadResource()의 확장입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하세요.
QTextDocument::loadResource()도 참조하세요 .
void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)
편집기의 커서에서 QTextCursor::mergeCharFormat 을 호출하여 modifier 에 지정된 속성을 현재 문자 형식으로 병합합니다. 편집기에 선택 항목이 있는 경우 modifier 의 속성이 선택 항목에 직접 적용됩니다.
QTextCursor::mergeCharFormat()도 참조하세요 .
[override virtual protected]
void QTextEdit::mouseDoubleClickEvent(QMouseEvent *e)
다시 구현합니다: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).
[override virtual protected]
void QTextEdit::mouseMoveEvent(QMouseEvent *e)
다시 구현합니다: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).
[override virtual protected]
void QTextEdit::mousePressEvent(QMouseEvent *e)
다시 구현합니다: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).
[override virtual protected]
void QTextEdit::mouseReleaseEvent(QMouseEvent *e)
다시 구현합니다: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).
void QTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)
주어진 operation 을 수행하여 커서를 이동합니다.
mode 가 QTextCursor::KeepAnchor 인 경우 커서가 이동하는 텍스트를 선택합니다. 이는 사용자가 Shift 키를 누른 상태에서 커서 키를 사용하여 커서를 이동할 때와 동일한 효과를 얻을 수 있습니다.
QTextCursor::movePosition()도 참조하세요 .
[override virtual protected]
void QTextEdit::paintEvent(QPaintEvent *event)
다시 구현합니다: QAbstractScrollArea::paintEvent(QPaintEvent * 이벤트).
이 이벤트 핸들러는 event 에서 전달된 페인트 이벤트를 수신하기 위해 서브클래스에서 다시 구현할 수 있습니다. 일반적으로 QTextEdit 의 서브클래스에서 이 함수를 다시 구현할 필요는 없습니다.
경고: 이 함수를 재구현하는 과정에서 기초 텍스트 문서를 수정해서는 안 됩니다.
[slot]
void QTextEdit::paste()
클립보드의 텍스트를 현재 커서 위치의 텍스트 수정란에 붙여넣습니다.
클립보드에 텍스트가 없으면 아무 일도 일어나지 않습니다.
이 함수의 동작을 변경하려면(즉, QTextEdit 붙여넣을 수 있는 내용과 붙여넣는 방법을 수정하려면) 가상 canInsertFromMimeData() 및 insertFromMimeData() 함수를 다시 구현합니다.
void QTextEdit::print(QPagedPaintDevice *printer) const
텍스트 편집 문서를 지정된 printer 으로 인쇄하는 편의 함수입니다. 이 함수는 인쇄 범위로 QPrinter::Selection도 지원한다는 점을 제외하면 문서에서 직접 인쇄 메서드를 호출하는 것과 동일합니다.
QTextDocument::print()도 참조하세요 .
[slot]
void QTextEdit::redo()
마지막 작업을 다시 실행합니다.
다시 실행할 작업이 없는 경우, 즉 실행 취소/다시 실행 기록에 다시 실행 단계가 없는 경우 아무 일도 일어나지 않습니다.
undo()도 참조하세요 .
[signal]
void QTextEdit::redoAvailable(bool available)
이 신호는 다시 실행 작업을 사용할 수 있게 되거나(available 참) 사용할 수 없게 될 때마다(available 거짓) 전송됩니다.
[override virtual protected]
void QTextEdit::resizeEvent(QResizeEvent *e)
다시 구현합니다: QAbstractScrollArea::resizeEvent(QResizeEvent * 이벤트).
[override virtual protected]
void QTextEdit::scrollContentsBy(int dx, int dy)
재구현합니다: QAbstractScrollArea::scrollContentsBy(int dx, int dy).
[slot]
void QTextEdit::scrollToAnchor(const QString &name)
지정된 name 앵커가 보이도록 텍스트 편집을 스크롤하고, name 이 비어 있거나 이미 보이거나 찾을 수 없는 경우 아무 작업도 수행하지 않습니다.
[slot]
void QTextEdit::selectAll()
모든 텍스트를 선택합니다.
copy(), cut() 및 textCursor()도 참조하세요 .
[signal]
void QTextEdit::selectionChanged()
이 신호는 선택 항목이 변경될 때마다 발산됩니다.
copyAvailable()도 참조하세요 .
[slot]
void QTextEdit::setAlignment(Qt::Alignment a)
현재 단락의 맞춤을 a 으로 설정합니다. 유효한 정렬은 Qt::AlignLeft, Qt::AlignRight, Qt::AlignJustify 및 Qt::AlignCenter (가로로 중앙에 위치)입니다.
alignment()도 참조하세요 .
void QTextEdit::setCurrentCharFormat(const QTextCharFormat &format)
편집기의 커서에서 QTextCursor::setCharFormat()을 호출하여 새 텍스트를 삽입할 때 사용할 문자 형식을 format 로 설정합니다. 편집기에 선택 영역이 있는 경우 선택 영역에 문자 형식이 직접 적용됩니다.
currentCharFormat()도 참조하세요 .
[slot]
void QTextEdit::setCurrentFont(const QFont &f)
현재 형식의 글꼴을 f 로 설정합니다.
currentFont(), setFontPointSize() 및 setFontFamily()도 참조하세요 .
void QTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)
이 기능을 사용하면 문서의 특정 영역을 지정된 색상( selections 으로 지정)으로 임시로 표시할 수 있습니다. 예를 들어 프로그래밍 편집기에서 중단점이 있음을 나타내기 위해 전체 텍스트 줄을 지정된 배경색으로 표시하는 데 유용할 수 있습니다.
QTextEdit::ExtraSelection 및 extraSelections()도 참조하세요 .
[slot]
void QTextEdit::setFontFamily(const QString &fontFamily)
현재 형식의 글꼴 패밀리를 fontFamily 로 설정합니다.
fontFamily() 및 setCurrentFont()도 참조하세요 .
[slot]
void QTextEdit::setFontItalic(bool italic)
italic 이 참이면 현재 형식을 이탤릭체로 설정하고, 그렇지 않으면 현재 형식을 이탤릭체가 아닌 것으로 설정합니다.
fontItalic()도 참조하세요 .
[slot]
void QTextEdit::setFontPointSize(qreal s)
현재 형식의 포인트 크기를 s 로 설정합니다.
s 이 0이거나 음수이면 이 함수의 동작이 정의되지 않습니다.
fontPointSize(), setCurrentFont() 및 setFontFamily()도 참조하세요 .
[slot]
void QTextEdit::setFontUnderline(bool underline)
underline 이 참이면 현재 서식을 밑줄로 설정하고, 그렇지 않으면 현재 서식을 밑줄 없음으로 설정합니다.
fontUnderline()도 참조하세요 .
[slot]
void QTextEdit::setFontWeight(int weight)
현재 형식의 글꼴 굵기를 지정된 weight 으로 설정합니다. 여기서 사용되는 값은 QFont::Weight 열거형에 정의된 범위입니다.
fontWeight(), setCurrentFont() 및 setFontFamily()도 참조하세요 .
[slot]
void QTextEdit::setPlainText(const QString &text)
텍스트 편집의 텍스트를 text 문자열로 변경합니다. 이전 텍스트는 모두 제거됩니다.
Notes:
- text 는 일반 텍스트로 해석됩니다.
- 실행 취소/다시 실행 기록도 지워집니다.
- currentCharFormat()는 textCursor()가 이미 문서의 시작 부분에 있지 않는 한 재설정됩니다.
참고: 속성에 대한 설정자 함수 plainText.
toPlainText()도 참조하세요 .
[slot]
void QTextEdit::setText(const QString &text)
텍스트 편집의 text 을 설정합니다. 텍스트는 일반 텍스트 또는 HTML일 수 있으며 텍스트 편집은 올바른 형식을 추측하려고 시도합니다.
setHtml() 또는 setPlainText()를 직접 사용하여 텍스트 편집이 추측하지 않도록 하세요.
toPlainText() 및 toHtml()도 참조하세요 .
[slot]
void QTextEdit::setTextBackgroundColor(const QColor &c)
현재 형식의 텍스트 배경색을 c 로 설정합니다.
textBackgroundColor()도 참조하세요 .
[slot]
void QTextEdit::setTextColor(const QColor &c)
현재 형식의 텍스트 색상을 c 로 설정합니다.
textColor()도 참조하세요 .
void QTextEdit::setTextCursor(const QTextCursor &cursor)
표시되는 cursor 을 설정합니다.
textCursor()도 참조하세요 .
[override virtual protected]
void QTextEdit::showEvent(QShowEvent *)
다시 구현합니다: QWidget::showEvent(QShowEvent * 이벤트).
QColor QTextEdit::textBackgroundColor() const
현재 형식의 텍스트 배경색을 반환합니다.
setTextBackgroundColor()도 참조하세요 .
[signal]
void QTextEdit::textChanged()
이 신호는 문서 콘텐츠가 변경될 때마다(예: 텍스트가 삽입 또는 삭제되거나 서식이 적용될 때) 발신됩니다.
QColor QTextEdit::textColor() const
현재 형식의 텍스트 색상을 반환합니다.
setTextColor()도 참조하세요 .
QTextCursor QTextEdit::textCursor() const
현재 표시된 커서를 나타내는 QTextCursor 복사본을 반환합니다. 반환된 커서의 변경 사항은 QTextEdit 의 커서에는 영향을 주지 않으므로 setTextCursor()를 사용하여 표시된 커서를 업데이트합니다.
setTextCursor()도 참조하세요 .
QString QTextEdit::toPlainText() const
QString QTextEdit::toPlainText() const
텍스트 편집의 텍스트를 일반 텍스트로 반환합니다.
참고: plainText 속성에 대한 게터 함수입니다.
QTextEdit::setPlainText()도 참조하세요 .
[slot]
void QTextEdit::undo()
마지막 작업을 실행 취소합니다.
실행 취소할 작업이 없는 경우, 즉 실행 취소/다시 실행 기록에 실행 취소 단계가 없는 경우 아무 일도 일어나지 않습니다.
redo()도 참조하세요 .
[signal]
void QTextEdit::undoAvailable(bool available)
이 신호는 실행 취소 작업을 사용할 수 있게 되거나(available 참) 사용할 수 없게 될 때마다(available 거짓) 전송됩니다.
[override virtual protected]
void QTextEdit::wheelEvent(QWheelEvent *e)
다시 구현합니다: QAbstractScrollArea::wheelEvent(QWheelEvent *e).
[slot]
void QTextEdit::zoomIn(int range = 1)
기본 글꼴 크기 range 포인트를 더 크게 만들고 모든 글꼴 크기를 새 크기로 다시 계산하여 텍스트를 확대합니다. 이렇게 해도 이미지의 크기는 변경되지 않습니다.
zoomOut()도 참조하세요 .
[slot]
void QTextEdit::zoomOut(int range = 1)
기본 글꼴 크기 range 포인트를 더 작게 만들고 모든 글꼴 크기를 새 크기로 다시 계산하여 텍스트를 축소합니다. 이 경우 이미지의 크기는 변경되지 않습니다.
zoomIn()도 참조하세요 .
© 2025 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.