Dashboard Page
Each section of content in a dashboard is called a dashboard page. The opaque handle ProUIDashboardPage represents an individual page, that is, either the dialog bar, or a single slide-down panel.
Dashboard Page Options
Functions Introduced:
Use the function
ProUIDashboardpageoptionsAlloc() to allocate a handle representing a single page (or layout) that will be shown in a dashboard. The input arguments for this function are:
• page_name— Specifies the page name (must be unique).
• resource_name—Specifies the name of the resource file to use (whose top component must be a layout, not a dialog). If NULL, an empty default layout is used.
• application_data—Specifies the application data stored for the page.
Use the function
ProUIDashboardpageoptionsNotificationSet() to assign a function to be called upon a certain event occurring in the dashboard. The input arguments for this function are:
• options—Specifies a handle representing a dashboard page.
• notification—Specifies the function to be called upon the designated event occurrence.
• appdata—Specifies the application data passed to the callback function when it is invoked.
You can register event notifications for the following events on the dashboard page:
• PRO_UI_DASHBOARD_PAGE_CREATE—when the page is first created.
• PRO_UI_DASHBOARD_PAGE_SHOW—when the page is shown (slide-down panels only).
• PRO_UI_DASHBOARD_PAGE_HIDE—when the page is hidden (slide-down panels only).
• PRO_UI_DASHBOARD_PAGE_DESTROY—when the page is destroyed.
You can use the function
ProUIDashboardpageoptionsFree() to free a handle representing a single page (or layout) that will be shown in a dashboard.