Item QML Type

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

• 継承したメンバを含むすべてのメンバのリスト

列挙

• TransformOrigin

プロパティ

• activeFocus : Item (since Qt Quick Ultralite 2.9)
• anchors
  • 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
• clip : bool
• enabled : bool
• height : real
• implicitHeight : real
• implicitWidth : real
• opacity : real
• parent : Item
• state : string
• states : list<State>
• transitions : list<Transition>
• visible : bool
• width : real
• x : real
• y : real
• z : real

方法

• Item childAt(real x, real y)
• void forceActiveFocus()
• point mapFromItem(Item item, point p)
• rect mapFromItem(Item item, rect r)
• point mapFromItem(Item item, real x, real y)
• rect mapFromItem(Item item, real x, real y, real width, real height)
• point mapToItem(Item item, point p)
• rect mapToItem(Item item, rect r)
• point mapToItem(Item item, real x, real y)
• rect mapToItem(Item item, real x, real y, real width, real height)

詳細説明

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

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

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

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

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

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

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

forceActiveFocusも参照 。

anchors group

アンカーは、他の項目との関係を指定して項目を配置する方法を提供します。

マージンは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
        // ...
    }
}

Item {
    Image {
        id: pic
        // ...
    }
    Text {
        id: label
        anchors.left: pic.right
        anchors.leftMargin: 5
        // ...
    }
}

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

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

詳しくはアンカーレイアウトを参照してください。

clip : bool

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

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

enabled : bool

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

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

visibleも参照してください 。

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

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

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

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

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

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

// 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
    }
}

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
        }
    }
}

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

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

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

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

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 およびenabledも参照してください 。

z : real

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

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

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

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

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

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

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

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

Item childAt(real x, real y)

この項目の座標系内の点 (x,y) で見つか っ た、 最初に見え る 子項目を返 し ます。

そのような項目がない場合はnull を返します。

void forceActiveFocus()

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

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

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

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

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

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