QTextEdit Class

メンバ関数ドキュメント

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

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

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

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

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

[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 をtrueに設定して発せられる。テキストが選択されていない場合、または選択されたテキストが選択解除された場合、このシグナルはyes を false に設定して発行されます。

yes が true の場合、copy() を使って選択部分をクリップボードにコピーすることができます。yes が false の場合、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 *event)。

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

再実装：QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)。

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

再実装：QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)。

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

再実装：QAbstractScrollArea::dropEvent(QDropEvent *event)。

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

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

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

再実装：QWidget::focusInEvent(QFocusEvent *event)。

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

再インプリメント：QWidget::focusNextPrevChild(bool next).

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

再実装：QWidget::focusOutEvent(QFocusEvent *event)。

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(QInputMethodEvent *event).

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

再実装：QWidget::inputMethodQuery(Qt::InputMethodQuery query) 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 *event)。

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

このイベント・ハンドラは、event で渡されたペイント・イベントを受け取るために、サブクラスで再実装することができます。 通常、QTextEdit のサブクラスでこの関数を再実装する必要はありません。

[slot] void QTextEdit::paste()

クリップボードのテキストを現在のカーソル位置のテキスト編集に貼り付ける。

クリップボードにテキストがない場合は何も起こらない。

この関数の動作を変更するには、つまり、QTextEdit で貼り付けられる内容や貼り付け方法を変更するには、仮想関数canInsertFromMimeData() とinsertFromMimeData() を再実装してください。

cut() およびcopy()も参照のこと 。

void QTextEdit::print(QPagedPaintDevice *printer) const

テキスト編集のドキュメントを、与えられたprinter に印刷するための便利な関数です。この関数は印刷範囲としてQPrinter::Selectionもサポートしていることを除けば、ドキュメントに対して直接printメソッドを呼び出すのと同じです。

QTextDocument::print()も参照してください 。

[slot] void QTextEdit::redo()

最後の操作をやり直す。

やり直す操作がない場合、つまり元に戻す/やり直しの履歴にやり直しのステップがない場合は、何も起こりません。

undo()も参照してください 。

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

このシグナルは、REDOオペレーションが利用可能になる（available がtrue）か、利用不可能になる（available がfalse）たびに発行される。

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

再実装：QAbstractScrollArea::resizeEvent(QResizeEvent *event)。

[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 がゼロまたは負の場合、この関数の動作は定義されないことに注意。

fontPointSize()、setCurrentFont()、setFontFamily()も参照 。

[slot] void QTextEdit::setFontUnderline(bool underline)

underline それ以外の場合は、現在の書式を下線なしにする。

fontUnderline()も参照 。

[slot] void QTextEdit::setFontWeight(int weight)

現在の書式のフォントの太さを、与えられたweight に設定する。ここで使われる値は、QFont::Weight enum で定義された範囲内にある。

fontWeight()、setCurrentFont()、setFontFamily()も参照 。

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

テキスト編集のテキストを文字列text に変更します。以前のテキストはすべて削除されます。

注意事項

• 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 *event)。

QColor QTextEdit::textBackgroundColor() const

現在のフォーマットのテキストの背景色を返します。

setTextBackgroundColor()も参照 。

[signal] void QTextEdit::textChanged()

このシグナルは、ドキュメントの内容が変更されるたびに発行されます。例えば、テキストが挿入されたり、削除されたり、フォーマットが適用されたときなどです。

QColor QTextEdit::textColor() const

現在のフォーマットのテキスト色を返します。

setTextColor()も参照 。

QTextCursor QTextEdit::textCursor() const

現在表示されているカーソルを表すQTextCursor のコピーを返す。setTextCursor返されたカーソルの変更は、QTextEdit のカーソルには影響しないことに注意すること。

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