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

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

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

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

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

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

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

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

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

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

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

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

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

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

viewport()의 페인트 컨텍스트를 반환하며, 이는 paintEvent()을 재구현할 때만 유용합니다.

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

QWidget::inputMethodEvent(QInputMethodEvent *event)를 재구현합니다.

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

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

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

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

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

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

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

void QPlainTextEdit::mergeCurrentCharFormat(const QTextCharFormat &modifier)

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

QTextCursor::mergeCharFormat()도 참조하십시오 .

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

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

예를 들어, 문서에 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 *event)를 재구현합니다.

[slot] void QPlainTextEdit::paste()

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

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

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

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

void QPlainTextEdit::print(QPagedPaintDevice *printer) const

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

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

[slot] void QPlainTextEdit::redo()

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

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

undo()도 참조하십시오 .

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

이 신호는 재실행(redo) 작업이 가능해졌을 때(available 가 true인 경우) 또는 불가능해졌을 때(available 가 false인 경우) 발송됩니다.

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

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

[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 로 지정된 색상으로 일시적으로 표시할 수 있게 해줍니다. 예를 들어, 프로그래밍 편집기에서 중단점(breakpoint)의 존재를 나타내기 위해 전체 텍스트 줄을 지정된 배경색으로 표시하는 데 유용할 수 있습니다.

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

[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 가 true인 경우) 또는 불가능해졌을 때(available 가 false인 경우) 발생합니다.

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