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.50).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.

Community Additions

ADD
Show: