このページでは

QTextOption Class

QTextOption クラスは、一般的なリッチテキストのプロパティに関する説明を提供します。詳細...

ヘッダー: #include <QTextOption>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui

注:このクラスのすべての関数は再入可能です。

パブリック型

struct Tab
enum Flag { IncludeTrailingSpaces, ShowTabsAndSpaces, ShowLineAndParagraphSeparators, ShowDocumentTerminator, ShowDefaultIgnorables, …, DisableEmojiParsing }
flags Flags
enum TabType { LeftTab, RightTab, CenterTab, DelimiterTab }
enum WrapMode { NoWrap, WordWrap, ManualWrap, WrapAnywhere, WrapAtWordBoundaryOrAnywhere }

パブリック関数

QTextOption()
QTextOption(Qt::Alignment alignment)
QTextOption(const QTextOption &other)
~QTextOption()
Qt::Alignment alignment() const
QTextOption::Flags flags() const
void setAlignment(Qt::Alignment alignment)
void setFlags(QTextOption::Flags flags)
void setTabArray(const QList<qreal> &tabStops)
void setTabStopDistance(qreal tabStopDistance)
void setTabs(const QList<QTextOption::Tab> &tabStops)
void setTextDirection(Qt::LayoutDirection direction)
void setUseDesignMetrics(bool enable)
void setWrapMode(QTextOption::WrapMode mode)
QList<qreal> tabArray() const
qreal tabStopDistance() const
QList<QTextOption::Tab> tabs() const
Qt::LayoutDirection textDirection() const
bool useDesignMetrics() const
QTextOption::WrapMode wrapMode() const
QTextOption &operator=(const QTextOption &other)

詳細な説明

QTextOption は、一般的なリッチテキストのプロパティを単一のオブジェクトにカプセル化するために使用されます。これには、テキストの配置、レイアウト方向、ワードラップ、およびテキストのレンダリングやレイアウトに関連するその他の標準的なプロパティに関する情報が含まれています。

QTextEdit 、QTextDocument 、およびQTextCursorも参照してください 。

メンバ型のドキュメント

enum QTextOption::Flag
flags QTextOption::Flags

定数値説明
QTextOption::IncludeTrailingSpaces0x80000000このオプションが設定されている場合、QTextLine::naturalTextWidth() および naturalTextRect() は、テキスト内の末尾の空白の幅を含む値を返します。設定されていない場合は、この幅は除外されます。
QTextOption::ShowTabsAndSpaces0x1スペースは小さな点で、タブは小さな矢印で表示します。非改行スペースは、改行スペースとは異なる表示になります。
QTextOption::ShowLineAndParagraphSeparators0x2行区切りおよび段落区切りを、適切な記号文字で表示します。
QTextOption::ShowDocumentTerminator (since Qt 5.7)0x10文書の終わりをセクション記号で視覚化します。
QTextOption::ShowDefaultIgnorables (since Qt 6.9)0x20フォントがサポートしている場合、通常は表示されない文字も表示します。
QTextOption::AddSpaceForLineAndParagraphSeparators0x4改行位置を決定する際は、区切り文字の描画のために追加されるスペースを考慮に入れる。
QTextOption::SuppressColors0x8文字書式におけるすべての色変更を抑制します(メインの選択範囲を除く)。
QTextOption::DisableEmojiParsing (since Qt 6.9)0x40デフォルトでは、Qt は入力文字列内の絵文字シーケンスを検出し、それらを表示するためにカラーフォントの使用を優先します。この追加処理が不要であることがあらかじめわかっている場合は、DisableEmojiParsing フラグを設定することで無効にすることができます。

Flags 型は、QFlags<Flag> の typedef です。Flag 値の OR 組み合わせを格納します。

enum QTextOption::TabType

この列挙型は、さまざまな種類のタブ区切りを保持しています

定数値説明
QTextOption::LeftTab0左タブ
QTextOption::RightTab1右タブ
QTextOption::CenterTab2中央揃えのタブ
QTextOption::DelimiterTab3特定の区切り文字で停止するタブ

enum QTextOption::WrapMode

この列挙型は、ドキュメント内でのテキストの折り返し方法を定義します。

定数値説明
QTextOption::NoWrap0テキストはまったく折り返されません。
QTextOption::WordWrap1テキストは単語の区切りで折り返されます。
QTextOption::ManualWrap2QTextOption::NoWrap と同じ
QTextOption::WrapAnywhere3テキストは、単語の途中であっても、行上の任意の位置で改行される可能性があります。
QTextOption::WrapAtWordBoundaryOrAnywhere4可能であれば、単語の区切りで折り返しが行われます。そうでない場合は、たとえ単語の途中であっても、行上の適切な位置で折り返しが行われます。

