TdxCustomReportControl.GroupName Property

Specifies a group (report name scope) for the TdxReportControl component.

Declaration

property GroupName: string read; write;

Property Value

Type	Description
string	The TdxReport/TdxReportControl component group name (case-sensitive).

Remarks

All TdxReport and TdxReportControl instances initially belong to the same report name scope. All report components that share the same report name are associated with the same layout definition. Any changes made in the Report Designer are applied to all report components with the same report name.

Usage Scenario

Use the GroupName property to associate the TdxReportControl component with a dedicated report name.

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 group (report name scope).

Footnotes

1. The TdxReport component also implements its GroupName property.