Text QML Type

シーンに書式付きテキストを追加する方法を指定します。詳細...

• 継承されたメンバーを含む全メンバーのリスト
• 非推奨メンバー

プロパティ

• advance : size
• antialiasing : bool
• baseUrl : url
• bottomPadding : real
• clip : bool
• color : color
• contentHeight : real
• contentWidth : real
• effectiveHorizontalAlignment : enumeration
• elide : enumeration
• font.bold : bool
• font.capitalization : enumeration
• font.contextFontMerging : bool (since 6.8)
• font.family : string
• font.features : object (since 6.6)
• font.hintingPreference : enumeration
• font.italic : bool
• font.kerning : bool
• font.letterSpacing : real
• font.pixelSize : int
• font.pointSize : real
• font.preferShaping : bool
• font.preferTypoLineMetrics : bool (since 6.8)
• font.strikeout : bool
• font.styleName : string
• font.underline : bool
• font.variableAxes : object (since 6.7)
• font.weight : int
• font.wordSpacing : real
• fontInfo.bold : bool
• fontInfo.family : string
• fontInfo.italic : bool
• fontInfo.pixelSize : int
• fontInfo.pointSize : real
• fontInfo.styleName : string
• fontInfo.weight : int
• fontSizeMode : enumeration
• horizontalAlignment : enumeration
• hoveredLink : string
• leftPadding : real
• lineCount : int
• lineHeight : real
• lineHeightMode : enumeration
• linkColor : color
• maximumLineCount : int
• minimumPixelSize : int
• minimumPointSize : int
• padding : real
• renderType : enumeration
• renderTypeQuality : int (since 6.0)
• rightPadding : real
• style : enumeration
• styleColor : color
• text : string
• textFormat : enumeration
• topPadding : real
• truncated : bool
• verticalAlignment : enumeration
• wrapMode : enumeration

信号

• lineLaidOut(object line)
• linkActivated(string link)
• linkHovered(string link)

方法

• void forceLayout()
• string linkAt(real x, real y)

詳細説明

テキストアイテムはプレーンテキストとリッチテキストの両方を表示できます。例えば、このように特定のフォントとサイズで赤色のテキストを定義することができます：

Text {
    text: "Hello World!"
    font.family: "Helvetica"
    font.pointSize: 24
    color: "red"
}

リッチテキストを定義するには、HTMLスタイルのマークアップまたはMarkdownを使用します：

Text {
    text: "<b>Hello</b> <i>World!</i>"
}

Text {
    text: "**Hello** *World!*"
}

高 さ と 幅が明示的に設定 さ れていない と き は、 テ キ ス ト は必要な余白を判断 し て、 それに応 じ て設定 し よ う と し ます。wrapMode が設定されない限り、常に height より width を優先します（すべてのテキストは1行に配置されます）。

一行のプレーンテキストを設定された幅に収めるには、elide プロパティを使います。

テキストは読み取りのみのテキストを提供します。編集可能なテキストについては、TextEdit を参照してください。

フォントの例も参照のこと 。

プロパティ・ドキュメンテーション

advance : size [read-only]

テキストアイテムの最初の文字のベースライン原点から、テキストフロー内でこの文字の直後に出現するテキストアイテムの最初の文字のベースライン原点までの距離（ピクセル単位）。

テキストが右から左に流れる場合、advance は負になる可能性があることに注意。

antialiasing : bool

Text がアンチエイリアシングを使用するかどうかを決定するために使用します。アンチエイリアスを無効にできるのは、 Text.NativeRendering のrenderType を持つ Text だけです。

デフォルトはtrue です。

baseUrl : url

このプロパティは、テキスト内の相対URLを解決するために使用されるベースURLを指定します。

URLは、ベースURLのターゲットと同じディレクトリ内にあるように解決されます。つまり、最後の'/'以降のパスの部分は無視されます。

デフォルト値は、テキスト項目をインスタンス化したQMLファイルのURLです。

これらのプロパティは、コンテンツの周りのパディングを保持します。このスペースは、contentWidth とcontentHeight に加えて確保されます。

clip : bool

このプロパティは、テキストが切り取られるかどうかを保持する。

テキストが外接矩形に収まらない場合は、突然切り取られることに注意してください。

限られたスペースに長いテキストを表示したい場合は、elide 。

color : color

テキストの色。

16進数表記で定義された緑色のテキストの例：

