Qt QML Type

application オブジェクトは、多くの QML コンポーネントが共有するグローバルなアプリケーション状態のプロパティへのアクセスを提供します。

これはApplication シングルトンと同じです。

以下の例では、application オブジェクトを使って、アプリケーションが現在アクティブかどうかを示しています：

import QtQuick

Rectangle {
    width: 300; height: 55
    color: Qt.application.active ? "white" : "lightgray"
    Text {
        text: "Application " + (Qt.application.active ? "active" : "inactive")
        opacity: Qt.application.active ? 1.0 : 0.5
        anchors.centerIn: parent
    }
}

• application.active
• application.active
• application.layoutDirection
• application.font

InputMethod シングルトンと同じです。

inputMethod オブジェクトは、アプリケーションのQInputMethod オブジェクトとそのすべてのプロパティとスロットにアクセスできます。詳細はQInputMethod のドキュメントを参照してください。

platform オブジェクトは、基盤となるプラットフォームに関する情報を提供します。

そのプロパティは次のとおりです：

styleHints オブジェクトは、プラットフォーム固有のスタイルヒントと設定を提供します。詳細はQStyleHints のドキュメントを参照してください。

Qt Quick Compiler などのツールでは、こちらの方がより良い型情報を提供するため、代わりにApplication::styleHints から StyleHints にアクセスする必要があります。

uiLanguage は、ユーザーインターフェイスの文字列翻訳に使用する言語名を保持します。C++ではQQmlEngine::uiLanguageプロパティとして公開されています。

自由に値を設定し、バインディングで使用することができます。アプリケーションにトランスレータをインストールした後で設定することをお勧めします。慣習上、空文字列はソースコードで使用されている言語からの翻訳が意図されていないことを意味します。

QQmlApplicationEngine を使用していて値が変更された場合は、QQmlEngine::retranslate() が呼び出されます。

関数やシグナルへの冗長な呼び出しを排除するには、この関数を使用します。

Qt.callLater() の第一引数として渡された関数は、QML エンジンがイベントループに戻ると、 後で呼び出されます。

この関数が同じ関数を第一引数として複数回連続して呼び出された場合、その関数は一度だけ呼び出されます。

例えば

import QtQuick

Rectangle {
    width: 480
    height: 320

    property int callsToUpdateMinimumWidth: 0
    property bool optimize: true

    property int currentTextModel: 0
    property var columnTexts: [
        ["Click on either", "rectangle above", "and note how the counter", "below updates", "significantly faster using the", "regular (non-optimized)", "implementation"],
        ["The width", "of this column", "is", "no wider than the", "widest item"],
        ["Note how using Qt.callLater()", "the minimum width is", "calculated a bare-minimum", "number", "of times"]
    ]

    Text {
        x: 20; y: 280
        text: "Times minimum width has been calculated: " + callsToUpdateMinimumWidth
    }

    Row {
        y: 25; spacing: 30; anchors.horizontalCenter: parent.horizontalCenter
        Rectangle {
            width: 200; height:  50; color: "lightgreen"
            Text { text: "Optimized behavior\nusing Qt.callLater()"; anchors.centerIn: parent }
            MouseArea { anchors.fill: parent; onClicked: { optimize = true; currentTextModel++ } }
        }
        Rectangle {
            width: 200; height:  50; color: "lightblue"
            Text { text: "Regular behavior"; anchors.centerIn: parent}
            MouseArea { anchors.fill: parent; onClicked: { optimize = false; currentTextModel++ } }
        }
    }

    Column {
        id: column
        anchors.centerIn: parent

        onChildrenChanged: optimize ? Qt.callLater(updateMinimumWidth) : updateMinimumWidth()

        property int widestChild
        function updateMinimumWidth() {
            callsToUpdateMinimumWidth++
            var w = 0;
            for (var i in children) {
                var child = children[i];
                if (child.implicitWidth > w) {
                    w = child.implicitWidth;
                }
            }

            widestChild = w;
        }

        Repeater {
            id: repeater
            model: columnTexts[currentTextModel%3]
            delegate: Text {
                color: "white"
                text: modelData
                width: column.widestChild
                horizontalAlignment: Text.Center
                Rectangle { anchors.fill: parent; z: -1; color: index%2 ? "gray" : "darkgray" }
            }
        }
    }
}

