Gets the item's name displayed in the dashboard.
A text displayed in the dashboard as an item's name or caption.
The GetDisplayName() method returns the actual text displayed as an item's name in the dashboard.
Consider a grid's column. The string displayed as its caption is created when a dashboard is loaded. It is constructed automatically from the data field's name. If the name is assigned in code, that is, if the Name property is not null, its value is used as a column's caption. The end-user can rename a data item in the Dashboard Designer. If it happens, the specified name becomes the column's caption. To get the column's caption displayed in the dashboard grid's column header, use the GetDisplayName method.
Other dashboard items obtain their display names using the same procedure. The GetDisplayName method provides the developer with the ability to obtain the final text displayed in the dashboard.