QPlainTextEdit Class

멤버 함수 문서

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

부모가 parent 인 빈 QPlainTextEdit를 생성합니다.

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

부모 parent 를 가진 QPlainTextEdit를 생성합니다. 텍스트 편집은 일반 텍스트 text 를 표시합니다.

[virtual noexcept] QPlainTextEdit::~QPlainTextEdit()

파괴자.

QString QPlainTextEdit::anchorAt(const QPoint &pos) const

pos 위치에 있는 앵커의 참조를 반환하거나 해당 지점에 앵커가 없는 경우 빈 문자열을 반환합니다.

[slot] void QPlainTextEdit::appendHtml(const QString &html)

텍스트 편집의 끝에 html 를 사용하여 새 단락을 추가합니다.

appendPlainText()

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

텍스트 편집의 끝에 text 를 사용하여 새 단락을 추가합니다.

appendHtml()도 참조하세요 .

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

block 텍스트의 경계 사각형을 콘텐츠 좌표로 반환합니다. contentOffset ()를 사용하여 직사각형을 변환하여 뷰포트에서 시각적 좌표를 가져옵니다.

firstVisibleBlock() 및 blockBoundingRect()도 참조하세요 .

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

블록의 자체 좌표로 block 텍스트의 경계 사각형을 반환합니다.

blockBoundingGeometry()도 참조하세요 .

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

이 신호는 블록 수가 변경될 때마다 전송됩니다. 새 블록 수는 newBlockCount 에 전달됩니다.

[virtual protected] bool QPlainTextEdit::canInsertFromMimeData(const QMimeData *source) const

이 함수는 source 에 지정된 MIME 데이터 객체의 내용을 디코딩하여 문서에 삽입할 수 있는 경우 true 를 반환합니다. 예를 들어 드래그 작업 중에 마우스가 이 위젯에 들어가서 드래그를 허용할 수 있는지 여부를 결정해야 할 때 호출됩니다.

bool QPlainTextEdit::canPaste() const

클립보드에서 텍스트 편집에 텍스트를 붙여넣을 수 있는지 여부를 반환합니다.

[slot] void QPlainTextEdit::centerCursor()

문서를 스크롤하여 커서를 세로로 중앙에 배치합니다.

ensureCursorVisible() 및 centerOnScroll 을참조하세요 .

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

다시 구현합니다: QFrame::changeEvent(QEvent *ev).

[slot] void QPlainTextEdit::clear()

텍스트 편집의 모든 텍스트를 삭제합니다.

메모:

• 실행 취소/다시 실행 기록도 지워집니다.
• currentCharFormat()는 textCursor()가 이미 문서 시작 부분에 있는 경우를 제외하고는 초기화됩니다.

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

[protected] QPointF QPlainTextEdit::contentOffset() const

콘텐츠의 원점을 뷰포트 좌표로 반환합니다.

일반 텍스트 편집의 콘텐츠 원점은 항상 처음 보이는 텍스트 블록의 왼쪽 상단 모서리입니다. 텍스트가 가로로 스크롤되었거나 첫 번째 보이는 블록이 화면에서 부분적으로 스크롤된 경우, 즉 보이는 텍스트가 첫 번째 보이는 블록의 첫 줄부터 시작하지 않거나 첫 번째 보이는 블록이 가장 첫 번째 블록이고 편집기에 여백이 표시되는 경우 콘텐츠 오프셋은 (0,0)과 다릅니다.

firstVisibleBlock(), horizontalScrollBar() 및 verticalScrollBar()도 참조하세요 .

[override virtual protected] void QPlainTextEdit::contextMenuEvent(QContextMenuEvent *event)

다시 구현합니다: QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e).

createStandardContextMenu()로 만든 표준 컨텍스트 메뉴를 표시합니다.

텍스트 편집에 컨텍스트 메뉴를 표시하지 않으려면 contextMenuPolicy 을 Qt::NoContextMenu 으로 설정하면 됩니다. 컨텍스트 메뉴를 사용자 지정하려면 이 함수를 다시 구현하세요. 표준 컨텍스트 메뉴를 확장하려면 이 함수를 다시 구현하고 createStandardContextMenu()를 호출하여 반환된 메뉴를 확장합니다.

이벤트에 대한 정보는 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()

선택한 텍스트를 클립보드에 복사합니다.

copyAvailable()도 참조하세요 .

[signal] void QPlainTextEdit::copyAvailable(bool yes)

이 신호는 텍스트 편집에서 텍스트를 선택하거나 선택 취소할 때 발생합니다.