Qt.callLater() に渡された追加の引数は、呼び出された関数に渡されます。冗長な呼び出しが排除された場合、引数の最後のセットだけが関数に渡されることに注意してください。

sourceText 与えられたcontext の動的変換のためにsourceText をマークします。

同じsourceText が同じ翻訳コンテキスト内で異なる役割で使用される場合、disambiguation に識別文字列を追加で渡すことができる。

sourceText を返します。

QT_TRANSLATE_NOOP は、動的翻訳関数qsTr() およびqsTranslate() と組み合わせて使用します。QT_TRANSLATE_NOOP は、翻訳が必要な文字列であることを識別します（したがって、lupdate で識別できます）が、実際の翻訳は動的関数に委ねられます。

例

Item {
    property string greeting: QT_TRANSLATE_NOOP("CustomContext", "hello")

    Text { text: qsTranslate("CustomContext", greeting) }
}

Qt による国際化」も参照してください 。

動的翻訳のためにid をマークします。

id を返します。

QT_TRID_NOOP は、動的翻訳関数qsTrId() と組み合わせて使用します。QT_TRID_NOOP は、文字列を翻訳が必要なものとして識別しますが (lupdate で識別できるようにします)、実際の翻訳はqsTrId() に任せます。

例

Item {
    property string greetingId: QT_TRID_NOOP("hello_id")

    Text { text: qsTrId(greetingId) }
}

qsTrId() およびInternationalization with Qtも参照してください 。

sourceText つまり、保存されているsourceText は変更されません。

つまり、保存されているsourceText は変更されません。 同じ が同じ翻訳コンテキスト内で異なる役割で使用される場合、disambiguation に識別文字列を追加で渡すことができます。

sourceText を返します。

QT_TR_NOOP は、動的翻訳関数qsTr() およびqsTranslate() と組み合わせて使用します。QT_TR_NOOP は、文字列を翻訳が必要なものとして識別します（したがって、lupdate で識別できます）が、実際の翻訳は動的関数に委ねられます。

例

Item {
    property string greeting: QT_TR_NOOP("hello")

    Text { text: qsTr(greeting) }
}

Qt による国際化」も参照してください 。

value のアルファ値でbaseColor を返します。

value は 0（完全に透明）から 1（完全に不透明）までの実数です。

ASCII からバイナリへ - この関数は、base64 エンコードされたdata 文字列をデコードして返します。

プロパテ ィ バ イ ンデ ィ ン グ を表す JavaScript オブジ ェ ク ト を、 バ イ ンデ ィ ン グ を評価す るfunction と と も に返 し ます。

こ の関数の主な使用例は 2 つあ り ます ： 1 つ目は、 JavaScript コ ー ド か ら 強制的にプ ロ パテ ィ バ イ ンデ ィ ン グ を適用す る こ と です：

Item {
    property bool someCondition: true
    property int edgePosition

    Component.onCompleted: {
        if (someCondition == true) {
            // bind to the result of the binding expression passed to Qt.binding()
            edgePosition = Qt.binding(function() { return x + width })
        }
    }
}

もうひとつは、動的に構築されたオブジェクトのプロパティ値を初期化するときにプロパティ・バインディングを適用する場合です（Component.createObject （）またはLoader.setSource （）を使用します）。

例えば、DynamicTextコンポーネントが存在すると仮定します：

import QtQuick

Text {
    id: textElement
    width: 200
    height: 200
    text: "Default text"
    property string dynamicText: "Dynamic text"
    onTextChanged: console.log(text)
}

から出力されます：

Item {
    id: root
    property string dynamicText: "Root text"

    Component.onCompleted: {
        var c = Qt.createComponent("DynamicText.qml")

        var obj1 = c.createObject(root, { 'text': Qt.binding(function() { return dynamicText + ' extra text' }) })
        root.dynamicText = "Modified root text"

        var obj2 = c.createObject(root, { 'text': Qt.binding(function() { return this.dynamicText + ' extra text' }) })
        obj2.dynamicText = "Modified dynamic text"
    }
}

