Text QML Type

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

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 を用い ます。

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

テキス ト項目の最初のキ ャ ラ ク タ のベース ラ イ ン原点か ら、 テ キ ス ト フ ロ ー内で こ のキ ャ ラ ク タ の直後に出現す る テ キ ス ト 項目の最初のキ ャ ラ ク タ のベース ラ イ ン原点ま での距離を ピ ク セル単位で表 し た も の。

テ キ ス ト が右か ら 左へ流 れ る と き は、 advance は負にな る こ と があ る こ と に注意。

テキス ト がア ン タ イ ア リ ゼーシ ョ ン を用いるかど う かを決定す る ために用い ら れます。アンチエイリアスを無効にできるのは、 Text.NativeRendering のrenderType を持つ Text だけです。

デフォルトはtrue です。

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

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

デフォルト値は、Text アイテムをインスタンス化した QML ファイルの url です。

このプロパティは、テキストがクリッピングされるかどうかを保持する。

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

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

テキス ト 色。

緑色のテ キ ス ト を 16 進表記で定義 し た例：

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

SVGカラーネームを使って定義されたスチールブルーテキストの例：

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

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

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

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

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

エライディングは

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

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

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

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

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

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

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

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

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

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

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

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

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()も参照してください 。

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

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

フ ォ ン ト が斜体ス タ イルを持つかど う かを設定 し ます。

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

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

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

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

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

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

フォントサイズをポイントで設定します。ポ イ ン ト サ イ ズは 0 よ り 大 き く す る 必要があ り ます。

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

デフォルト値はtrueです。

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

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.weight ・font.bold ・font.italic のかわ り に、 ス タ イル名 と 照合 さ れます。

テキス ト に下線を付けるかど う かを設定 し ます。

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

可変フ ォ ン ト は、 同 じ フ ォ ン ト フ ァ イ ル内に複数のバ リ エーシ ョ ン （異な る太 さ ・ 幅 ・ ス タ イ ルを持つ） を格納す る 方法を提供 し ます。バ リ エーシ ョ ンは、 「バ リ エーシ ョ ン軸」 と い う あらかじめ定義 さ れたパ ラ メ タ セ ッ ト に対す る 浮動小数点値 と し て与え ら れます。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()も参照してください 。

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

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

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

単語間隔は、個々の単語間のデフォルトの間隔を変更します。正の値を設定する と 、 単語の間隔が対応す る ピ ク セル分だけ拡が り 、 負の値を設定する と 、 単語の間隔が対応す る ピ ク セル分だけ狭 く な り ます。

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

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

カ レ ン ト フ ォ ン ト とfontSizeMode について解決 さ れた フ ォ ン ト 情報のイ タ リ ッ ク状態。

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

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

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

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

こ のプ ロパテ ィ は、 表示 さ れ る テ キ ス ト の文字サ イ ズ を決定す る 方法を指定 し ます。とりうる値は以下のとおりです：

はめ込まれたテキストのフォントサイズは、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設定に完全には従わない原因となり得ます。

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

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

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

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

maximumLineCountも参照して ください。

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

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

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

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

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

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

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

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

このプロパティは、fontSizeMode プロパティによって拡大縮小されたテキストの最小フォントピクセルサイズを指定します。

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

このプロパティは、fontSizeMode プロパティによって拡大縮小されたテキストの最小フォントポイントsize を指定します。

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

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

サポートされるレンダリングタイプは次のとおりです：

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

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

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

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

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

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

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

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

サポートされているテキスト・スタイルは次のとおりです：

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 は、アウトライン化されたテキストの輪郭色として使用され、隆起または沈んだテキストの影色として使用されます。スタイルが設定されていない場合は、全く使用されません。

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

styleも参照してください 。

表示す る テ キ ス ト 。テキス ト は、 プ レーン テキス ト 文字列 と リ ッ チ テキス ト 文字列の両方に対応 し てい ます。

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

textFormatも参照してください 。

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 を使いますが、周囲のハイライト・ボックスはありません。
• ブロック引用符は字下げされますが、引用符の横に縦線はありません。

maximumLineCount またはelide によってテキストが切り詰められた場合、true を返します。

こ のプ ロ パテ ィ は リ ッ チ テキス ト ではサポー ト さ れていません。

maximumLineCount およびelideも参照 。

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

このシグナルは、プレーンテキストまたはスタイル付きテキストモードでのレイアウト処理中に、テキストの各行がレイアウトされるたびに発せられます。リッチテキストモードでは発せられない。指定された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
    }
}

このシグナルは、ユーザーがテキストに埋め込まれたリンクをクリックしたときに発せられます。リンクはリッチテキストまたは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 がコンソールに出力されます。

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

hoveredLink およびlinkAt()も参照 。

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

コンテンツ座標における点x,y におけるリンク文字列、またはその点にリンクが存在しない場合は空文字列を返す。

hoveredLinkも参照 。