このページでは

C

Item QML Type

基本的な視覚的QML型。詳細...

列挙

プロパティ

方法

詳細説明

Item タイプはQt Quick のすべてのビジュアル アイテムの基本タイプです。

Qt Quick のすべてのビジュアルアイテムは Item を継承します。Itemオブジェクトはビジュアルな外観を持ちませんが、XY位置、幅、高さ、アンカーなど、ビジュアルアイテムに共通するすべての属性を定義します。

Item タイプは複数のアイテムを 1 つのルートビジュアルアイ テムの下にグループ化するのに便利です。例えば

import QtQuick 2.15

Item {
    Image {
        source: "qrc:/tile.png"
    }
    Image {
        x: 80
        width: 100
        height: 100
        source: "qrc:/tile.png"
    }
    Image {
        x: 190
        width: 100
        height: 100
        fillMode: Image.Tile
        source: "qrc:/tile.png"
    }
}

Item QML Typeも参照してください

列挙ドキュメント

TransformOrigin

変換の起点のリストを提供します。

定数説明
Item.TopLeftアイテムの左上隅
Item.Topアイテムの上端
Item.TopRight項目の右上隅
Item.Left項目の左
Item.Center項目の中央
Item.Right項目の右
Item.BottomLeftアイテムの左下
Item.Bottom項目の下
Item.BottomRight項目の右下隅

プロパティ文書

height : real

width : real

x : real

y : real

アイテムの位置とサイズを定義します。デフォルト値は0 です。

(x,y)の位置はparent からの相対位置です。

Item { x: 100; y: 100; width: 100; height: 100 }

implicitHeight : real

implicitWidth : real

width またはheight が指定されていない場合、Item の自然な幅または高さを定義します。

たいていのアイテムのデフォルトの暗黙のサイズは 0x0 ですが、ImageText のように、オーバーライドできない固有の暗黙のサイズを持つアイテムもあります。

暗黙のサイズを設定することは、例えば、その内容に基づいて好ましいサイズを持つコンポーネントを定義するのに便利です:

// Label.qml
import QtQuick 2.15

Item {
    property alias icon: image.source
    property alias label: text.text
    implicitWidth: text.implicitWidth + image.implicitWidth
    implicitHeight: Math.max(text.implicitHeight, image.implicitHeight)
    Image { id: image }
    Text {
        id: text
        anchors.left: image.right; anchors.right: parent.right
        anchors.verticalCenter: parent.verticalCenter
    }
}

activeFocus : Item [read-only, since Qt Quick Ultralite 2.9]

この読み取り専用プロパティは、アイテムがアクティブフォーカスを持つかどうかを示します。

activeFocusがtrueの場合、このアイテムは現在キーボード入力を受けているアイテムである。

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

forceActiveFocusも参照してください


anchors group

anchors.baseline : AnchorLine

anchors.baselineOffset : real

anchors.bottom : AnchorLine

anchors.bottomMargin : real

anchors.centerIn : Item

anchors.fill : Item

anchors.horizontalCenter : AnchorLine

anchors.horizontalCenterOffset : real

anchors.left : AnchorLine

anchors.leftMargin : real

anchors.margins : real

anchors.right : AnchorLine

anchors.rightMargin : real

anchors.top : AnchorLine

anchors.topMargin : real

anchors.verticalCenter : AnchorLine

anchors.verticalCenterOffset : real

アンカーは、他のアイテムとの関係を指定することで、アイテムを配置する方法を提供します。

マージンはtop、bottom、left、right、fillアンカーに適用されます。anchors.margins プロパティを使用すると、様々なマージンを一度に同じ値に設定することができます。これは、以前に設定された特定のマージンを上書きすることはありません。明示的なマージンをクリアするには、その値をundefined に設定します。マージンはアンカー固有であり、アイテムがアンカーを使用しない場合は適用されないことに注意してください。

オフセットは水平方向中央、垂直方向中央、ベースラインアンカーに適用されます。

