QTextEdit Class

メンバ関数 ドキュメント

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

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

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

再リンプルメント: (QDragLeaveEvent *event)：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 にマッチする次の出現回数を検索します。

マッチが見つかり、カーソルがマッチを選択するように変更された場合はtrue を返し、そうでない場合はfalse を返します。

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

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

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

Reimplements: (QFocusEvent *event)：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)

再実装: (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)

Reimplements: (QMouseEvent *e)：QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)。

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

再リプルメント: (QMouseEvent *e)：QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

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

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

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

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

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 が true) か、利用不可能になる (available が false) ときに発せられます。

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