QPlainTextEdit Class

メンバ関数ドキュメント

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

parent を親に持つ空の QPlainTextEdit を構築します。

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

再リンプルメント: (QDragEnterEvent *event)：QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)。

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

再リンプルメント: (QDragLeaveEvent *event)：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)

再リンプルメント: (bool next)：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 が真の場合、ドキュメントは変更されたことになり、そうでない場合は偽になります。

たとえば、ドキュメントで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)

再リンプルメント: (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)

このシグナルは、やり直し操作が利用可能になる (available が真)、または利用不可能になる (available が偽)たびに発せられます。

[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()も参照してください 。