テキス ト を画像に、 水平方向中央に、 垂直方向下に、 マージン付きでアンカー。
Item {
    Image {
        id: pic
        // ...
    }
    Text {
        id: label
        anchors.horizontalCenter: pic.horizontalCenter
        anchors.top: pic.bottom
        anchors.topMargin: 5
        // ...
    }
}

テキストの左側は、画像の右側にマージン付きで固定されます。両方のyプロパティのデフォルトは0です。
Item {
    Image {
        id: pic
        // ...
    }
    Text {
        id: label
        anchors.left: pic.right
        anchors.leftMargin: 5
        // ...
    }
}

anchors.fill は、あるアイテムが別のアイテムと同じジオメトリを持つための便利な方法を提供し、4つの方向アンカーをすべて接続することと同じです。

アンカー値をクリアするには、undefined に設定します。

注意: アイテムをアンカーで固定できるのは、兄弟か親だけです。

詳細はアンカーレイアウトを参照。


clip : bool

このプロパティは、クリッピングが有効かどうかを保持します。デフォルトのクリップ値はfalse です。

クリッピングが有効な場合、アイテムは自身のペイントとその子のペイントをバウンディング矩形にクリッピングします。

注意: クリップ矩形は常に軸合わせされます。Image::rotation のようなtransforms でのクリップの使用はサポートされていません。


enabled : bool

このプロパティは、アイテムがタッチイベントを受信するかどうかを保持します。デフォルトでは true です。

このプロパティを設定すると、子アイテムのenabled の値に直接影響します。false に設定すると、すべての子アイテムのenabled 値もfalse になります。true に設定すると、明示的にfalse に設定されていない限り、子アイテムのenabled の値はtrue に戻されます。

visibleも参照。


opacity : real

このプロパティはアイテムの不透明度を保持する。不透明度は0.0(完全に透明)から1.0(完全に不透明)の間の数値で指定する。デフォルト値は1.0である。

このプロパティが設定されると、指定された不透明度が子アイテムにも個別に適用されます。これは、状況によっては意図しない効果をもたらすことがあります。例えば、下の 2 番目の長方形のセットでは、赤の長方形は 0.5 の不透明度を指定しており、これは、子が不透明度を指定していないにもかかわらず、その青の子の長方形の不透明度に影響します。