Text {
    color: "#00FF00"
    text: "green text"
}

SVG色名で定義されたスチールブルーテキストの例：

Text {
    color: "steelblue"
    text: "blue text"
}

contentHeight : real [read-only]

設定された高さに収まらないテキストがあるためにカバーされる高さを超えた高さを含む、テキストの高さを返します。

contentWidth : real [read-only]

WrapModeが設定されている場合、折り返しが不十分なために覆われている幅を超えた幅を含む、テキストの幅を返します。

テキストアイテムの幅と高さ内でのテキストの水平方向と垂直方向の配置を設定します。デフォルトでは、テキストは垂直方向に上揃えされます。横揃えはテキス ト の自然な配置に従います。 た と えば、 左か ら 右へ読むテ キ ス ト は左揃えにな り ます。

horizontalAlignment の有効な値はText.AlignLeft 、Text.AlignRight 、Text.AlignHCenter 、Text.AlignJustify です。verticalAlignment に有効な値はText.AlignTop 、Text.AlignBottom 、Text.AlignVCenter です。

テ キ ス ト 1 行の場合、 テ キ ス ト のサ イ ズがそのテ キ ス ト の領域 と な る こ と に留意 し て く だ さ い。こ の よ う な一般的な場合には、 すべての整列が等価です。テ キ ス ト を、 た と えばその親の中央に配置 し たい と き は、Item::anchors を変更す る か、horizontalAlignment を Text.AlignHCenter に設定 し て幅を親の幅にバ イ ン ド す る 必要があ り ます。

アプ リ ケーシ ョ ン レ イ ア ウ ト を ミ ラ ーす る ために添付プ ロ パテ ィLayoutMirroring::enabled を用い る と 、 テ キ ス ト の水平ア ラ イ メ ン ト も ミ ラ ー さ れます。し か し 、 プ ロ パテ ィhorizontalAlignment は変更 さ れません。テ キ ス ト の有効な水平ア ラ イ メ ン ト を取得す る には、 読み取 り 専用のプ ロ パテ ィeffectiveHorizontalAlignment を用い ます。

elide : enumeration

このプロパティを設定すると、テキストの一部がテキストアイテムの幅にフィットしてエライドされる。テキストは、明示的な幅が設定されている場合にのみエリイドされる。

このプロパティはリッチテキストでは使用できません。

エライディングは

このプロパティが Text.ElideRight に設定されている場合、wrapped テキストで使用できます。テキストは、maximumLineCount 、またはheight が設定されている場合にのみエライデされます。maximumLineCount とheight の両方が設定 さ れてい る と き は、 行が許 さ れ る 高 さ に収ま ら ない場合を除き、maximumLineCount が適用 さ れます。

テ キ ス ト が複数長の文字列で、 モー ド がText.ElideNone でない と き は、 最初に収ま る 文字列が用い ら れ、 そ う でない と き は最後の文字列がエ リ ド さ れます。

マルチレングス文字列は、Unicode の "String Terminator "キャラクタU009C （QMLでは"\u009C" または"\x9C" と記述します）で区切られ、長いものから短いものへと並びます。

font.bold : bool

フォントの太さを設定する。

font.capitalization : enumeration

テキストの大文字小文字を設定します。

Text { text: "Hello"; font.capitalization: Font.AllLowercase }

font.contextFontMerging : bool [since 6.8]

選択されているフォントが特定の文字を含んでいない場合、Qt は自動的にその文字を含む、見た目が似ているフォントを選択します。デフォルトでは、これは文字ごとに行われます。

つまり、ある珍しいケースでは、同じスクリプトであっても、1つの文字列を表現するために多くの異なるフォントが使用される可能性があります。contextFontMerging を true に設定すると、代わりに入力文字列の最大のサブセットにマッチするフォールバックフォントを見つけようとします。こ れは、 グ リ フ が欠落 し てい る 文字列に対 し ては よ り 高 く な り ますが、 よ り 一貫 し た結果が得 ら れ る 可能性があ り ます。デフォルトでは、contextFontMerging はfalse です。

このプロパティは Qt 6.8 で導入されました。

QFont::StyleStrategyも参照してください 。

font.family : string

フォントのファミリー名を設定します。

ファミリ名は大文字小文字を区別せず、オプションでファウンドリ名を含めることができます (例 "Helvetica [Cronyx]")。ファミリが複数のファウンドリから入手可能で、ファウンドリが指定されていない場合は、任意のファウンドリが選択されます。ファミリが利用できない場合は、フォントマッチングアルゴリズムを使ってファミリが設定されます。