と from：

Item {
    id: root
    property string dynamicText: "Root text"

    Loader {
        id: loaderOne
        onLoaded: root.dynamicText = "Modified root text"
    }

    Loader {
        id: loaderTwo
        onLoaded: item.dynamicText = "Modified dynamic text"
    }

    Component.onCompleted: {
        loaderOne.setSource("DynamicText.qml", { 'text': Qt.binding(function() { return dynamicText + ' extra text' }) })
        loaderTwo.setSource("DynamicText.qml", { 'text': Qt.binding(function() { return this.dynamicText + ' extra text' }) })
    }
}

の両方が出力されます：

Root text extra text
Modified root text extra text
Dynamic text extra text
Modified dynamic text extra text

この関数は、結果が var プロパティにバインドされた配列に格納される場合を除き、プロパティ・バインディング宣言（バインディング宣言およびバインディング割り当てに関するドキュメントを参照）では使用できません。

Item {
    width: 50
    property var storedBindings: [ Qt.binding(function() { return x + width }) ] // stored
    property int a: Qt.binding(function() { return x + width }) // error!
    property int b

    Component.onCompleted: {
        b = storedBindings[0] // causes binding assignment
    }
}

Binary to ASCII - こ の関数は、data の base64 エン コ ーデ ィ ン グ を返 し ます。

与えられたname に対応する色（すなわち、赤または #ff0000）を返します。そのような色がない場合はnull が返されます。

lhs とrhs の両方が等しい色値を返す場合はtrue を返します。両方の引数には、色値か文字列値を指定することができます。文字列値を与え る と き は、color の値型について述べた よ う に、 色へ変換で き る も のでなければな り ません。

指定されたurl にある QML ファイルを使用して作成されたComponent オブジェクト、または空文字列が指定された場合はnull を返します。

返されたコンポーネントのComponent::status プロパティは、コンポーネントが正常に作成されたかどうかを示します。ステータスがComponent.Error の場合、エラーの説明はComponent::errorString() を参照。

オプションのパラメータmode がComponent.Asynchronous に設定されている場合、コンポーネントはバックグラウンド・スレッドでロードされます。ロード中は、Component::status プロパティはComponent.Loading になります。コンポーネントのロードに成功した場合はステータスがComponent.Ready に変わり、ロードに失敗した場合はComponent.Error に変わります。このパラメータを省略した場合のデフォルトはComponent.PreferSynchronous である。

mode がComponent.PreferSynchronous に設定されている場合、Qt はコンポーネントを同期的にロードしようと試みますが、必要に応じて非同期的にロードしてしまうことがあります。非同期ロードを引き起こす可能性のあるシナリオには、以下のようなものがありますが、これらに限定されません：

• URLがネットワークリソースを参照している。
• 非同期にロードされる別のコンポーネントの結果としてコンポーネントが作成される。

オプションのparent パラメータが指定された場合、作成されたComponent オブジェクトの親となるオブジェクトを参照する必要があります。モードが渡されなかった場合、これは第2引数になります。

返されたコンポーネントに対してComponent.createObject() を呼び出すと、そのコンポーネントのオブジェクト・インスタンスが生成される。

例えば

import QtQuick

Item {
    id: container
    width: 300; height: 300

    function loadButton() {
        var component = Qt.createComponent("Button.qml");
        if (component.status == Component.Ready) {
            var button = component.createObject(container);
            button.color = "red";
        }
    }

    Component.onCompleted: loadButton()
}

この関数の使い方については、JavaScriptからの動的なQMLオブジェクト生成を参照してください。

ファイルではなく）任意の QML 文字列から QML オブジェクトを生成するには、Qt.createQmlObject() を使用します。

これはオーバーロードされた関数です。

moduleUri とtypeName で指定された型のComponent オブジェクトを返します。

