C
Item QML Type
基本的な視覚的QML型。詳細...
| Import Statement: | import QtQuick |
| Since: | Qt Quick Ultralite 1.0 |
| Inherits: | |
| Inherited By: | 34 typesAlternateKeysListBackground, AlternateKeysListDelegate, AnimatedSprite, AnimatedSpriteDirectory, Application, ApplicationScreens, BorderImage, CharacterPreviewDelegateBase, Column, ColumnLayout, Control, Flickable, GridLayout, Image, ImageLayer, InputPanel, ItemLayer, KeyboardLayoutLoader, KeyPanel, MouseArea, PaintedItem, PathView, QulPerfOverlay, Rectangle, Repeater, Row, RowLayout, Screen, SelectionListHighlight, SelectionListItem, Shape, SpriteLayer, StyleConstants, and Text |
列挙
プロパティ
- 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
方法
- childAt(real x, real y)
- 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 |
変換の起点のリストを提供します。
| 定数 | 説明 |
|---|---|
Item.TopLeft | アイテムの左上隅 |
Item.Top | アイテムの上端 |
Item.TopRight | 項目の右上隅 |
Item.Left | 項目の左 |
Item.Center | 項目の中央 |
Item.Right | 項目の右 |
Item.BottomLeft | アイテムの左下 |
Item.Bottom | 項目の下 |
Item.BottomRight | 項目の右下隅 |
プロパティ文書
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 } }
activeFocus : Item |
この読み取り専用プロパティは、アイテムがアクティブフォーカスを持つかどうかを示します。
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 に設定します。マージンはアンカー固有であり、アイテムがアンカーを使用しない場合は適用されないことに注意してください。
オフセットは水平方向中央、垂直方向中央、ベースラインアンカーに適用されます。
| テキス ト を画像に、 水平方向中央に、 垂直方向下に、 マージン付きでアンカー。 |
| テキストの左側は、画像の右側にマージン付きで固定されます。両方のyプロパティのデフォルトは0です。 |
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 の不透明度を指定しており、これは、子が不透明度を指定していないにもかかわらず、その青の子の長方形の不透明度に影響します。
| |
|
アイテムの不透明度を変更しても、そのアイテムがユーザー入力イベントを受け取るかどうかには影響しません。(対照的に、visible またはenabled プロパティをfalse に設定すると、タッチイベントが停止します)。
visibleも参照してください 。
parent : Item |
この読み取り専用プロパティは、アイテムの視覚的親を保持します。
詳しくはVisual parentを参照してください。
注意: このプロパティは読み取り専用であるため、実行時にアイテムのビジュアルペアレントを変更することは不可能である。
state : string |
このプロパティは、アイテムの現在の状態の名前を保持する。
アイテムがデフォルト状態、つまり明示的な状態が設定されていない場合、このプロパティは空文字列を保持する。同様に、このプロパティに空文字列を設定することで、アイテムをデフォルト状態に戻すことができる。
注: このプロパティは、.qml ファイル内のルート Item に対してのみ存在します。
状態の使用」も参照してください 。
このプロパティは、このアイテムの可能な状態のリストを保持する。このアイテムの状態を変更するには、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 に変更された場合は変更されない。
z : real |
兄弟アイテムのスタック順序を設定します。デフォルトでは、積み重ね順序は 0 です。
スタック順が高いアイテムは、スタック順が低い兄弟の上に描画されます。同じスタッキング値を持つアイテムは、表示される順番が下から上に描画されます。負のスタッキング値を持つアイテムは、親のコンテンツの下に描画されます。
次の例は、積み重ね順序のさまざまな効果を示しています。
| 同じz - より後の子がより前の子の上に:
|
| より高いz が上:
|
| 同じz - 親の上の子:
|
| 下z
|
メソッド・ドキュメンテーション
item の座標系にある点 (x,y) または矩形 (x,y,width,height) を、このアイテムの座標系からマップし、マップされた座標に一致するpoint またはrect を返す。
警告: Image,Text,StaticText の変換は、Qt Quick Ultralite が異なる変換を適用するため、マッピングでは無視されます。
item の値がnull の場合、ルート QML ビューの座標系から点または矩形をマッピングします。
アイテムの座標系にある点 (x,y) または矩形 (x,y,width,height) を、このitem の座標系にマップし、マップされた座標に一致するpoint またはrect を返します。
警告: Image,Text,StaticText の変換は、Qt Quick Ultralite が異なる変換を適用するため、マッピングでは無視されます。
item の値がnull の場合、これは点または矩形をルート QML ビューの座標系にマップします。
forceActiveFocus() |
アイテムにアクティブフォーカスを強制します。
特定の Qt ライセンスの下で利用可能です。
詳細はこちら。