font.features : object [since 6.6]

features 内の内容に基づいてテ キ ス ト をシ ェーピ ン グす る 際に、 特定の OpenType 機能に整数値を適用 し ます。こ れはフ ォ ン ト のシ ェーピ ン グ処理への高度なア ク セ ス を提供 し 、 それ以外の API では網羅 さ れていない フ ォ ン ト 機能に対応す る ために利用す る こ と がで き ます。

フ ォ ン ト 機能は、 4 文字 タ グか ら 整数値へのマ ッ プで表 さ れます。ほとんどの場合、タグと一緒に渡されるこの整数値はブーリアン値を表します：ゼロの値はその機能が無効であることを意味し、ゼロ以外の値は有効であることを意味します。しかし、ある種のフォント機能については、この値は別の解釈を持つことがあります。例えば、salt 機能に適用される場合、値は、使用する文体の代替を指定するインデックスです。

た と えば、frac フ ォ ン ト 機能は、 ス ラ ッ シ ュ で区切 ら れた対角線上の分数 （1/2 の よ う に） を別の表現で変換 し ます。通常 こ れは、 分数全体を 1 個の文字幅に焼 く こ と にな り ます （½ の よ う に）。

フ ォ ン ト がfrac 機能に対応 し てい る 場合は、 下記の コ ー ド の よ う にシ ェ イ パーの中で有効にす る こ と がで き ます：

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1 }
}

同 じ マ ッ ピ ン グ内で複数の機能を値に割 り 当て る こ と も で き ます。た と えば、 その フ ォ ン ト に対 し て カ ーニ ン グ も 無効に し たい と き は、 下記の よ う に し て明示的に無効化す る こ と がで き ます：

Text {
    text: "One divided by two is 1/2"
    font.family: "MyFractionFont"
    font.features: { "frac": 1, "kern": 0 }
}

フォントのプロパティをオブジェクトに集めることもできます：

Text {
    text: "One divided by two is 1/2"
    font: {
        family: "MyFractionFont"
        features: { "frac": 1, "kern": 0 }
    }
}

このプロパティはQt 6.6で導入されました。

QFont::setFeature()も参照してください 。

font.hintingPreference : enumeration

テキストの優先ヒンティングを設定する。これは、特定のレベルのヒンティングを使用するように、基礎となるテキストレンダリングシステムへのヒントであり、プラットフォームによってサポートが異なります。詳細はQFont::HintingPreference のドキュメントの表を参照してください。

Text { text: "Hello"; renderType: Text.NativeRendering; font.hintingPreference: Font.PreferVerticalHinting }

font.italic : bool

フォントにイタリック体があるかどうかを設定します。

font.kerning : bool

テキストを整形する際のカーニング OpenType 機能を有効または無効にします。これを無効にすると、テキストを作成または変更する際のパフォーマンスが向上する可能性がありますが、いくつかの外観上の特徴が犠牲になります。デフォルト値は true です。

Text { text: "OATS FLAVOUR WAY"; font.kerning: false }

font.letterSpacing : real

フォントの文字間隔を設定します。

文字間隔は、フォント内の個々の文字の間のデフォルトの間隔を変更します。正の値を指定すると、対応するピクセル分だけ文字間隔が広くなり、負の値を指定すると文字間隔が狭くなります。

font.pixelSize : int

フォントサイズをピクセル単位で設定する。

この関数を使用すると、フォントがデバイスに依存するようになります。デバイスに依存しない方法でフォントサイズを設定するには、pointSize を使用してください。

font.pointSize : real

フォントサイズをポイントで設定する。ポイントサイズは0より大きくなければならない。

font.preferShaping : bool

フォントが文字セットを正しく表示するために、複雑な規則を適用することがある。バラモン文字のようないくつかの文字体系では、これはテキストを読みやすくするために必要なことですが、例えばラテン文字では、単なる見栄えのための機能です。preferShaping プロパティをfalseに設定すると、このような機能が不要な場合はすべて無効になり、ほとんどの場合パフォーマンスが向上します。

デフォルト値はtrueです。

Text { text: "Some text"; font.preferShaping: false }

font.preferTypoLineMetrics : bool [since 6.8]

