TdxCustomReportControl.GroupName Property

Specifies a group name for TdxReportControl components.

Declaration

property GroupName: string read; write;

Property Value

Type	Description
string	The TdxReport/TdxReportControl component group name.

Remarks

Multiple TdxReport and TdxReportControl component instances in the same application share the same VCL backend and resources (such as data connection components).

Usage Scenario

Use the GroupName property to associate the TdxReportControl component with a specific group according to the component purpose in the application. All TdxReport and TdxReportControl components with the same GroupName^[1] property value share the same VCL backend resources.

Code Example: Display Unique Content in Different Report Viewer Instances

The OnCreate event handler demonstrated in this section generates unique group names for each created TdxReportControl component instance.

Tip

This TdxReportControl usage scenario is demonstrated in the following tutorial:

Read Tutorial: A Report Viewer in a Tabbed MDI (SQL Database)

Delphi

procedure TReportChildForm.dxFormCreate(Sender: TObject);
var
  G: TGUID;
begin
  CreateGUID(G);
  dxReportControl1.GroupName := GUIDToString(G);
end;

C++

void __fastcall TReportChildForm::dxFormCreate(TObject *Sender)
{
  TGUID G;
  CreateGUID(G);
  dxReportControl1->GroupName = System::Win::Comobj::GUIDToString(G);
}

Default Value

The default GroupName property value indicates that the TdxReportControl component belongs to an “empty” (common) group. All TdxReport and TdxReportControl components with an unspecified GroupName^[1] property belong to the same “empty” group and share the same backend resources/data sources.

Footnotes

1. The TdxReport component also implements its GroupName property.