import QtQml
QtObject {
    id: root
    property Component myComponent: Qt.createComponent("QtQuick", "Rectangle", Component.Asynchronous, root)
}

このオーバーロード関数はurl をベースとしたバージョンと同じように動作しますが、 URLを持たない型(例えばQML_ELEMENT で登録されたC++型)のインスタンス化にも使用できます。

• 型がC++で実装されている。
• 型がインライン・コンポーネントである。

オプションのparent パラメータが指定された場合、作成されるComponent オブジェクトの親となるオブジェクトを参照する必要があります。モードが渡されなかった場合、これは第2引数になります。

このメソッドは Qt 6.5 で導入されました。

与えられたqml 文字列から作成された新しいオブジェクトを返します。このオブジェクトは指定されたparent を持ちますが、オブジェクトの作成にエラーがあった場合はnull を持ちます。

filepath が指定された場合、作成されたオブジェクトのエラー報告に使用されます。

例（parentItem は既存の QML アイテムの ID）：

const newObject = Qt.createQmlObject(`
    import QtQuick

    Rectangle {
        color: "red"
        width: 20
        height: 20
    }
    `,
    parentItem,
    "myDynamicSnippet"
);

エラーの場合、QQmlError オブジェクトが投げられます。このオブジェクトにはさらにqmlErrors というプロパティがあり、これは発生したエラーの配列です。この配列の各オブジェクトはlineNumber 、columnNumber 、fileName 、message というメンバーを持っています。例えば、上記のスニペットでcolorのスペルを「colro」と間違えていた場合、配列には以下のようなオブジェクトが含まれる：{ "lineNumber" : 1, "columnNumber" : 32, "fileName" : "dynamicSnippet1", "message" : "Cannot assign to non-existent property "colro""}。

この関数の使い方については、JavaScriptからの動的なQMLオブジェクト作成を参照してください。

baseColor よりも暗い色を、指定したfactor の値だけ返します。

factor が 1.0 より大きい場合、この関数はより暗い色を返します。factorを3.0に設定すると、明るさが3分の1の色が返されます。factor が 1.0 より小さい場合、返される色は明るくなりますが、この目的には Qt.lighter() 関数を使用することをお勧めします。係数が 0 または負の場合、戻り値は指定されません。

この関数は、現在の RGB カラーを HSV に変換し、値（V）成分を factor で割って RGB に戻します。

factor が与えられない場合、baseColor （係数 2.0）より 50% 暗い色を返します。

この関数はQQmlEngine::exit(int) シグナルを発します。qmlツール内では、指定されたリターン・コード(retCode)でランチャー・アプリケーションを終了させます。このメソッドが呼び出されたときに指定されたリターン・コードでイベント・ループから抜けるには、C++アプリケーションはQQmlEngine::exit(int) シグナルをQCoreApplication::exit(int) スロットに接続します。

quit()も参照 。

fontSpecifier オブジェクトで指定されたプロパティを持つフォント、またはそれに最も近いフォントを返します。fontSpecifier オブジェクトは、有効なキーがfont タイプのサブプロパティ名であり、値が各サブプロパティに対して有効な値である、キーと値のペアを含んでいる必要があります。無効なキーは無視されます。

フォントファミリ アプリケーションが利用可能なフォントファミリの一覧を返します。

date の文字列表現 （オプシ ョ ンでformat を用いて組版 さ れた も の） を返 し ます。

date パ ラ メ タ は、 JavaScript のDate オブジ ェ ク ト 、date プロパテ ィ 、QDate 、QDateTime 値のいずれかです。format およびlocaleFormatOption パラメータは、Qt.formatDateTime() で説明されているように、可能なフォーマット値のいずれかである。

format が指定されていない場合、date はデフォルトのロケールを使用してLocale.ShortFormat でフォーマットされます。

Localeも参照のこと 。

format とlocaleFormatOption を使ってフォーマットされたdateTime の文字列表現を返します。

dateTime パラメータには、JavaScript のDate オブジェクト、date プロパティ、QDate 、QTime 、QDateTime の値を指定することができます。