フォントのascent ・descent ・leading を提供する垂直線メ ト リ ッ ク のセ ッ ト を競合 さ せます。こ れ ら は し ば し ばwin（Windows） メ ト リ ッ ク とtypo（組版） メ ト リ ッ ク と 呼ばれます。仕様では、行間にはtypo メ ト リ ッ ク を用いる こ と を推奨 し てい ますが、 多 く のアプ リ ケーシ ョ ンは、 フ ォ ン ト のfsSelectionフ ィ ール ド でUSE_TYPO_METRICS フ ラ グが設定 さ れていない限 り 、win メ ト リ ッ ク を好みます。後方互換性の理由から、これは Qt アプ リ ケーシ ョ ンの場合も同様です。こ れは、typo メ ト リ ッ ク が有効であ る こ と を示すUSE_TYPO_METRICS フ ラ グ を設定 し てい る フ ォ ン ト や、win メ ト リ ッ ク とtypo メ ト リ ッ ク が一致 し てい る フ ォ ン ト に対 し ては問題ではあ り ません。し か し 、 あ る 種の フ ォ ン ト に対 し ては、win メ ト リ ッ ク が望ましい行間隔 よ り も 大 き く 、USE_TYPO_METRICS フ ラ グが誤っ て設定 さ れない こ と があ り ます。その よ う な フ ォ ン ト に対 し ては、font.preferTypoLineMetrics を設定す る こ と が優れた結果を も た ら す可能性があ り ます。

デフォルトでは、preferTypoLineMetrics はfalse になります。

このプロパティは Qt 6.8 で導入されました。

QFont::StyleStrategyも参照してください 。

font.strikeout : bool

フォントに取り消し線があるかどうかを設定します。

font.styleName : string

フォントのスタイル名を設定します。

ス タ イル名は大文字小文字を区別 し ません。設定する と 、 フ ォ ン ト は、 フ ォ ン ト プ ロパテ ィfont.weight ・font.bold ・font.italic のかわ り に、 ス タ イル名に対 し て照合 さ れます。

font.underline : bool

テキストに下線を引くかどうかを設定する。

font.variableAxes : object [since 6.7]

可変フ ォ ン ト 内の可変軸に浮動小数点値を適用。

可変フ ォ ン ト は、 同 じ フ ォ ン ト フ ァ イ ル内に複数のバ リ エーシ ョ ン （異な る太 さ ・ 幅 ・ ス タ イ ルを持つ） を格納す る 方法を提供 し ます。バ リ エーシ ョ ンは、 「バ リ エーシ ョ ン軸」 と い う あらかじめ定義 さ れたパ ラ メ タ セ ッ ト に対す る 浮動小数点値 と し て与え ら れます。Qt では、従来のサブファミリーと同様に、setStyleName() を使って選択することができます。

場合によっては、異なる軸に任意の値を与えることも有用です。例えば、あるフォントに Regular と Bold のサブファミリがある場合、その中間のウェイトが必要になるかもしれません。その場合、フォントの "wght "軸にカスタム値を与えることで、手動でこれを要求することができます。

Text {
    text: "Foobar"
    font.family: "MyVariableFont"
    font.variableAxes: { "wght": (Font.Normal + Font.Bold) / 2.0 }
}

wght "軸がフォントによってサポートされ、与えられた値がその定義された範囲内であれば、ウェイト550.0に対応するフォントが提供されます。

wght"（ウェイト）、"wdth"（幅）、"ital"（イタリック）、および "opsz"（オプティカルサイズ）のような、多くのフォントが提供するいくつかの標準軸があります。これらはそれぞれ、フォント自体に定義された個別の範囲を持っています。たとえば、"wght" は 100 から 900 (QFont::Thin からQFont::Black) までの範囲であるのに対し、"ital" は 0 から 1 (イタリック体でないものから完全なイタリック体まで) までの範囲である。

フ ォ ン ト はカ ス タ ムの軸を定義す る こ と も で き ます。 ただ し 制限は、 その名前がQFont::Tag （4 個の ラ テ ン 1 キ ャ ラ ク タ の並び） の要件を満たす必要があ る こ と だけです。

デフ ォル ト では、 可変軸は設定 さ れてい ません。

このプロパティは Qt 6.7 で導入されました。

QFont::setVariableAxis()も参照してください 。

font.weight : int

要求されるフォントの太さ。要求されるウェイトは 1 から 1000 までの整数か、定義済みの値のいずれかでなければなりません：