텍스트가 선택된 경우 yes 을 참으로 설정하면 이 신호가 전송됩니다. 텍스트가 선택되지 않았거나 선택된 텍스트가 선택 취소된 경우 이 신호는 yes 이 거짓으로 설정된 상태로 전송됩니다.

yes 가 참이면 copy()를 사용하여 선택 내용을 클립보드에 복사할 수 있습니다. yes 이 거짓이면 copy()은 아무 작업도 수행하지 않습니다.

selectionChanged()도 참조하세요 .

[virtual protected] QMimeData *QPlainTextEdit::createMimeDataFromSelection() const

이 함수는 텍스트 편집기의 현재 선택 내용을 나타내는 새 MIME 데이터 객체를 반환합니다. 이 함수는 선택 영역을 새 QMimeData 객체로 캡슐화해야 할 때(예: 끌어서 놓기 작업을 시작하거나 데이터를 클립보드에 복사할 때) 호출됩니다.

이 함수를 다시 구현하는 경우 반환된 QMimeData 객체의 소유권이 호출자에게 전달된다는 점에 유의하세요. 선택 항목은 textCursor() 함수를 사용하여 검색할 수 있습니다.

QMenu *QPlainTextEdit::createStandardContextMenu()

이 함수는 사용자가 마우스 오른쪽 버튼으로 텍스트 편집을 클릭할 때 표시되는 표준 컨텍스트 메뉴를 만듭니다. 이 함수는 기본 contextMenuEvent() 핸들러에서 호출됩니다. 팝업 메뉴의 소유권은 호출자에게 이전됩니다.

대신 사용자가 클릭한 위치에 따라 동작을 활성화하는 createStandardContextMenu(QPoint) 버전을 사용하는 것이 좋습니다.

QMenu *QPlainTextEdit::createStandardContextMenu(const QPoint &position)

이 함수는 사용자가 마우스 오른쪽 버튼으로 텍스트 편집을 클릭할 때 표시되는 표준 상황에 맞는 메뉴를 만듭니다. 이 함수는 기본 contextMenuEvent() 핸들러에서 호출되며 마우스 클릭이 있었던 문서 좌표의 position 을 사용합니다. 이를 통해 사용자가 클릭한 위치에 민감한 작업을 활성화할 수 있습니다. 팝업 메뉴의 소유권은 호출자에게 이전됩니다.

QTextCharFormat QPlainTextEdit::currentCharFormat() const

새 텍스트를 삽입할 때 사용되는 문자 형식을 반환합니다.

setCurrentCharFormat()도 참조하세요 .

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

는 위치 pos (뷰포트 좌표)에 QTextCursor 를 반환합니다.

[signal] void QPlainTextEdit::cursorPositionChanged()

이 신호는 커서 위치가 변경될 때마다 발생합니다.

QRect QPlainTextEdit::cursorRect() const

텍스트 편집 커서가 포함된 직사각형(뷰포트 좌표)을 반환합니다.

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

은 cursor 을 포함하는 직사각형(뷰포트 좌표)을 반환합니다.

[slot] void QPlainTextEdit::cut()

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

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

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

QTextDocument *QPlainTextEdit::document() const

기본 문서에 대한 포인터를 반환합니다.

setDocument()도 참조하세요 .

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

다시 구현합니다: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent * 이벤트).

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

다시 구현합니다: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent * 이벤트).

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

다시 구현합니다: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent * 이벤트).

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

다시 구현합니다: QAbstractScrollArea::dropEvent(QDropEvent * 이벤트).

void QPlainTextEdit::ensureCursorVisible()

필요한 경우 텍스트 편집을 스크롤하여 커서가 보이도록 합니다.

centerCursor() 및 centerOnScroll 을참조하세요 .

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

이전에 설정한 추가 선택 항목을 반환합니다.

setExtraSelections()도 참조하세요 .

