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, AddSpaceForLineAndParagraphSeparators, SuppressColors }
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 は、一般的なリッチテキストのプロパティを単一のオブジェクトにカプセル化するために使用されます。これは、テキストの配置、レイアウト方向、単語の折り返し、およびテキストのレンダリングとレイアウトに関連するその他の標準プロパティに関する情報を含んでいます。

QTextEditQTextDocumentQTextCursorも参照

メンバ型ドキュメント

enum QTextOption::Flag
flags QTextOption::Flags

定数説明
QTextOption::IncludeTrailingSpaces0x80000000このオプションが設定されている場合、QTextLine::naturalTextWidth() と naturalTextRect() は、テキストの末尾のスペースの幅を含む値を返します。
QTextOption::ShowTabsAndSpaces0x1空白は小さな点で、 タ ブは小さな矢印で視覚化 し ます。区切りのないスペースは、区切りのあるスペースとは異なる方法で表示されます。
QTextOption::ShowLineAndParagraphSeparators0x2行や段落の区切りを適切な記号文字で視覚化する。
QTextOption::ShowDocumentTerminator (since Qt 5.7)0x10文書の終わりをセクション記号で視覚化する。
QTextOption::AddSpaceForLineAndParagraphSeparators0x4改行位置を決定する際には、区切り文字を描画するために追加されるスペースを考慮する。
QTextOption::SuppressColors0x8文字書式(主選択を除く)の色変化をすべて抑制する。

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

テキス ト のデフ ォル ト プ ロパテ ィ を持つ text オプシ ョ ン を構築。テ キ ス ト 整列プ ロパテ ィ はQt::AlignLeft に設定 さ れます。 単語折 り 返 し プ ロパテ ィ はQTextOption::WordWrap に設定 さ れます。

QTextOption::QTextOption(Qt::Alignment alignment)

text オプシ ョ ン を、 テ キ ス ト に対 し て与え ら れたalignment を用いて構築 し ます。word wrap プ ロパテ ィ はQTextOption::WordWrap に設定 さ れます。 design metrics の使用フラグは false に設定されます。

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)

テキス ト オプシ ョ ンがother テキス ト オプシ ョ ンと同じならtrue を返し、 そうでないならfalse を返す。

© 2025 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.