ダッシュボードページ
ダッシュボードの内容の各セクションをダッシュボードページと呼びます。不透過ハンドル ProUIDashboardPage は、個々のページ、つまりダイアログバーまたは 1 つのスライドダウンパネルを表します。
ダッシュボードページのオプション
次の関数について説明します。
関数
ProUIDashboardpageoptionsAlloc() は、ダッシュボードに表示される 1 つのページ (またはレイアウト) を表すハンドルを割り当てます。この関数の入力引数は次のとおりです。
• page_name - ページ名を指定します (一意でなければなりません)。
• resource_name - 使用するリソースファイルの名前を指定します (ファイルのトップレベルコンポーネントはダイアログではなくレイアウトでなければなりません)。NULL の場合、空のデフォルトのレイアウトが使用されます。
• application_data - ページに保存されるアプリケーションデータを指定します。
関数
ProUIDashboardpageoptionsNotificationSet() は、ダッシュボードで特定のイベントが発生した場合に呼び出される関数を指定します。この関数の入力引数は次のとおりです。
• options - ダッシュボードページを表すハンドルを指定します。
• notification - 指定したイベントが発生した場合に呼び出される関数を指定します。
• appdata - コールバック関数が呼び出されたときに渡されるアプリケーションデータを指定します。
ダッシュボードページにおける次のイベントに対するイベント通知を登録できます。
• PRO_UI_DASHBOARD_PAGE_CREATE - ページが初めて作成される
• PRO_UI_DASHBOARD_PAGE_SHOW - ページが表示される (スライドダウンパネルのみ)
• PRO_UI_DASHBOARD_PAGE_HIDE - ページが非表示になる (スライドダウンパネルのみ)
• PRO_UI_DASHBOARD_PAGE_DESTROY - ページが破棄される
ダッシュボードに表示される 1 つのページ (またはレイアウト) を表すハンドルを解放するには、関数
ProUIDashboardpageoptionsFree() を使用します。