bool QPlainTextEdit::find(const QString &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

주어진 options 을 사용하여 문자열의 다음 항목인 exp 을 찾습니다. exp 이 발견되면 true 을 반환하고 일치하는 항목을 선택하도록 커서를 변경하고, 그렇지 않으면 false 을 반환합니다.

bool QPlainTextEdit::find(const QRegularExpression &exp, QTextDocument::FindFlags options = QTextDocument::FindFlags())

이것은 오버로드된 함수입니다.

주어진 options 을 사용하여 정규식 exp 과 일치하는 다음 항목을 찾습니다.

일치하는 항목이 발견되면 true 을 반환하고 일치 항목을 선택하도록 커서를 변경하며, 그렇지 않으면 false 을 반환합니다.

[protected] QTextBlock QPlainTextEdit::firstVisibleBlock() const

표시되는 첫 번째 블록을 반환합니다.

blockBoundingRect()도 참조하세요 .

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

다시 구현합니다: QWidget::focusInEvent(QFocusEvent * 이벤트).

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

다시 구현합니다: QWidget::focusNextPrevChild(다음 부울).

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

다시 구현합니다: QWidget::focusOutEvent(QFocusEvent * 이벤트).

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

paintEvent()을 다시 구현할 때만 유용한 viewport()에 대한 페인트 컨텍스트를 반환합니다.

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

다시 구현합니다: QWidget::inputMethodEvent(Q입력메소드이벤트 *이벤트).

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

재구현합니다: QWidget::inputMethodQuery(Qt::InputMethodQuery 쿼리) const.

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

이 함수는 현재 커서 위치의 텍스트 편집에 source 로 지정된 MIME 데이터 객체의 내용을 삽입합니다. 클립보드 붙여넣기 작업의 결과로 텍스트가 삽입되거나 텍스트 편집이 드래그 앤 드롭 작업의 데이터를 받아들일 때마다 호출됩니다.

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

현재 커서 위치에 text 을 삽입하는 편의 슬롯입니다.

이는 다음과 같습니다.

edit->textCursor().insertText(text);

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

다시 구현합니다: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

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

다시 구현합니다: QWidget::keyReleaseEvent(QKeyEvent * 이벤트).

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

주어진 type 및 name 에 지정된 리소스를 로드합니다.

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

QTextDocument::loadResource()도 참조하세요 .

void QPlainTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

편집기의 커서에서 QTextCursor::mergeCharFormat 을 호출하여 modifier 에 지정된 속성을 현재 문자 형식으로 병합합니다. 편집기에 선택 항목이 있는 경우 modifier 의 속성이 선택 항목에 직접 적용됩니다.

QTextCursor::mergeCharFormat()도 참조하세요 .

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

이 신호는 문서의 내용이 수정 상태에 영향을 미치는 방식으로 변경될 때마다 발생합니다. changed 가 참이면 문서가 수정된 것이고, 그렇지 않으면 거짓입니다.

예를 들어 문서에서 setModified(false)를 호출한 다음 텍스트를 삽입하면 이 신호가 발생합니다. 해당 작업을 실행 취소하여 문서가 수정되지 않은 원래 상태로 돌아가면 신호가 다시 발생하게 됩니다.

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

다시 구현합니다: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

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

다시 구현합니다: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

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

다시 구현합니다: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

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

다시 구현합니다: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

void QPlainTextEdit::moveCursor(QTextCursor::MoveOperation operation, QTextCursor::MoveMode mode = QTextCursor::MoveAnchor)

주어진 operation 을 수행하여 커서를 이동합니다.

mode 가 QTextCursor::KeepAnchor 인 경우 커서가 이동하는 텍스트를 선택합니다. 이는 사용자가 Shift 키를 누른 상태에서 커서 키를 사용하여 커서를 이동할 때와 동일한 효과를 얻을 수 있습니다.

QTextCursor::movePosition()도 참조하세요 .

[override virtual protected] void QPlainTextEdit::paintEvent(QPaintEvent *e)

다시 구현합니다: QAbstractScrollArea::paintEvent(QPaintEvent * 이벤트).

[slot] void QPlainTextEdit::paste()

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

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

이 함수의 동작을 변경하려면(즉, QPlainTextEdit 붙여넣을 수 있는 내용과 붙여넣는 방법을 수정하려면) 가상 canInsertFromMimeData() 및 insertFromMimeData() 함수를 다시 구현합니다.

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

void QPlainTextEdit::print(QPagedPaintDevice *printer) const

텍스트 편집 문서를 지정된 printer 으로 인쇄하는 편의 함수입니다. 이 함수는 인쇄 범위로 QPrinter::Selection도 지원한다는 점을 제외하면 문서에서 직접 인쇄 메서드를 호출하는 것과 동일합니다.

QTextDocument::print()도 참조하세요 .

[slot] void QPlainTextEdit::redo()

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

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

undo()도 참조하세요 .

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

이 신호는 다시 실행 작업을 사용할 수 있게 되거나(available 참) 사용할 수 없게 될 때마다(available 거짓) 전송됩니다.

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

다시 구현합니다: QAbstractScrollArea::resizeEvent(QResizeEvent * 이벤트).

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

재구현합니다: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

[slot] void QPlainTextEdit::selectAll()

모든 텍스트를 선택합니다.

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

[signal] void QPlainTextEdit::selectionChanged()

이 신호는 선택 항목이 변경될 때마다 발생합니다.

copyAvailable()도 참조하세요 .

void QPlainTextEdit::setCurrentCharFormat(const QTextCharFormat &format)

편집기의 커서에서 QTextCursor::setCharFormat()을 호출하여 새 텍스트를 삽입할 때 사용할 문자 형식을 format 로 설정합니다. 편집기에 선택 영역이 있는 경우 선택 영역에 문자 형식이 직접 적용됩니다.

currentCharFormat()도 참조하세요 .

void QPlainTextEdit::setDocument(QTextDocument *document)

document 을 텍스트 편집기의 새 문서로 만듭니다.

제공된 문서의 상위 문서 QObject 는 객체의 소유자로 유지됩니다. 현재 문서가 텍스트 편집기의 자식인 경우 삭제됩니다.

문서에는 QPlainTextDocumentLayout 을 상속하는 문서 레이아웃이 있어야 합니다( QTextDocument::setDocumentLayout() 참조).

document()도 참조하세요 .

void QPlainTextEdit::setExtraSelections(const QList<QTextEdit::ExtraSelection> &selections)

이 기능을 사용하면 문서의 특정 영역을 지정된 색상( selections 으로 지정)으로 임시로 표시할 수 있습니다. 예를 들어 프로그래밍 편집기에서 중단점이 있음을 나타내기 위해 전체 텍스트 줄을 지정된 배경색으로 표시하는 데 유용할 수 있습니다.

QTextEdit::ExtraSelection 및 extraSelections()도 참조하세요 .

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

텍스트 편집의 텍스트를 text 문자열로 변경합니다. 이전 텍스트는 모두 제거됩니다.

text 는 일반 텍스트로 해석됩니다.

참고:

• 실행 취소/다시 실행 기록도 지워집니다.
• currentCharFormat()는 textCursor()가 이미 문서의 시작 부분에 있지 않는 한 재설정됩니다.

toPlainText()도 참조하세요 .

void QPlainTextEdit::setTextCursor(const QTextCursor &cursor)

표시되는 cursor 을 설정합니다.

textCursor()도 참조하세요 .

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

다시 구현합니다: QWidget::showEvent(QShowEvent * 이벤트).

[signal] void QPlainTextEdit::textChanged()

이 신호는 문서 콘텐츠가 변경될 때마다(예: 텍스트가 삽입 또는 삭제되거나 서식이 적용될 때) 발신됩니다.

QTextCursor QPlainTextEdit::textCursor() const

현재 표시된 커서를 나타내는 QTextCursor 복사본을 반환합니다. 반환된 커서의 변경 사항은 QPlainTextEdit 의 커서에는 영향을 주지 않으므로 setTextCursor()를 사용하여 표시된 커서를 업데이트합니다.

setTextCursor()도 참조하세요 .

QString QPlainTextEdit::toPlainText() const

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

QPlainTextEdit::setPlainText()도 참조하세요 .

[slot] void QPlainTextEdit::undo()

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

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

redo()도 참조하세요 .

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

이 신호는 실행 취소 작업을 사용할 수 있게 되거나(available 참) 사용할 수 없게 될 때마다(available 거짓) 전송됩니다.

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

이 신호는 텍스트 문서에 지정된 rect 의 업데이트가 필요할 때 발생합니다. 텍스트가 스크롤된 경우 rect 은 전체 뷰포트 영역을 덮습니다. 텍스트가 세로로 스크롤된 경우 dy 은 뷰포트가 스크롤된 픽셀 수를 전달합니다.

이 신호의 목적은 줄 번호, 중단점 또는 기타 추가 정보를 표시하는 일반 텍스트 편집 하위 클래스에서 추가 위젯을 지원하기 위한 것입니다.

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

다시 구현합니다: QAbstractScrollArea::wheelEvent(QWheelEvent *e).

[slot] void QPlainTextEdit::zoomIn(int range = 1)

기본 글꼴 크기 range 포인트를 더 크게 만들고 모든 글꼴 크기를 새 크기로 다시 계산하여 텍스트를 확대합니다. 이렇게 해도 이미지의 크기는 변경되지 않습니다.

zoomOut()도 참조하세요 .

[slot] void QPlainTextEdit::zoomOut(int range = 1)

기본 글꼴 크기 range 포인트를 더 작게 만들고 모든 글꼴 크기를 새 크기로 다시 계산하여 텍스트를 축소합니다. 이 경우 이미지의 크기는 변경되지 않습니다.

zoomIn()도 참조하세요 .