Text { text: "Hello"; font.weight: Font.DemiBold }

font.wordSpacing : real

フォントの単語間隔を設定する。

単語間隔は、個々の単語間のデフォルトの間隔を変更します。正の値を指定すると、対応するピクセル数だけ単語の間隔が広がり、負の値を指定すると、それに応じて単語の間隔が狭まります。

fontInfo.bold : bool [read-only]

カ レ ン ト フ ォ ン ト とfontSizeMode に対 し て解決 さ れた フ ォ ン ト 情報の太字状態。こ れは、 解決 さ れた フ ォ ン ト の太 さ が bold 以上の場合に真にな り ます。

fontInfo.family : string [read-only]

カ レ ン ト フ ォ ン ト に対 し て解決 さ れてい る フ ォ ン ト の フ ァ ミ リ 名 とfontSizeMode 。

fontInfo.italic : bool [read-only]

カ レ ン ト フ ォ ン ト に対 し て解決 さ れてい る フ ォ ン ト 情報のイ タ リ ッ ク状態、 およびfontSizeMode 。

fontInfo.pixelSize : int [read-only]

カ レ ン ト フ ォ ン ト とfontSizeMode に対 し て解決 さ れた フ ォ ン ト 情報の ピ ク セルサ イ ズ。

fontInfo.pointSize : real [read-only]

カ レ ン ト フ ォ ン ト に対 し て解決 さ れてい る フ ォ ン ト 情報の pointSize とfontSizeMode 。

fontInfo.styleName : string [read-only]

カ レ ン ト フ ォ ン ト に対 し て解決 さ れてい る フ ォ ン ト 情報の ス タ イル名、fontSizeMode 。

fontInfo.weight : int [read-only]

カ レ ン ト フ ォ ン ト とfontSizeMode に対 し て解決 さ れた フ ォ ン ト 情報の重 さ 。

fontSizeMode : enumeration

このプロパティは、表示されるテキストのフォントサイズがどのように決定されるかを指定する。指定可能な値は以下の通りです：

はめ込まれたテキストのフォントサイズは、minimumPointSize またはminimumPixelSize プロパティで指定された最小値と、font.pointSize またはfont.pixelSize プロパティで指定された最大値を持つ。

Text { text: "Hello"; fontSizeMode: Text.Fit; minimumPixelSize: 10; font.pixelSize: 72 }

テキストが最小フォントサイズでアイテム境界内に収まらない場合、elide プロパティに従ってテキストは消去される。

textFormat プロパティがText.RichText に設定されている場合、このプロパティは完全に無視されるため、まったく効果がありません。textFormat がText.StyledText に設定 さ れてい る 場合は、 テ キ ス ト 内に フ ォ ン ト サ イ ズ タ グがない限 り 、 こ のプ ロ パテ ィ は尊重 さ れます。フ ォ ン ト サ イ ズ タ グがあ っ て も 、 プ ロ パテ ィ はそれを尊重 し ます。こ れは、 fontSizeMode 設定に完全には従わない原因にな り え ます。

hoveredLink : string [read-only]

このプロパティは、ユーザがテキストに埋め込まれたリンクにカーソルを合わせたときのリンク文字列を含む。リンクはリッチテキストまたはHTML形式でなければならず、hoveredLink 文字列は特定のリンクへのアクセスを提供する。

linkHovered およびlinkAt()も参照してください 。

lineCount : int [read-only]

テキスト項目で表示されている行数を返します。

このプロパティはリッチテキストには対応していません。

maximumLineCountも参照してください 。

lineHeight : real

テキス ト の行の高 さ を設定 し ます。こ の値は、 ピ ク セル単位か、 またはlineHeightMode に従っ た乗数にな り ます。

デフ ォル ト 値は乗数 1.0 です。行の高 さ は正の値でなければな り ません。

lineHeightMode : enumeration

このプロパティは、線の高さの指定方法を決定します。指定可能な値は以下の通りです：

linkColor : color

テキスト内のリンクの色。

このプロパティは、StyledTexttextFormat では動作しますが、RichText では動作しません。RichTextのリンク色は、テキストにCSS styleタグを含めることで指定できます。

maximumLineCount : int

テキストアイテムが表示される行数を制限するには、このプロパティを設定します。elideがText.ElideRightに設定されている場合、テキストは適切にエリッドされます。デフォルトでは、これは可能な限り大きな整数の値です。

