Label Element (Report Items) (RDL)
Provides a user-friendly label for an instance of an item within a report.
Syntax
<Textbox Name="..."> <!-- or Line, Rectangle, Image, Subreport, List, Matrix, Table, Chart, Grouping -->
...
<Label>...</Label>
...
</Textbox> <!-- or /Line, /Rectangle, /Image, /Subreport, /List, /Matrix, /Table, /Chart, /Grouping -->
Element Characteristics
| Characteristic | Description |
|---|---|
Data type and length |
String |
Default value |
None |
Cardinality |
0-1: Optional element that can occur once or not at all. |
Element Relationships
| Relationship | Element |
|---|---|
Parent elements |
Chart, Grouping, Image, Line, List, Matrix, Rectangle, Subreport, Table, Textbox |
Child element |
None |
Remarks
The expression within the Label element evaluates to a variant. You can use an expression within the Label element to identify individual instances of a report item with a user-friendly name. Label is used in searches and displayed within the document map. Report item labels appear in the document map as a hierarchy that reflects the hierarchy of items within the report definition.
The label for the item does not appear in the document map if the expression contained in the Label element returns a null value, or Label is not defined. Label is not used for report items within a page header or page footer.
To cause the link in the document map to jump to a child item in the report, use the sibling LinkToChild element. LinkToChild is available only with rectangle items.
See Also
Reference
Report Definition XML Elements
LinkToChild Element (RDL)