format が提供されない場合、dateTime はデフォルトロケールを用いてLocale.ShortFormat でフォーマットされます。そうでない場合は、format のいずれかを指定する：

• Qt.RFC2822Date やQt.ISODate など、Qt::DateFormat の列挙値のいずれか。
• 返される文字列の書式を指定する文字列。
• locale オブジェクト。

format でロケールオブジェクトが指定されている場合、dateTimeはQLocale::toString でフォーマットされる。 この場合、localeFormatOption にQLocale::FormatType 型の値を保持して、さらにフォーマットを調整することができる。何も指定されていない場合は、Locale.ShortFormat 。

format 、書式文字列を指定する場合は、以下の式を使用して日付を指定する：

さらに、以下の式を使用して時刻を指定することができます：

その他の入力文字は無視される。一重引用符で囲まれた文字列はテキストとして扱われ、式としては使用されない。連続する2つの一重引用符（"'"）は、出力では一重引用符に置き換えられる。

例えば、次のような日時値が指定されたとする：

// 21 May 2001 14:13:09
var dateTime = new Date(2001, 5, 21, 14, 13, 09)

このdateTime の値を、Qt.formatDateTime() 、Qt.formatDate （）またはQt.formatTime （）に、以下のformat の値とともに渡すと、以下のような結果が得られる：

Localeも参照のこと 。

time の文字列表現を返します。オプションで、format を使ってフォーマットされ、指定された場合はlocaleFormatOption も返します。

time パラメータには、JavaScript のDate オブジェクト、QTime 、またはQDateTime の値を指定することができます。format 、localeFormatOption パラメータは、Qt.formatDateTime()で説明されているように、可能なフォーマット 値のいずれかである。

format が指定されていない場合、time はデフォルトのロケールを使用してLocale.ShortFormat でフォーマットされます。

Localeも参照のこと 。

ガベージ・コレクタを実行する。

これはQJSEngine::collectGarbage() を呼び出すのと同じである。

ガベージコレクションも参照 。

指定したhue,saturation,lightness,alpha 成分を持つ色を返します。すべての構成要素は、0 から 1 の範囲内である必要があります（包含）。

指定したhue,saturation,value,alpha 成分を持つ色を返します。すべての構成要素は 0 ～ 1 の範囲内にあ る 必要があ り ます （包含）。

object が Qt または QML オブジェクトへの有効な参照である場合はtrue を、そうでない場合はfalse を返します。

baseColor よりも明るい色を、指定されたfactor の値だけ返します。

factor が 1.0 より大きい場合、この関数はより明るい色を返します。factorを1.5に設定すると、50%明るい色を返します。factorが1.0より小さい場合、返される色は暗くなりますが、この目的にはQt.darker()関数を使用することをお勧めします。係数が 0 または負の場合、戻り値は指定されません。

この関数は、現在の RGB カラーを HSV に変換し、値（V）成分に係数を掛けて、色を RGB に戻します。

factor が与えられない場合は、baseColor より 50% 明るい色（factor 1.5）を返します。

指定されたname を持つロケールを表す JS オブジェクトを返します。このオブジェクトは "language[_territory][.codeset][@modifier]" あるいは "C" の形式を持ちます：

• language は、小文字の2文字のISO 639言語コードです、
• territory は大文字の2文字のISO 3166国コードで
• codeset と は無視される。modifier

文字列がロケールの書式に違反していたり、languageが有効なISO 369コードでない場合は、代わりに "C "ロケールが使用される。countryが存在しないか、有効なISO 3166コードでない場合は、指定された言語に最も適した国が選択される。

Localeも参照 。

data の md5 ハッシュを 16 進文字列で返します。

identity matrix4x4 を返します。

指定されたvalues を含む matrix4x4 を返します。values は、16 個のエントリを持つ JavaScript 配列であることが期待されます。

配列の添字は、以下のように行列の位置に対応します：

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

引数は行列内の位置に対応する：

ユーザーのデスクトップ環境設定に基づいて、指定されたtarget urlを外部アプリケーションで開こうとする。成功した場合はtrue を、失敗した場合はfalse を返す。

