QTextEdit Class

멤버 함수 설명서

[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 `가 true로 설정된 상태로 발생합니다. 텍스트가 선택되지 않았거나 선택된 텍스트의 선택이 해제되면 이 신호는 ` yes `가 false로 설정된 상태로 발생합니다.

yes 가 true인 경우, copy()를 사용하여 선택 영역을 클립보드에 복사할 수 있습니다. yes 가 false인 경우, 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()

선택한 텍스트를 클립보드에 복사하고 텍스트 편집창에서 삭제합니다.

선택된 텍스트가 없으면 아무 일도 일어나지 않습니다.

copy() 및 paste()도 참조하십시오 .

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

QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event)를 재구현합니다.

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

QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)를 재구현합니다.

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

QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)를 재구현합니다.

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

QAbstractScrollArea::dropEvent(QDropEvent *event)를 재구현합니다.

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`를 반환합니다.

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

QWidget::focusInEvent(QFocusEvent *event)를 재구현합니다.

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

QWidget::focusNextPrevChild(bool next)를 재구현합니다.

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

QWidget::focusOutEvent(QFocusEvent *event)를 재구현합니다.

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(QInputMethodEvent *event)를 재구현합니다.

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

QWidget::inputMethodQuery(const Qt::InputMethodQuery query)를 재구현합니다.

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

이 함수는 ` source`로 지정된 MIME 데이터 객체의 내용을 현재 커서 위치의 텍스트 편집창에 삽입합니다. 이 함수는 클립보드 붙여넣기 작업의 결과로 텍스트가 삽입될 때마다, 또는 텍스트 편집창이 드래그 앤 드롭 작업으로 데이터를 수락할 때마다 호출됩니다.

추가적인 MIME 유형에 대한 드래그 앤 드롭 지원을 활성화하려면 이 함수를 재구현하십시오.

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

현재 커서 위치에 HTML 형식으로 가정되는 text 를 삽입하는 편리한 슬롯입니다.

이는 다음과 동일합니다:

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

[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 *event)를 재구현합니다.

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

주어진 type 및 name 로 지정된 리소스를 불러옵니다.

이 함수는 QTextDocument::loadResource()의 확장 기능입니다.

QTextDocument::loadResource()도 참조하십시오 .

void QTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

modifier 에 지정된 속성을 편집기의 커서에 대해 QTextCursor::mergeCharFormat 를 호출하여 현재 문자 형식에 병합합니다. 편집기에 선택 영역이 있는 경우, 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).

이 이벤트 핸들러는 하위 클래스에서 재구현하여 ` event`를 통해 전달되는 페인트 이벤트를 수신할 수 있습니다. 일반적으로 ` QTextEdit`의 하위 클래스에서 이 함수를 재구현할 필요는 없습니다.

[slot] void QTextEdit::paste()

클립보드에 있는 텍스트를 현재 커서 위치의 텍스트 입력란에 붙여 넣습니다.

클립보드에 텍스트가 없으면 아무 일도 일어나지 않습니다.

이 함수의 동작, 즉 ` QTextEdit `가 붙여넣을 수 있는 내용과 붙여넣는 방식을 변경하려면 가상 함수 ` canInsertFromMimeData()` 및 ` insertFromMimeData()`를 재구현하십시오.

cut() 및 copy()도 참조하십시오 .

void QTextEdit::print(QPagedPaintDevice *printer) const

텍스트 편집기의 문서를 지정된 ` printer`에 인쇄하는 편리한 함수입니다. 이 함수는 문서에 직접 `print` 메서드를 호출하는 것과 동일하지만, 인쇄 범위로 `QPrinter::Selection`도 지원한다는 점이 다릅니다.

QTextDocument::print()도 참조하십시오 .

[slot] void QTextEdit::redo()

마지막 작업을 다시 실행합니다.

다시 실행할 작업이 없는 경우, 즉 취소/다시 실행 기록에 다시 실행 단계가 없는 경우에는 아무 일도 일어나지 않습니다.

undo()도 참조하십시오 .

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

이 신호는 재실행(redo) 작업이 가능해지면(available 가 true인 경우) 또는 불가능해지면(available 가 false인 경우) 발생합니다.

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

QAbstractScrollArea::resizeEvent(QResizeEvent *event)를 재구현합니다.

[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 이 true인 경우 현재 서식을 이탤릭체로 설정하고, 그렇지 않은 경우 현재 서식을 이탤릭체가 아닌 서식으로 설정합니다.

fontItalic()도 참조하십시오 .

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

현재 형식의 글자 크기를 s 로 설정합니다.

s 가 0이거나 음수인 경우, 이 함수의 동작은 정의되지 않습니다.

fontPointSize(), setCurrentFont(), setFontFamily()도 참조하십시오 .

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

underline 가 true인 경우, 현재 서식을 밑줄로 설정하고, 그렇지 않은 경우 밑줄이 없는 서식으로 설정합니다.

fontUnderline()도 참조하십시오 .

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

현재 서식의 글꼴 두께를 지정된 weight 값으로 설정합니다. 이때 사용되는 값은 QFont::Weight 열거형에 정의된 범위 내에 있어야 합니다.

fontWeight(), setCurrentFont() 및 setFontFamily()도 참조하십시오 .

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

텍스트 편집창의 내용을 “ text ”라는 문자열로 변경합니다. 기존에 있던 텍스트는 모두 삭제됩니다.

참고:

• text 는 일반 텍스트로 해석됩니다.
• 실행 취소/다시 실행 기록도 지워집니다.
• currentCharFormat textCursor()가 이미 문서의 맨 앞에 있는 경우가 아니라면 ()가 초기화됩니다.

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 *event)를 재구현합니다.

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

텍스트 편집기의 텍스트를 일반 텍스트로 반환합니다.

QTextEdit::setPlainText()도 참조하십시오 .

[slot] void QTextEdit::undo()

마지막 작업을 취소합니다.

되돌릴 작업이 없는 경우, 즉 되돌리기/다시 실행 기록에 되돌리기 단계가 없는 경우에는 아무 일도 일어나지 않습니다.

redo()도 참조하십시오 .

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

이 신호는 되돌리기 작업이 가능해졌을 때(available 가 true인 경우) 또는 불가능해졌을 때(available 가 false인 경우) 발생합니다.

[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()도 참조하십시오 .