Qt QML Type

Qt の便利な列挙型や関数を備えたグローバルオブジェクトを提供します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

列挙型

• AlignmentFlag (since Qt Quick Ultralite 2.8)
• CheckState
• InputMethodHints
• Key
• LayoutDirection
• Orientation

プロパティ

• uiLanguage : string (since Qt Quick Ultralite 1.1)

方法

• font font(object fontConfiguration) (since Qt Quick Ultralite 1.9)
• matrix4x4 matrix4x4(real m11, real m12, real m13, real m14, real m21, real m22, real m23, real m24, real m31, real m32, real m33, real m34, real m41, real m42, real m43, real m44) (since Qt Quick Ultralite 1.7)
• point point(real x, real y) (since Qt Quick Ultralite 2.9)
• point rect(real x, real y, real width, real height) (since Qt Quick Ultralite 2.9)
• string resolvedUrl(String url) (since Qt Quick Ultralite 2.0)
• color rgba(real red, real green, real blue, real alpha)

詳細な説明

Qt オブジェクトは、ユーティリティ関数、プロパティ、および列挙型を持つグローバルオブジェクトです。

インスタンス化することはできません。これを使用するには、グローバルな `Qt ` オブジェクトのメンバを直接呼び出してください。例：

import QtQuick 2.15

Text {
    color: Qt.rgba(1, 0, 0, 1)
    text: "hello, world"
}

列挙型

この Qt XML オブジェクトには、Qt Namespace で利用可能な列挙型のいくつかが含まれています。例えば、Qt::Vertical の列挙値には、Qt.Vertical としてアクセスできます。

型

QtQuick モジュールがインポートされている場合、特定のデータ型のオブジェクトを作成するための以下のヘルパー関数もクライアントが利用できます：

• color - useQt.rgba()
• font - useQt.font()
• point - useQt.point()
• rect - useQt.rect()
• matrix4x4 - useQt.matrix4x4()

列挙型のドキュメント

[since Qt Quick Ultralite 2.8] AlignmentFlag

この列挙型は、配置を記述するために使用されます。これには、水平および垂直のフラグが含まれており、これらを組み合わせて必要な効果を生み出すことができます。

水平方向のフラグは以下の通りです：

垂直方向のフラグは次のとおりです：

水平方向のフラグは、一度に1つしか使用できません。2次元フラグは1つあります：

一度に使える水平フラグと垂直フラグはそれぞれ1つずつです。Qt::AlignCenterは水平および垂直の両方のフラグとして扱われます。

フラグの組み合わせに矛盾がある場合、その意味は未定義となります。

この列挙型は、Qt Quick Ultralite 2.8で導入されました。

CheckState

チェックボックスの取り得る状態

利用可能な状態：

InputMethodHints

入力メソッドへのヒントとなるオプションの一覧を提供します。

値はフラグのビット単位の組み合わせであり、ヒントが設定されていない場合は Qt.ImhNone となります。以下のフラグは、TextInput の動作を変更します：

入力を制限するフラグ（排他的フラグ）は以下の通りです：

マスク：

Key

Qt.

LayoutDirection

レイアウト方向のオプションの一覧を提供します。

Orientation

この列挙型を使用して、オブジェクトの向きを表します。

プロパティのドキュメント

uiLanguage : string [since Qt Quick Ultralite 1.1]

uiLanguage には、ユーザーインターフェースの文字列翻訳に使用する言語名が格納されます。

この値は自由に設定でき、バインディングで使用できます。慣例として、空の文字列は、ソースコードで使用されている言語からの翻訳を行わないことを意味します。

このプロパティは、Qt Quick Ultralite 1.1 で導入されました。

「 Qt Quick Ultralite による国際化とローカライズ」も参照してください 。

メソッドのドキュメント

[since Qt Quick Ultralite 1.9] font font(object fontConfiguration)

fontConfiguration オブジェクトで指定されたプロパティを持つfont を返します。fontConfiguration オブジェクトには、キーと値のペアが含まれている必要があります。ここで、有効なキーはfont のサブプロパティ名であり、値は各サブプロパティの有効な値です。

読み取り専用プロパティに対してQt.font() を呼び出すと、qmltocppツールが最適化されたC++コードを生成できるようになります。この最適化は現在、constant font configurations に対してのみ適用されます。次の例では、最適化されたコードによって、最初の3つのText項目に対する不要なバインディングが削除されています:

function someConditon() : bool { return false }

readonly property font fontConfig1: Qt.font({ pixelSize: 40, italic: true })
readonly property font fontConfig2: Qt.font({ pixelSize: 24 })

Column {
    Text {
        font: fontConfig1
        text: "dog"
    }

    Text {
        font: fontConfig1
        text: "cat"
    }

    Text {
        font: fontConfig2
        text: "mole"
    }

    Text {
        font: someConditon() ? fontConfig1 : fontConfig2
        text: "hedgehog"
    }
}

このメソッドは、Qt Quick Ultralite 1.9 で導入されました。

[since Qt Quick Ultralite 1.7] matrix4x4 matrix4x4(real m11, real m12, real m13, real m14, real m21, real m22, real m23, real m24, real m31, real m32, real m33, real m34, real m41, real m42, real m43, real m44)

指定された値を持つ4×4の行列を返します。

引数は、行列内の位置に対応しています。

このメソッドは、Qt Quick Ultralite 1.7で導入されました。

[since Qt Quick Ultralite 2.9] point point(real x, real y)

指定されたx およびy の座標を持つ点を返します。

このメソッドは、Qt Quick Ultralite 2.9 で導入されました。

[since Qt Quick Ultralite 2.9] point rect(real x, real y, real width, real height)

左上隅がx 、y に位置し、指定されたwidth およびheight を持つ矩形を返します。

このメソッドは、Qt Quick Ultralite 2.9 で導入されました。

[since Qt Quick Ultralite 2.0] string resolvedUrl(String url)

Qt6 QMLとの構文互換性を確保するための同一性関数です。渡された文字列url をそのまま返します。

このメソッドは、Qt Quick Ultralite 2.0 で導入されました。

color rgba(real red, real green, real blue, real alpha)

指定されたred 、green 、blue 、およびalpha の各成分を持つ色を返します。すべての成分は0～1（両端を含む）の範囲内である必要があります。

特定の Qt ライセンスの下で利用可能です。
詳細はこちら。