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 을 참으로 설정하면 이 신호가 전송됩니다. 텍스트가 선택되지 않았거나 선택된 텍스트가 선택 취소된 경우 이 신호는 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()

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

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

copy() 및 paste()도 참조하세요 .

[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 을 반환합니다.

[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);

[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()의 확장입니다.

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() 함수를 다시 구현합니다.

cut() 및 copy()도 참조하세요 .

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()가 이미 문서의 시작 부분에 있지 않는 한 재설정됩니다.

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

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

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()도 참조하세요 .