カスタムプロパティの追加
各プリセット・コンポーネントには、値を指定できるプリセット・プロパティのセットがあります。特定のコンポーネントタイプには存在しないカスタムプロパティを追加できます。プロパティを動的式にバインドして、他のコンポーネントが読み取れるコンポーネントのグローバル・プロパティを定義します。たとえば、子コンポーネントで使用できるグローバル・プロパティをルート・コンポーネントに指定できます。
たとえば、UI 要素間の間隔を指定するには、margin プロパティを持たないコンポーネントに margin を定義し、バインディングを使用して他のコンポーネントから margin プロパティの値を参照します。
同様に、プリセット・コンポーネントをベースとした独自のコンポーネントにカスタムプロパティを追加することもできます。
データ駆動型のコンテンツは、関連するコンポーネントのパブリック・プロパティ(エイリアス・プロパティ)としてエクスポートする必要があります。例えば、スピードメーターは、UIがバインドされるスピードのintまたはrealプロパティを持つ必要があります。
![設定]ビューの[ローカルカスタムプロパティ]および[エクスポーズドカスタムプロパティ]設定。 設定]ビューの[ローカルカスタムプロパティ]および[エクスポーズドカスタムプロパティ]設定。](images/custom-properties.png)
コンポーネントのプロパティを追加する
コンポーネントのカスタムプロパティを追加するには
- Properties >Local Custom Properties に進みます。
(Add) を選択します。
- プロパティにName とType を設定します。

Add New Property ダイアログが表示されます。
- Add Property を選択してプロパティを追加します。
プロパティ値のバインド
プロパティの値を、別のプロパティの値や、アプリケーションでアクセス可能なデータにバインドするには、次のようにします:
- Properties ビ ュ ーで、 プ ロ パテ ィ の横の
を選択。 - Set Binding を選択します。

Binding Editor ダイアログが表示されます。
詳細については、「バインディングを設定する」を参照してください。
Connections ビューでカスタム プロパティを追加する
Connections ビューでコンポーネントのカスタムプロパティを追加するには、次の手順に従います:
- 2D またはNavigator ビューでコンポーネントを選択します。
- Connections >Properties に進みます。

- カスタムプロパティを追加するには、
(Add) を選択します。 - カスタムプロパティエディタで、含めるプロパティのType を選択します。

カスタムプロパティエディタ。
- プロパティのName とValue を設定します。
カスタムプロパティの削除
Connections >Properties に移動し、
(Remove) を選択して、選択したカスタムプロパティを削除します。
対応 し てい る プ ロ パテ ィ の種類
以下の表に、対応するプロパティの種類を示します:
| タイプ | 説明 |
|---|---|
| エイリアス | 別のプロパティへの参照を保持するプロパティのエイリアス。 |
| ブール | バイナリtrue またはfalse 値 |
| 色 | "red" 、"green" 、"lightsteelblue" のような SVG 色名、あるいはそれぞれ"#RRGGBB" や"#AARRGGBB" のような形式の 16 進数の三つ組や四つ組を用いて指定できる色値。例えば、赤色は"#FF0000" の三進数に対応し、少し透明な青色は"#800000FF" の四進数に対応します。さらに、次の Qt 関数を使用できます:Qt.rgba(),Qt.hsva(),Qt.hsla(),Qt.darker(),Qt.lighter(),Qt.tint()。 |
| int | 0、10、-20 などの整数。 |
| real | 小数点を含む数値 |
| 文字列 | 自由形式のテキスト文字列 |
| テクスチャ入力 | CustomMaterial または Effect のシェーダに公開されるテクスチャを指定します。 |
| url | ファイル名などのリソースロケータ。絶対 URL (http://qt-project.org) または相対 URL (pics/logo.png) のいずれかを指定します。相対 URL は、親コンポーネントの URL に対して相対的に解決されます。 |
| バリアント | 一般的なプロパティタイプ。例えば、variant プロパティには数値、文字列、オブジェクト、配列、関数を格納することができます。 |
| vector2d | x と y の属性を持つ値を指す。 |
| vector3d | x, y, z属性を持つ値を指す。 |
| ベクトル4d | x, y, z, w属性を持つ値を指します。 |
参照: How to:UI コンポーネントの使用法、Qt Quick UI デザイン、 Qt Quick UI のデザインも参照してください。
Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.