x 、y 座標を指定して点を返す。

disambiguation 文字列と、複数形を含む文字列の場合はn の値に基づいて、sourceText の翻訳バージョンを返します。そうでない場合は、適切な翻訳文字列がない場合はsourceText 自身を返します。

例

Text { text: qsTr("hello") }

例：同じsourceText が同じ翻訳コンテキスト内で異なる役割で使用される場合、disambiguation に追加の識別文字列を渡すことができます。詳細と例については、Disambiguate Identical Textを参照してください。

Qt による国際化」と「翻訳用ソースコードの記述」も参照して ください。

id で識別される翻訳文字列を返します。一致する文字列が見つからない場合は、id自体が返されます。こ れは、 通常の条件下では発生す る べ き ではあ り ません。

n >= 0 の場合、結果の文字列内の%n の出現はすべて、n の 10 進表現に置き換えられます。 さらに、n の値によって、翻訳テキストが変わることがあります。

例

Text { text: qsTrId("hello_id") }

のようなソース文字列テンプレートを指定することができます：

//% <string>

または

\begincomment% <string> \endcomment

例

Text {
    //% "hello"
    text: qsTrId("hello_id")
}

この関数で使用するのに適したバイナリ翻訳（QM）ファイルを作成するには、lrelease ツールに-idbased オプションを渡す必要があります。

QT_TRID_NOOP() およびInternationalization with Qtも参照してください 。

sourceText 指定されたcontext 内のsourceText の翻訳バージョンを返します。オプションとして、disambiguation 文字列と、複数形を含む文字列のためのn の値に基づいています。

同じsourceText が同じ翻訳context 内で異なる役割で使用される場合、disambiguation のために追加の識別文字列を渡すことができます。

例

Text { text: qsTranslate("CustomContext", "hello") }

Qt による国際化も参照してください 。

指定されたscalar,x,y,z の値を持つクォータニオンを返します。

この関数はQQmlEngine::quit() シグナルを発生させます。このメソッドが呼ばれたときにC++アプリケーションを終了するには、QQmlEngine::quit() シグナルをQCoreApplication::quit() スロットに接続します。

exit()も参照 。

x,y と、指定されたwidth とheight を左上隅とする矩形を返す。

呼び出し元のURLに相対的に解決されたurl を返す。

呼び出し元が存在しない場合や、呼び出し元が QML コンテキストに関連付け られていない場合は、QML エンジンのベース URL に対して解決されたurl を返す。QMLエンジンにベースURLがない場合は、url を返す。

url()も参照 。

context の QML コンテキストの URL に相対的に解決されたurl を返す。context が QML コンテキストと関連付けられていない場合、QML エンジンのベース URL に相対的に解決されたurl を返す。QMLエンジンにベースURLがない場合はurl を返す。

url()も参照してください 。

red,green,blue,alpha の各成分を持つ色を返します。すべてのコンポーネントは 0 から 1 の範囲でなければならない。

指定されたwidth とheight を持つサイズを返す。

この関数を使うと、ある色 (baseColor) を別の色 (tintColor) で染めることができます。

通常、色合いの色はほとんど透明でなければなりません。下の例では、1/16だけ不透明の純粋な赤を着色色にすることで、わずかな赤の色合いを提供しています。

Item {
    Rectangle {
        x: 0; width: 80; height: 80
        color: "lightsteelblue"
    }
    Rectangle {
        x: 100; width: 80; height: 80
        color: Qt.tint("lightsteelblue", "#10FF0000")
    }
}

Tint は、何らかのイベントによって微妙な変化を伝えようとする場合に最も有用です。

url をそのまま返します。urlQt.resolvedUrl() とは対照的に、これは相対 URL を保持します。文字列は暗黙のうちに URL に変換されるので、この関数は文字列を引数として呼び出すことができます。

resolvedUrl()も参照 。

指定されたx とy の値を vector2d で返します。

vector3d： 指定されたx,y,z の値を vector3d で返します。

vector4d を、指定されたx 、y 、z 、w の値で返します。