基本的なコンポーネントのプロパティを設定する

Properties ビューには、選択されたコンポーネントのすべてのプロパティが表示されます。プロパティはタイプ別にグループ化されています。ビューの上部には、コンポーネント タイプ、ID、名前、ジオメトリ、可視性など、すべてのコンポーネントに共通するプロパティが表示されます。

ビューの下部には、コンポーネントタイプに対して定義されたプロパティが表示されます。た と えば、 下図はRectangle とText コンポーネントに設定できる定義済みプ ロパテ ィ を表示 し てい ます。

基本プロパティの設定

すべてのコンポーネントは、Properties のビューで指定できる一連のプロパティを共有しています。

コンポーネントタイプの変更

プリセット・コンポーネントのインスタンスを作成すると、使用したプリセットのすべてのプロパティを持ちます。後で、デフォルト・プロパティの別のセットを持つ別のプリセット・コンポーネントが、あなたの目的にもっと適していることに気づいた場合、Type フィールドをダブルクリックし、フィールドに別のプリセット・コンポーネントの名前を入力することで、コンポーネント・タイプを変更することができます。

新しいコンポーネント タイプでサポートされていないプロパティの値を指定した場合、Qt Quick Designer がそれらを削除してくれます。これを自分で行いたい場合は、プロパティ名の横にある (Actions) メニューを選択し、Reset を選択してプロパティ値を削除してから再試行することができます。

コンポーネント ID の設定

各コンポーネントとコンポーネントの各インスタンスには、それを一意に識別し、他のコンポーネントのプロパティをそれにバインドすることを可能にするIDがあります。ID フィールドでコンポーネントのIDを指定することができます。

IDは一意でなければならず、小文字またはアンダースコア文字で始まり、文字、数字、アンダースコア文字のみを含むことができます。

IDに関する技術的な情報は、id属性を参照してください。

コンポーネントの外部から使用できるプロパティ・エイリアスを追加するには、 を選択します。Actions メニューのメニュー項目を使用して、子コンポーネントのプロパティ値のプロパティ・エイリアスを追加することができます。

注釈のためのコンポーネント名の設定

Name フ ィ ール ド の値は、注釈で用い ら れ る コ ン ポーネ ン ト 名を指定 し ます。こ れは、 コ ン ポーネ ン ト を記述す る フ リ ー フ ォ ーム のテ キ ス ト です。

2D ジオメトリの設定

Geometry - 2D セクションのプロパティを設定して、コンポーネントの位置とサイズを決定します。

Position グループでは、コンポーネントの x 軸と y 軸の位置を設定できます。UI におけるコンポーネントの位置は、他のコンポーネントに対して絶対または相対のいずれかを指定できます。詳細については、レイアウトをスケーラブルにするを参照してください。

2D空間では、コンポーネントのz位置は、コンポーネント階層内の兄弟コンポーネントとの位置関係を決定します。z 位置は、Z stack フィールドで設定できます。

Size グループでは、コンポーネントの幅と高さを設定できます。また、リサイズカーソルを使用して、2D ビューの2D コンポーネントのサイズを変更できます。それに応じて、X とY フィールドの値も変わります。

コンポーネントのサイズと位置は、レイアウトの使用時に自動的に管理することもできます。

コンポーネントファイルのルートコンポーネントの幅と高さが、コンポーネントのサイズを決定します。最終的なサイズがプロパティ・バインディングによって決定される場合、コンポーネントのサイズはゼロ（0,0）になることもあります。詳細については、プレビューコンポーネントサイズ を参照してください。

コンポーネントの位置とサイズをリセットする

移動したコンポーネントをデフォルトの位置に戻すには、2D またはNavigator のビューで右クリックし、Edit >Reset Position を選択します。デフォルトのサイズに戻すには、2D またはNavigator ビューで右クリックし、Edit >Reset Size を選択します。

2D 変換の管理

回転やスケーリングなど、任意の数のトランスフォームをコンポーネントに割り当てることができます。各変換は、1つずつ順番に適用されます。

Origin フィールドで、スケーリングと回転の原点を選択します。

Scale フィールドでスケールファクターを設定する。値が1.0より小さいとコンポーネントは小さくなり、1.0より大きいと大きくなります。負の値を設定すると、2D のビューでコンポーネントがミラーリングされます。

Rotation フィールドで、原点を中心に時計回りの度数でコンポーネントの回転を指定します。

または、2D ビューでコンポーネントをドラッグして、コンポーネントの移動、サイズ変更、回転を行うこともできます。

コンポーネントの可視性の設定

Visibility セクションのプロパティを設定して、コンポーネントの表示と非表示を切り替えます。

Visible をクリアすると、コンポーネントとそのすべての子コンポーネントが非表示になります。プロパティ・バインディングを使用する場合、これは意外な効果をもたらすかもしれません。そのような場合は、代わりにOpacity プロパティを使用する方がよいでしょう。

このプロパティを無効にすると、コンポーネントはマウスイベントを受け取らなくなります。しかし、Advanced セクションのEnabled が選択されている場合、キーイベントは受け取り続け、キーボード・フォーカス・イベントは保持されます。

visibility値は、このプロパティまたは親のvisibleプロパティの変更によってのみ影響を受けます。例えば、このコンポーネントが画面外に移動した場合や、不透明度が 0 に変更された場合は、変更されません。

Opacity フィールドで、コンポーネントの不透明度を 0.0（完全に透明）から 1.0（完全に不透明）の間の数値で指定します。指定された不透明度は子コンポーネントにも個別に適用され、時には驚くような効果をもたらします。

コンポーネントの不透明度を変更しても、そのコンポーネントがユーザー入力イベントを受け取るかどうかには影響しません。

不透明度の値をアニメーションさせて、コンポーネントをフェードイン/フェードアウトさせることができます。

Clip が選択されている場合、コンポーネントとその子はコンポーネントの境界矩形にクリップされます。

State フィールドで、状態を選択して、その状態のプロパティの値を変更します。