QTextOption Class
QTextOption クラスは、一般的なリッチテキストのプロパティの説明を提供します。詳細...
Header: | #include <QTextOption> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
- 継承メンバを含む全メンバ一覧
- QTextOptionは、リッチテキスト処理APIの一部です。
注意:このクラスの関数はすべてリエントラントです。
パブリック型
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 は、一般的なリッチテキストのプロパティを単一のオブジェクトにカプセル化するために使用されます。これは、テキストの配置、レイアウト方向、単語の折り返し、およびテキストのレンダリングとレイアウトに関連するその他の標準プロパティに関する情報を含んでいます。
QTextEdit 、QTextDocument 、QTextCursorも参照 。
メンバ型ドキュメント
enum QTextOption::Flag
flags QTextOption::Flags
定数 | 値 | 説明 |
---|---|---|
QTextOption::IncludeTrailingSpaces | 0x80000000 | このオプションが設定されている場合、QTextLine::naturalTextWidth() と naturalTextRect() は、テキストの末尾のスペースの幅を含む値を返します。 |
QTextOption::ShowTabsAndSpaces | 0x1 | 空白は小さな点で、 タ ブは小さな矢印で視覚化 し ます。区切りのないスペースは、区切りのあるスペースとは異なる方法で表示されます。 |
QTextOption::ShowLineAndParagraphSeparators | 0x2 | 行や段落の区切りを適切な記号文字で視覚化する。 |
QTextOption::ShowDocumentTerminator (since Qt 5.7) | 0x10 | 文書の終わりをセクション記号で視覚化する。 |
QTextOption::AddSpaceForLineAndParagraphSeparators | 0x4 | 改行位置を決定する際には、区切り文字を描画するために追加されるスペースを考慮する。 |
QTextOption::SuppressColors | 0x8 | 文字書式(主選択を除く)の色変化をすべて抑制する。 |
Flags型はQFlags<Flag>のtypedefである。Flag値のORの組み合わせを格納します。
enum QTextOption::TabType
この列挙型はタブレータの異なるタイプを保持します。
定数 | 値 | 説明 |
---|---|---|
QTextOption::LeftTab | 0 | 左タブ |
QTextOption::RightTab | 1 | 右タブ |
QTextOption::CenterTab | 2 | 中央タブ |
QTextOption::DelimiterTab | 3 | 特定の区切り文字で止まるタブ |
enum QTextOption::WrapMode
この列挙型は、文書内でテキストがどのように折り返されるかを記述します。
定数 | 値 | 説明 |
---|---|---|
QTextOption::NoWrap | 0 | テキストは全く折り返されない。 |
QTextOption::WordWrap | 1 | テキストは単語境界で折り返されます。 |
QTextOption::ManualWrap | 2 | QTextOption::NoWrap と同じ。 |
QTextOption::WrapAnywhere | 3 | テキストは行のどの位置でも折り返すことができます。 |
QTextOption::WrapAtWordBoundaryOrAnywhere | 4 | 可能であれば、折り返しは単語の境界で行われ、そうでなければ、単語の途中であっても、行の適切な位置で行われます。 |
メンバ関数説明
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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。