こ のプ ロ パテ ィ は リ ッ チ テ キ ス ト には対応 し てい ません。

lineCount およびelideも参照してください 。

minimumPixelSize : int

このプロパティは、fontSizeMode プロパティによってスケーリングされたテキストの最小フォントピクセルサイズを指定する。

fontSizeMode が Text.FixedSize の場合、またはfont.pixelSize が -1 の場合、このプロパティは無視されます。

minimumPointSize : int

このプロパティは、fontSizeMode プロパティによってスケーリングされたテキストの最小フォントポイントsize を指定する。

fontSizeMode が Text.FixedSize の場合、またはfont.pointSize が -1 の場合、このプロパティは無視されます。

renderType : enumeration

このコンポーネントのデフォルトのレンダリングタイプをオーバーライドします。

サポートされるレンダリングタイプは以下の通りです：

テキストがターゲットプラットフォーム上でネイティブに見えることを好み、テキストの変換などの高度な機能を必要としない場合は、Text.NativeRendering を選択します。NativeRendering レンダリング タイプと組み合わせてそのような機能を使用すると、結果が貧弱になり、時にはピクセル化されます。

Text.QtRendering とText.CurveRendering はどちらもハードウェアアクセラレーション技術です。QtRendering は 2 つのうちで高速ですが、より多くのメモリを使用し、サイズが大きいとレンダリングアーチファクトが発生します。CurveRendering は、QtRendering で良好な視覚結果が得られない場合や、グラフィックスメモリ消費量の削減が優先される場合の代替手段として考慮する必要があります。

デフォルトのレンダリングタイプはQQuickWindow::textRenderType() で決定される。

renderTypeQuality : int [since 6.0]

このコンポーネントのデフォルトのレンダリングタイプの品質をオーバーライドします。これは低レベルのカスタマイズで、ほとんどの場合は無視できます。現在のところ、renderType がText.QtRendering の場合にのみ効果があります。

Text.QtRenderingで使用されるラスタライズアルゴリズムは、大きなテキストサイズでは、シャープな角が必要以上に丸く見えるなどのアーティファクトを与える可能性があります。特定のテキストアイテムでこれが問題になる場合は、renderTypeQuality を大きくして、メモリ消費を犠牲にしてレンダリング品質を向上させます。

renderTypeQuality は 0 以上の整数か、以下の定義済みの値のいずれかを指定します。

このプロパティは Qt 6.0 で導入されました。

style : enumeration

追加のテキストスタイルを設定します。

サポートされているテキストスタイルは以下の通りです：

Row {
    Text { font.pointSize: 24; text: "Normal" }
    Text { font.pointSize: 24; text: "Raised"; style: Text.Raised; styleColor: "#AAAAAA" }
    Text { font.pointSize: 24; text: "Outline";style: Text.Outline; styleColor: "red" }
    Text { font.pointSize: 24; text: "Sunken"; style: Text.Sunken; styleColor: "#AAAAAA" }
}

styleColor : color

テキストスタイルで使用されるセカンダリカラーを定義します。

styleColor は、アウトライン化されたテキストのアウトラインカラーとして、また、盛り上がったテキストや沈んだテキストのシャドウカラーとして使用されます。スタイルが設定されていない場合は、全く使用されません。

Text { font.pointSize: 18; text: "hello"; style: Text.Raised; styleColor: "gray" }

styleも参照してください 。

text : string

表示するテキスト。テキストはプレーンテキストとリッチテキストの両方の文字列をサポートします。

アイテムは、テキストがスタイル付きテキストとして扱われるべきかどうかを自動的に判断しようとします。この判定はQt::mightBeRichText() を使って行われます。ただし、Markdownの検出は自動的には行われません。

textFormatも参照してください 。

textFormat : enumeration

text プロパティの表示方法。

サポートされているテキスト形式は以下の通りです：

テ キ ス ト 形式がText.AutoText の場合、 テ キ ス ト 項目はそのテ キ ス ト を ス タ イ ル付 き テ キ ス ト と し て扱 う か ど う か を自動的に決定 し ます。この判定はQt::mightBeRichText()を使って行われます。 ()は、テキストの最初の行にHTMLタグがあるかどうかを検出することはできますが、Markdownとプレーンテキストを区別することはできません。

Text.StyledText はHTML 3.2のスタイルで、いくつかの基本的なテキスト・スタイル・マークアップをサポートする最適化されたフォーマットです：

