QPlainTextEdit Class

メンバ関数ドキュメント

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

空の QPlainTextEdit を親parent で構築します。

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

親を持つQPlainTextEditを構築するparent 。テキスト編集はプレーンテキストを表示します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

テキストをクリップボードからtexteditにペーストできるかどうかを返します。

[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 にマッチする次の出現箇所を検索します。

falseマッチするものが見つかればtrue を返し、マッチするものを選択するようにカーソルを変更します。

[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(Qt::InputMethodQuery query) 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 *event)。

[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 が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 に印刷するための便利な関数です。この関数は印刷範囲としてQPrinter::Selectionもサポートしていることを除けば、ドキュメントに対して直接printメソッドを呼び出すのと同じです。

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 で指定 さ れた色でマー ク する こ と がで き ます。これは、例えばプログラミングエディタで、ブレークポイントの存在を示すために、テキスト行全体を指定された背景色でマークするのに便利です。

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 のコピーを返す。setTextCursor返されたカーソルの変更は、QPlainTextEdit のカーソルには影響しないことに注意すること。

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()も参照 。