QTextOption Class

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

Header: #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()

テキストのデフォルトプロパティを持つテキストオプションを構築します。テキス ト整列プロパティをQt::AlignLeft に設定。 単語折り返しプロパティをQTextOption::WordWrap に設定。 設計 メ ト リ ッ ク使用フラグを false に設定。

QTextOption::QTextOption(Qt::Alignment alignment)

テキス ト について、 与えたalignment を用いてテキス ト オプシ ョ ン を構築。単語回 り 込みプ ロパテ ィ はQTextOption::WordWrap に設定 さ れます。 デザ イ ン メ ト リ ッ ク の使用フ ラ グは 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)

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

このドキュメントに含まれるコントリビューションの著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。