<b></b> - bold
<del></del> - strike out (removed content)
<s></s> - strike out (no longer accurate or no longer relevant content)
<strong></strong> - bold
<i></i> - italic
<br> - new line
<p> - paragraph
<u> - underlined text
<font color="color_name" size="1-7"></font>
<h1> to <h6> - headers
<a href=""> - anchor
<img src="" align="top,middle,bottom" width="" height=""> - inline images
<ol type="">, <ul type=""> and <li> - ordered and unordered lists
<pre></pre> - preformatted
All entities

Text.StyledText パーサーは厳密で、タグが正しくネストされていることを要求します。

Column {
    Text {
        font.pointSize: 24
        text: "<b>Hello</b> <i>World!</i>"
    }
    Text {
        font.pointSize: 24
        textFormat: Text.RichText
        text: "<b>Hello</b> <i>World!</i>"
    }
    Text {
        font.pointSize: 24
        textFormat: Text.PlainText
        text: "<b>Hello</b> <i>World!</i>"
    }
    Text {
        font.pointSize: 24
        textFormat: Text.MarkdownText
        text: "**Hello** *World!*"
    }
}

Text.RichText サポートされるHTMLサブセットのページで説明されているように、HTML 4のより大きなサブセットをサポートしています。代わりにText.PlainText 、Text.StyledText 、Text.MarkdownText を使うことをお勧めします。

• コード・ブロックはdefault monospace font を使いますが、周囲のハイライト・ボックスはありません。
• ブロック引用符はインデントされますが、引用符の横に縦線はありません。

truncated : bool [read-only]

テ キ ス ト がmaximumLineCount またはelide に よ っ て切 り 捨て ら れてい る と き は true を返 し ます。

こ のプ ロ パテ ィ は リ ッ チ テ キ ス ト には対応 し てい ません。

maximumLineCount およびelideも参照 。

wrapMode : enumeration

テキストアイテムの幅に合わせてテキストを折り返すには、このプロパティを設定する。テキストは、明示的な幅が設定されている場合にのみ折り返されます：

シグナル・ドキュメント

lineLaidOut(object line)

このシグナルは、プレーンテキストまたはスタイル付きテキストモードでのレイアウト処理中に、テキストの各行がレイアウトされるたびに発行されます。リッチテキストモードでは発行されません。指定されたline オブジェクトは、現在レイアウトされている行の詳細を提供します。

これにより、レイアウト中の行の位置やサイズを変更することができます。例えば、列を作ったり、オブジェクトの周りにテキストをレイアウトしたりするのに使うことができます。

指定されたline オブジェクトのプロパティは以下の通りです：

例えば、これはText項目の最初の5行を右に100ピクセル移動します：

onLineLaidOut: (line)=> {
    if (line.number < 5) {
        line.x = line.x + 100
        line.width = line.width - 100
    }
}

次の例では、アイテムを最終行の末尾に配置することができます：

onLineLaidOut: (line)=> {
    if (line.isLast) {
        lastLineMarker.x = line.x + line.implicitWidth
        lastLineMarker.y = line.y + (line.height - lastLineMarker.height) / 2
    }
}

linkActivated(string link)

このシグナルは、ユーザーがテキストに埋め込まれたリンクをクリックしたときに発せられる。リンクはリッチテキストまたはHTML形式でなければならず、link の文字列が特定のリンクへのアクセスを提供します。

    Text {
            textFormat: Text.RichText
            text: "See the <a href=\"http://qt-project.org\">Qt Project website</a>."
            onLinkActivated: (link)=> console.log(link + " link activated")
    }

サンプルコードでは、"See theQt Project website"というテキストが表示されます。

ハイライトされたリンクをクリックすると、http://qt-project.org link activated がコンソールに出力されます。

linkHovered(string link)

このシグナルは、ユーザーがテキストに埋め込まれたリンクにカーソルを合わせたときに発せられる。リンクはリッチテキストまたはHTML形式でなければならず、link の文字列が特定のリンクへのアクセスを提供する。

hoveredLink およびlinkAt()も参照 。

メソッド・ドキュメント

void forceLayout()

表示されているテキストの再レイアウトをトリガーする。

string linkAt(real x, real y)

コンテ ン ト 座標で点x,y にあ る リ ン ク 文字列、 ま たはその点に リ ン ク が存在 し ない と き は空文字列を返す。

hoveredLinkも参照 。