このページでは

カスタムプロパティの追加

各プリセット・コンポーネントには、値を指定できるプリセット・プロパティのセットがあります。特定のコンポーネントタイプには存在しないカスタムプロパティを追加できます。プロパティを動的式にバインドして、他のコンポーネントが読み取れるコンポーネントのグローバル・プロパティを定義します。たとえば、子コンポーネントで使用できるグローバル・プロパティをルート・コンポーネントに指定できます。

たとえば、UI 要素間の間隔を指定するには、margin プロパティを持たないコンポーネントに margin を定義し、バインディングを使用して他のコンポーネントから margin プロパティの値を参照します。

同様に、プリセット・コンポーネントをベースとした独自のコンポーネントにカスタムプロパティを追加することもできます。

データ駆動型のコンテンツは、関連するコンポーネントのパブリック・プロパティ(エイリアス・プロパティ)としてエクスポートする必要があります。例えば、スピードメーターは、UIがバインドされるスピードのintまたはrealプロパティを持つ必要があります。

設定]ビューの[ローカルカスタムプロパティ]および[エクスポーズドカスタムプロパティ]設定。

コンポーネントのプロパティを追加する

コンポーネントのカスタムプロパティを追加するには

  1. Properties >Local Custom Properties に進みます。
  2. プラスボタン (Add) を選択します。

    プロパティ・ビューでプロパティを追加する。

  3. プロパティにNameType を設定します。

    新しいプロパティの追加ダイアログ。

    Add New Property ダイアログが表示されます。

  4. Add Property を選択してプロパティを追加します。

プロパティ値のバインド

プロパティの値を、別のプロパティの値や、アプリケーションでアクセス可能なデータにバインドするには、次のようにします:

  1. Properties ビ ュ ーで、 プ ロ パテ ィ の横のアクションボタン を選択。
  2. Set Binding を選択します。

    装丁編集者。

    Binding Editor ダイアログが表示されます。

詳細については、「バインディングを設定する」を参照してください。

Connections ビューでカスタム プロパティを追加する

Connections ビューでコンポーネントのカスタムプロパティを追加するには、次の手順に従います:

  1. 2D またはNavigator ビューでコンポーネントを選択します。
  2. Connections >Properties に進みます。

    ConnectionsビューのPropertiesタブ。

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

    カスタムプロパティエディタ。

    カスタムプロパティエディタ。

  5. プロパティのNameValue を設定します。

カスタムプロパティの削除

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()。
int0、10、-20 などの整数。
real小数点を含む数値
文字列自由形式のテキスト文字列
テクスチャ入力CustomMaterial または Effect のシェーダに公開されるテクスチャを指定します。
urlファイル名などのリソースロケータ。絶対 URL (http://qt-project.org) または相対 URL (pics/logo.png) のいずれかを指定します。相対 URL は、親コンポーネントの URL に対して相対的に解決されます。
バリアント一般的なプロパティタイプ。例えば、variant プロパティには数値、文字列、オブジェクト、配列、関数を格納することができます。
vector2dx と y の属性を持つ値を指す。
vector3dx, y, z属性を持つ値を指す。
ベクトル4dx, 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.