The requested page is not available for the requested platform. You are viewing the content for Default platform.

GroupItem Class

A group used to arrange dashboard items within a dashboard.

Declaration

export class GroupItem extends DashboardItem

Remarks

A dashboard item group arranges dashboard items within the dashboard into a separate layout group. Moreover, the dashboard item group allows you to manage interaction between dashboard items within and outside the group.

Use the interactivityOptions property to get access to the group's interactivity settings.

Examples

The following example shows how to create a dashboard group. Create the GroupItem instance and add it to the Dashboard.groups collection.

Call the Dashboard.rebuildLayout method to rebuild the dashboard layout and display changes.

// Use the line below for a modular approach:
// import * as Model from 'devexpress-dashboard/model'
// Use the line below for an approach with global namespaces:
// var Model = DevExpress.Dashboard.Model;

public createGroup() { 
    var groupItem = new Model.GroupItem();
    groupItem.componentName('groupItem');

    control.dashboard().groups.push(groupItem);
    // ...
    control.dashboard().rebuildLayout();
}

To add a dashboard item to the group, assign the group's componentName to the dashboard item's parentContainer property.

dashboardItem.parentContainer("groupItem");

constructor

Initializes a new instance of the GroupItem class.

Declaration

constructor(dashboardItemJSON?: any, serializer?: DxDesigner.Analytics.Utils.ModelSerializer)

Optional Parameters

Name Type Default Description
dashboardItemJSON any null

A JSON object used for a dashboard deserialization. Do not pass this parameter directly.

serializer DxDesigner.Analytics.Utils.ModelSerializer null

An object used for a dashboard deserialization. Do not pass this parameter directly.

Properties

interactivityOptions Property

Provides access to options that control interactivity features, such as Master Filtering and drill-down.

Declaration

interactivityOptions: DashboardItemGroupInteractivityOptions

Property Value

Type Description
DashboardItemGroupInteractivityOptions

A DashboardItemGroupInteractivityOptions object that defines interactivity options.

Methods

getInfo Method

For internal use.

Declaration

getInfo(): DxDesigner.Analytics.Utils.ISerializationInfoArray

Returns

Type Description
DxDesigner.Analytics.Utils.ISerializationInfoArray