青い長方形が赤い長方形に重なり、透明度はない。

Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
        Rectangle {
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

青い長方形が赤い長方形に重なり、両方の長方形の透明度は 50% です。

Item {
    Rectangle {
        opacity: 0.5
        color: "red"
        width: 100; height: 100
        Rectangle {
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

アイテムの不透明度を変更しても、そのアイテムがユーザー入力イベントを受け取るかどうかには影響しません。(対照的に、visible またはenabled プロパティをfalse に設定すると、タッチイベントが停止します)。

visibleも参照してください


parent : Item

この読み取り専用プロパティは、アイテムの視覚的親を保持します。

詳しくはVisual parentを参照してください。

注意: このプロパティは読み取り専用であるため、実行時にアイテムのビジュアルペアレントを変更することは不可能である。


state : string

このプロパティは、アイテムの現在の状態の名前を保持する。

アイテムがデフォルト状態、つまり明示的な状態が設定されていない場合、このプロパティは空文字列を保持する。同様に、このプロパティに空文字列を設定することで、アイテムをデフォルト状態に戻すことができる。

注: このプロパティは、.qml ファイル内のルート Item に対してのみ存在します。

状態の使用」も参照してください


states : list<State>

このプロパティは、このアイテムの可能な状態のリストを保持する。このアイテムの状態を変更するには、state プロパティをこれらの状態のいずれかに設定するか、state プロパティを空の文字列に設定してアイテムをデフォルトの状態に戻す。

このプロパティは、State オブジェクトのリストとして指定される。例えば、以下は "red_color "と "blue_color "の状態を持つアイテムである:

import QtQuick 2.15

Rectangle {
    id: root
    width: 100; height: 100

    states: [
        State {
            name: "red_color"
            PropertyChanges { root.color: "red" }
        },
        State {
            name: "blue_color"
            PropertyChanges { root.color: "blue" }
        }
    ]
}

ステートとトランジションの詳細については、「ステートの使用」と「アニメーションとトランジション」を参照してください。

transitionsも参照のこと


transitions : list<Transition>

このプロパティは、このアイテムのトランジションのリストを保持する。stateこのプロパティは、このアイテムのトランジションリストを保持する。

このプロパティは、Transition オブジェクトのリストとして指定します。例えば、次のようになります:

import QtQuick 2.15

Item {
    transitions: [
        Transition {
            //...
        },
        Transition {
            //...
        }
    ]
}

ステートとトランジションの詳細については、「ステートと アニメーションとトランジションの 使用」を参照してください。

statesも参照してください


visible : bool

このプロパティは、アイテムが表示可能かどうかを保持します。デフォルトでは、true です。

このプロパティを設定すると、子アイテムの可視性に直接影響します。false に設定すると、すべての子アイテムのvisible 値もfalse になります。true に設定すると、明示的にfalse に設定されていない限り、子アイテムのvisible の値はtrue に戻されます。

このプロパティをfalse に設定すると、アイテムはタッチ イベントを受け取らなくなる。

注: このプロパティは、このアイテムが画面外に移動した場合や、opacity が 0 に変更された場合は変更されない。

opacity およびenabledも参照してください


z : real

兄弟アイテムのスタック順序を設定します。デフォルトでは、積み重ね順序は 0 です。

スタック順が高いアイテムは、スタック順が低い兄弟の上に描画されます。同じスタッキング値を持つアイテムは、表示される順番が下から上に描画されます。負のスタッキング値を持つアイテムは、親のコンテンツの下に描画されます。

次の例は、積み重ね順序のさまざまな効果を示しています。

青い長方形が赤い長方形の上に重なっているのは、青い長方形が後から現れたため。

同じz - より後の子がより前の子の上に:
Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
    }
    Rectangle {
        color: "blue"
        x: 50; y: 50; width: 100; height: 100
    }
}

赤の長方形が青の長方形の上に重なっているのは、赤の長方形の方がスタッキング値が高いため。

より高いz が上:
Item {
    Rectangle {
        z: 1
        color: "red"
        width: 100; height: 100
    }
    Rectangle {
        color: "blue"
        x: 50; y: 50; width: 100; height: 100
    }
}

青い長方形は赤い長方形の子であるため、赤い長方形の上に重なっている。

同じz - 親の上の子:
Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
        Rectangle {
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

青い長方形が赤い長方形の下にスタックしているのは、青い長方形のスタック値が負であるため。

z
Item {
    Rectangle {
        color: "red"
        width: 100; height: 100
        Rectangle {
            z: -1
            color: "blue"
            x: 50; y: 50; width: 100; height: 100
        }
    }
}

メソッド・ドキュメンテーション

point mapFromItem(Item item, point p)

point mapFromItem(Item item, real x, real y)

rect mapFromItem(Item item, real x, real y, real width, real height)

rect mapFromItem(Item item, rect r)

item の座標系にある点 (x,y) または矩形 (x,y,width,height) を、このアイテムの座標系からマップし、マップされた座標に一致するpoint またはrect を返す。

警告: Image,Text,StaticText の変換は、Qt Quick Ultralite が異なる変換を適用するため、マッピングでは無視されます。

item の値がnull の場合、ルート QML ビューの座標系から点または矩形をマッピングします。


point mapToItem(Item item, point p)

point mapToItem(Item item, real x, real y)

rect mapToItem(Item item, real x, real y, real width, real height)

rect mapToItem(Item item, rect r)

アイテムの座標系にある点 (x,y) または矩形 (x,y,width,height) を、このitem の座標系にマップし、マップされた座標に一致するpoint またはrect を返します。

警告: Image,Text,StaticText の変換は、Qt Quick Ultralite が異なる変換を適用するため、マッピングでは無視されます。

item の値がnull の場合、これは点または矩形をルート QML ビューの座標系にマップします。


childAt(real x, real y)

このアイテムの座標系内の点 (x,y) で最初に見つかった可視の子アイテムを返します。

そのようなアイテムがない場合はnull を返します。


forceActiveFocus()

アイテムにアクティブフォーカスを強制します。


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