仮想リストボックスの例

この例では、外部データソースから取得したオブジェクトのセットを表示するリストボックスコンポーネントの作成方法を示します。例では、外部データソースは画像ファイル名のリストを含むテキストファイルです。リストボックスは画像とそのファイル名を表示します。画像の読み込みは遅く、メモリを多く消費するため、表示される画像はユーザーがリストボックスをスクロールしたときにオンデマンドでのみ読み込まれます。Visual Studioを使用して例のアプリケーションをビルドして実行します。

例の入手

例を入手するには、Kanzi Studio Quick Start ウィンドウで Projects をクリックし、Examples タブを選択します。Virtual_list_box の例の横にある ダウンロード をクリックします。

Kanzi Studio は、この例を <KanziWorkspace>/Examples/Virtual_list_box ディレクトリにダウンロードします。

例の内容

ツールプロジェクトの主な部分は次のとおりです:

  • キャプション付きの単一画像を表示する方法を指定するプレハブテンプレート。

  • プレハブインスタンスがシーン内のどこに配置されるかを指定するリストボックスです。リストボックスには、オブジェクトジェネレーターのプロパティが文字列 CustomObjectGenerator に設定されており、リストボックスの内容はツールプロジェクトからではなく、例のアプリケーションコードで指定されたカスタムオブジェクトジェネレーターから取得されます。

    アプリケーションコードは、CustomObjectGenerator を定義し、テキストファイルを読み取って利用可能な画像ファイルのセットを決定します。リストボックスは、オブジェクトジェネレーターからすべての表示可能なオブジェクトを要求し、リスト内の残りのオブジェクトは「仮想」です。リストボックスがスクロールされると、表示されるオブジェクトが変わり、リストボックスはさらに多くのオブジェクトを要求します。要求された各オブジェクトに対して、オブジェクトジェネレーターは要求された画像をロードするためのバックグラウンドタスクを開始し、画像のプレハブをインスタンス化し、インスタンス化されたオブジェクトをリストボックスに表示するために提供します。

例を実行する

例を実行するには、

  1. Kanzi Studio で、File > Open Kanzi Command Prompt を選択します。

    Kanzi Command Prompt は、Kanzi 環境変数が設定された Windows コマンドプロンプトを開き、Kanzi のバージョンに対して Kanzi Command Prompt を開きます。

    Kanzi Command Prompt を使用すると、絶対パスを使用したり環境変数を設定したりせずに、Kanzi のユーティリティや、Gradle、CMake などのビルドツールにアクセスできます。

    ../../_images/open-kanzi-command-prompt.png

    ヒント

    Kanzi Command Prompt は、Rightware ディレクトリの Windows スタートメニューで見つけることができます。

    Kanzi のバージョンが複数インストールされている場合は、そのコマンドプロンプトで作業したい Kanzi のバージョンに対応する Kanzi Command Prompt を起動するようにしてください。

  2. <KanziWorkspace>/Examples/Virtual_list_box/Application ディレクトリ内の Kanzi Command Prompt で、サンプルアプリケーション用の Visual Studio ソリューションを生成するスクリプトを実行します。

    generate_cmake_vs2022_solution.bat

    このスクリプトは、<KanziWorkspace>/Examples/Virtual_list_box/Application/build_vs2022 ディレクトリにアプリケーション用の Visual Studio ソリューションを生成します。

  3. Visual Studioで <KanziWorkspace>/Examples/Virtual_list_box/Application/build_vs<Version>/Virtual_list_box.sln Visual Studioソリューションを開きます。

  4. Visual Studioのソリューションエクスプローラーで、Virtual_list_box プロジェクトを右クリックし、Set as StartUp Project を選択します。

  5. 使用したいソリューション構成を選択し、アプリケーションを実行します。

    開発中は、Debug 構成を選択します。製品版を作成する準備ができたら、Release 構成を選択します。

    ../../_images/debug-configuration.png

関連項目

Trajectory List Box 3D ノードを使用する

トラジェクトリリストボックスの例 (Trajectory list box example)