Report Control Properties
The following table describes report control properties. For information about additional properties available for controls, see Form Control Properties.
|
Property |
Description |
|---|---|
|
AutoDeclaration |
Specifies whether a variable is created with the same name as the control. When you set this property to Yes, it is easier to access the report controls from X++ code, and you can find errors at compile time. |
|
Left, Top |
Specify the left and top alignment of a control. |
|
Width, Height |
Specify the width and height of a control. When a control is associated with an extended data type, the Width property of the control overrides the DisplayLength property the extended data type. If you set the Width and Height properties to Auto for a bitmap control, the size of the control is based on the size of the graphic. |
|
DynamicHeight |
Specifies whether the control is resized to display additional lines of text. When this property is set to Yes, page headers, page footers, and repeating columns headings are automatically added, if required. This property is available only for string controls. |
|
TopMargin, BottomMargin, LeftMargin, RightMargin |
Specify the margins for a control. |
|
ModelFieldName |
Specifies a field that is used to determine the left alignment and width of a control. |
|
ConfigurationKey |
Enables you to specify a configuration key for the control. |
|
SecurityKey |
Enables you to specify a security key for the control. This enables administrators to determine whether individual user groups should be able to see the control or not. For more information, see Create and Apply Security Keys. |
|
Label |
Enables you to specify a title for the control. If the label is not specified here, it is inherited from the field. |
|
LabelLineBelow |
Specifies the format of the underline for the control title. |
|
LabelLineThickness |
Specifies the format of the line below column headings. |
|
MenuItemType |
Specifies whether the menu item is an action, display, or output menu item. A display menu item is for a form, and an output menu item is for a report. An output menu item is for a class, job, or query. |
|
MenuItemName |
Specifies the name of the menu item. The available menu items in the property list vary depending on the setting of the MenuItemType property.https://msdn.microsoft.com/en-us/library/bb314839(v=ax.10).aspx |
|
MenuItemLabel |
Specifies the label for a menu item. |
|
WebTarget |
Specifies the location for the control in a Web report. |
|
Table |
Specifies a data source for the control. This property is not available for text, shape, box, and bitmap controls. |
|
DataField |
Specifies a table field for the control. This property is not available for text, shape, box, and bitmap controls. |
|
ArrayIndex |
Specifies the array element that displays in a control. The control is based on an extended data with array elements. This property is not available for text and shape controls. |
|
DataMethod |
Specifies a display method that displays data in a control. This property is not available for text, shape, and box controls. |
|
Text |
Specifies the text string that is displayed in a control. This property is available only for text controls. |
|
TypeHeaderPrompt |
Specifies whether a line of dots is added fill the space between the control title and the control value. This property is available only for text and prompt controls. |
|
Type |
Specifies the type of shape that is displayed. This property is available only for shape controls. |
|
Line |
Specifies the appearance of the lines that form a shape. This property is available only for shape controls. |
|
ImageName |
Specifies the file name for an image. This property is available only for bitmap controls. |
|
ImageResource |
Specifies an ID for a system resource to display. The resource macro provides a list of these IDs. Macros are in the Application Object Tree (AOT) under the Macros node. This property is available only for bitmap controls. |
|
ResizeBitmap |
Specifies whether an image can be resized to fit the dimensions of a control. This property is available only for bitmap controls. |
|
WarnIfMissing |
Specifies whether a message is displayed if an image is missing from the report. This property is available only for bitmap controls. |
|
ShowPicAsText |
Specifies whether the file name for an image instead of the image is displayed. This property is available only for bitmap controls. |
|
ColorScheme |
Specifies the color palette for a control. |
|
BackgroundColor |
Specifies the background color for a color. This property setting can be overridden by using the BackStyle property. |
|
BackStyle |
Specifies whether the control background is opaque or transparent. For bitmap controls, when the property is set to Transparent, pixels that have the same color are transparent. For all other controls, when the property is set to Transparent, the foreground color is used as the background color. |
|
ForegroundColor |
Specifies the foreground color for a control. |
|
LineAbove, LineBelow, LineLeft, LineRight |
Specify the type of line for a control border. If your report has many lines or boxes, consider using a shape control inside the individual sections. |
|
Thickness |
Specifies the thickness of a control border. |
|
Font, FontSize, Italic, Underline and Bold |
Specifies text formatting. |
|
SumAll |
Specifies whether the sum of all values is calculated. This property is available only for integer and real controls. |
|
SumPos |
Specifies whether the sum of all positive values is calculated. This property is available only for integer and real controls. |
|
SumNeg |
Specifies whether the sum of all negative values is calculated. This property is available only for integer and real controls. |
|
ExtraSumWidth |
Modifies the default width allowed for sums. This property is available only for integer and real controls. |
|
Alignment |
Specifies the alignment of a value displayed in a control. |
|
ChangeCase |
Specifies the case of text that a user enters. This property is available only for string, enum, text, and prompt controls. |
|
SignDisplay |
Specifies how the sign of a number is displayed. This property is available only for integer and real controls. |
|
RotateSign |
Specifies whether the sign for the control is inverted. This property is available only for integer and real controls. |
|
ShowZero |
Specifies whether a 0 value is displayed. This property is available only for integer and real controls. |
|
DisplaceNegative |
Specifies a new position for a value in a grid control when the value is a negative number. This property is available only for integer and real controls. |
|
AllowNegative |
Specifies whether the control accepts negative values. This property is available only for integer and real controls. |
|
ThousandSeparator |
Specifies the symbol used to separate thousands. This property is available only for real controls. |
|
DecimalSeparator |
Specifies the symbol used to separate decimals. This property is available only for real controls. |
|
NoOfDecimals |
Specifies the number of decimals displayed. The default is 20. This property is available only for real controls. |
|
AutoInsSeparator |
Specifies whether a decimal separator is displayed. This property is available only for real controls. |
|
FormatMST |
Specifies whether values are formatted using standard currency format. This property is available only for real controls. |
|
MinNoOfDecimals |
Specifies the minimum number of decimals displayed. Trailing zeros are not displayed. |
|
DateFormat |
Specifies the format for a date. This property is available only for date controls. |
|
DateSeparator |
Specifies the separator that appears between the month, day, and year. This property is available only for date controls. |
|
DateYear |
Specifies the format for the year. This property is available only for date controls. |
|
DateMonth |
Specifies the format for the month. This property is available only for date controls. |
|
DateDay |
Specifies the format for the day. This property is available only for date controls. |
|
TimeFormat |
Specifies a 24-hour or AM/PM format. This property is available only for time controls. |
|
TimeHours |
Specifies whether hours are displayed. This property is available only for time controls. |
|
TimeMinutes |
Specifies whether minutes are displayed. This property is available only for time controls. |
|
TimeSeconds |
Specifies whether seconds are displayed. This property is available only for time controls. |
|
TimeSeparator |
Specifies the symbol used to separate hours, minutes, and seconds. This property is available only for time controls. |
|
ExtendedDataType |
Specifies an extended data type on which to base the field associated with the control. |