メンバ関数のドキュメント

QTextOption::QTextOption()

テキストのデフォルトプロパティを持つテキストオプションを構築します。テキストの配置プロパティは `Qt::AlignLeft` に設定されます。行の折り返しプロパティは `QTextOption::WordWrap` に設定されます。デザインメトリクスの使用フラグは `false` に設定されます。

注: このコンストラクタを呼び出すと 、テキストのデフォルトの方向が「Qt::LayoutDirectionAuto 」に設定されます。

QTextOption::QTextOption(Qt::Alignment alignment)

指定されたalignment をテキストとして使用するテキストオプションを作成します。word wrapプロパティはQTextOption::WordWrap に設定されます。design metricsフラグの使用はfalseに設定されます。

注: このコンストラクタを呼び出すと 、テキストのデフォルトの方向が、システムのロケールに依存するQGuiApplication::layoutDirection()の現在の値に設定されます。下位互換性を確保するため、これはデフォルトのコンストラクタによって設定されるデフォルトのテキスト方向とは一致しません。

QTextOption::QTextOption(const QTextOption &other)

「other 」テキストオプションのコピーを作成します。

[noexcept] QTextOption::~QTextOption()

テキストオプションを削除します。

Qt::Alignment QTextOption::alignment() const

このオプションで定義されたテキストの配置を返します。

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

QTextOption::Flags QTextOption::flags() const

そのオプションに関連付けられたフラグを返します。

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

void QTextOption::setAlignment(Qt::Alignment alignment)

オプションのテキストの配置を、指定されたalignment に設定します。

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

void QTextOption::setFlags(QTextOption::Flags flags)

指定されたflags に対して、そのオプションに関連付けられたフラグを設定します。

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

void QTextOption::setTabArray(const QList<qreal> &tabStops)

テキストレイアウトのタブ位置を、tabStops で指定された値に設定します。

tabArray()、setTabStopDistance()、およびsetTabs()も参照してください 。

void QTextOption::setTabStopDistance(qreal tabStopDistance)

タブストップ間のデフォルトの距離(デバイス単位)を、tabStopDistance で指定された値に設定します。

tabStopDistance()、setTabArray()、setTabs()、およびtabs()も参照してください 。

void QTextOption::setTabs(const QList<QTextOption::Tab> &tabStops)

テキストレイアウトのタブ位置を、tabStops で指定された位置に設定します。

tabs() およびtabStopDistance()も参照してください 。

void QTextOption::setTextDirection(Qt::LayoutDirection direction)

このオプションで定義されたテキスト配置の方向を、指定されたdirection に設定します。

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

void QTextOption::setUseDesignMetrics(bool enable)

enable が true の場合、レイアウトではデザインメトリクスが使用されます。そうでない場合は、ペイントデバイスのメトリクスが使用されます(これがデフォルトの動作です)。

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

void QTextOption::setWrapMode(QTextOption::WrapMode mode)

オプションのテキスト折り返しモードを、指定されたmode に設定します。

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

QList<qreal> QTextOption::tabArray() const

テキストのレイアウトに対して定義されたタブ位置のリストを返します。

setTabArray() およびtabStopDistance()も参照してください 。

qreal QTextOption::tabStopDistance() const

タブストップ間の距離をデバイス単位で返します。

setTabStopDistance()、tabArray()、setTabs()、およびtabs()も参照してください 。

QList<QTextOption::Tab> QTextOption::tabs() const

テキストのレイアウトに対して定義されたタブ位置のリストを返します。

tabStopDistance()、setTabs()、およびsetTabStopDistance()も参照してください 。

Qt::LayoutDirection QTextOption::textDirection() const

このオプションで定義されたテキスト配置の方向を返します。

注: 下位互換性の理由により 、テキストの方向のデフォルト値は、使用するコンストラクタによって異なります。詳細については、各コンストラクタのドキュメントを参照してください。

関連項目: setTextDirection()。

bool QTextOption::useDesignMetrics() const

レイアウトがデバイスメトリックではなくデザインメトリックを使用している場合は `true ` を返し、そうでない場合は `false` を返します。

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

QTextOption::WrapMode QTextOption::wrapMode() const

このオプションで定義されたテキストの折り返しモードを返します。

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

QTextOption &QTextOption::operator=(const QTextOption &other)

textオプションがother のtextオプションと同一である場合はtrue を返し、そうでない場合はfalse を返します。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.