ステップ2 - コンテンツを作成および修正する

このステップでは、Kanzi Studio プロジェクトでコンテンツを作成および変更する方法を学習します。

コンテンツを作成する

Kanzi アプリケーションの構造は、Node Tree ウィンドウと Activity Browser ウィンドウで作成します。このステップでは、Node Tree ウィンドウでコンテンツを作成します。

Node Tree ウィンドウは、Kanzi Studio インターフェイスの左上にあります。

Node Tree ウィンドウでは、Screen にアプリケーションのノードツリーが含まれています。デバイスで Kanzi アプリケーションを起動すると、ノードツリー内のすべてのノードが Kanzi によってデバイスのメモリーにロードされます。

ノードツリーは、コンテンツを表示するノード(例: Image ノード)とロジックを実装するノード(例: Button 2D ノード)から構成されています。同じノードツリーは2Dおよび3Dノードをサポートし、それらを接続する手段を提供します。

Kanzi Studio でプロジェクトを作業する際、Preview ウィンドウでノードツリーの内容を確認できます。

../../_images/project-screen.png

コンテンツを作成するには、以下のようにします。

  1. Node Tree ウィンドウで、RootNode ノードを Alt を押しながら右クリック し、Text Block 2D を選択します。

    ヒント

    Alt キーを押したままアイテムを右クリックすると、作成メニューが表示され、選択したコンテキストで作成可能なアイテムの種類がそこに示されます。

    アプリケーションにテキストを表示するには、Text Block ノードを使用します。

    ../../_images/project-create-text-block-node.png
  2. ノードに名前を付け、OK をクリックします。

    ノードツリーにノードを作成すると、そのノードを Preview ウィンドウで確認できます。

    ../../_images/text-block-name.png ../../_images/text-block-node.png ../../_images/text-block-in-preview.png

    ヒント

    ノードの名前を変更したい場合は、Node Tree ウィンドウでそれを選択し、F2 キーを押して新しい名前を入力します。

  3. Node Tree ウィンドウで、RootNode ノードを Alt を押しながら右クリック し、Image を選択します。

    ビットマップ画像を表示するには、Image ノードを使用します。

    ../../_images/project-create-image-node.png
  4. Node Tree ウィンドウで Viewport 2D ノードを右クリックし、Delete を選択します。

    ../../_images/remove-viewport.png

    ヒント

    アプリケーションの特定の状態で表示する必要があるノードのみを、ノードツリーの中に残してください。こうすることで、アプリケーションが必要以上のリソースを使用しないようにすることができます。

ノードツリーでノードを移動する

ノードツリー内のノード間の関係は非常に重要であり、いくつかの Kanzi コア技術がどのように機能するかを定義します。レンダリング順序、レイアウト、プロパティとリソースの継承、および入力とメッセージの伝播はすべて、ノードツリー内の親ノードと子ノードの関係に依存しています。

例えば、ノードツリー内のノードの位置は、Kanzi がアプリケーションのコンテンツをどのようにレンダリングするかを定義します。Kanzi はペインターのアルゴリズムを使用してコンテンツをレンダリングします。つまり、ノードツリー内の最後のノードを他のすべてのノードの上にレンダリングします。

前のセクションでは、RootNode ノード内に、まず Text Block 2D ノードを作成し、次に Image ノードを作成しました。ノードツリーで Image ノードが Text Block 2D ノードの後にあり、両方のノードが RootNode ノードの左上隅に配置されているため、Image ノードが Text Block 2D ノードを覆い隠しています。

../../_images/image-node1.png ../../_images/image-on-top.png

ノードツリー内でノードを移動するには、Node Tree ウィンドウで以下のいずれかを行います。

  • ノードをドラッグし、ノードツリー内の新しい位置にドロップします。

  • ノードを選択し、Ctrl キーを押したまま ↑ キーと ↓ キーを使用して、ノードツリー内でノードを上下に移動します。

例えば、Image ノードを選択し、Text Block 2D ノードの上に移動します。

../../_images/image-node-on-top.png ../../_images/text-block-on-top.png

ヒント

任意のツリービューで、アイテムの下にあるすべての要素を展開または折りたたむには、Ctrl を押したままエキスパンダー expander をクリックします。

コンテンツを変更する

プロパティは、Kanzi アプリケーション内のコンテンツの特性を定義します。Properties ウィンドウでプロパティを追加、削除、および変更できます。

Properties ウィンドウは、Node Tree ウィンドウの隣にあります。

../../_images/properties-window.png

コンテンツを変更するには、以下のようにします。

  1. Node Tree ウィンドウで Image ノードを選択し、Ctrl H キーを押して、Preview ウィンドウでそのノードを非表示にします。

    ノードアイコンの上にオレンジ色のアイコン hidden-image が表示されている場合は、そのノードが非表示であることを示します。

    ../../_images/hide-node.png

    ヒント

    Preview ウィンドウに、集中して作業したいコンテンツのみを表示したい場合は、ノードを非表示にします。非表示のノードを表示するには、Node Tree ウィンドウでそのノードを選択し、もう一度 Ctrl H キーを押します。

  2. Node Tree ウィンドウで、Text Block 2D ノードを選択します。

    ../../_images/project-text-block.png
  3. Properties ウィンドウで:

    1. Horizontal Alignment プロパティの横にある プロパティを追加 をクリックして、前のステップで選択したノードにそのプロパティを追加します。

      Horizontal Alignment プロパティを使用して、ノードを親ノードに対して水平方向に配置します。

      ../../_images/properties-add-property.png ../../_images/properties-property-added.png
    2. Horizontal Alignment プロパティを Center に設定します。

      この方法で、Text Block 2D ノードを、Text Block 2D ノードのペアレントノードである RootNode ノードの中央に配置します。

      ヒント

      プロパティの機能の簡単な説明を確認するには、Properties ウィンドウでそのプロパティの名前にマウスポインタを移動します。

      ../../_images/properties-property-set.png ../../_images/preview-text-block-horizontal-align.png
  4. Properties ウィンドウで、次のプロパティを追加して設定します。

    • Font Size から30まで

    • Vertical Alignment から Center へ

    • Text へようこそ、Hello Kanzi!

      Text プロパティを使用して、Text Block ノードに表示させたいテキストを設定します。

    ../../_images/properties-text-block2.png

これは、このステップを完了したときに Preview ウィンドウに表示される内容です。

../../_images/step-2.png

ヒント

プロパティを追加 をクリックして追加できるのは、よく使用されるプロパティのみです。

その他のプロパティを追加するには、次のいずれかを行います。

  • Properties で右クリックし、Add Property を選択して、追加するプロパティを選択します。

    ../../_images/properties-right-click-to-add.png
  • Properties の右下隅にある add-properties-window をクリックし、検索フィールドにプロパティの名前を入力して、追加するプロパティをダブルクリックします。

    ../../_images/add-properties-window.gif

関連項目

Kanzi Studio でのプロパティの操作方法については、Kanzi Studio でプロパティを使用する を参照してください。

ノードツリーと Kanzi ノードについて詳しく学ぶには、プレゼンテーション を参照してください。

プレハブについて詳しく知るには、ノードプレハブの使用 を参照してください。

プロパティについて詳しく知るには、プロパティシステム を参照してください。