Share via


ReportSection Class

Definition

The ReportSection class contains a collection of report controls.

public ref class ReportSection : Dynamics::AX::Application::TreeNode
[Microsoft.Dynamics.Ax.Xpp.KernelClass]
[Microsoft.Dynamics.BusinessPlatform.SharedTypes.InternalUseOnly]
public class ReportSection : Dynamics.AX.Application.TreeNode
[<Microsoft.Dynamics.Ax.Xpp.KernelClass>]
[<Microsoft.Dynamics.BusinessPlatform.SharedTypes.InternalUseOnly>]
type ReportSection = class
    inherit TreeNode
Public Class ReportSection
Inherits TreeNode
Inheritance
Microsoft.Dynamics.AX.KernelInterop.ProxyBase
ReportSection
Attributes
KernelClassAttribute Microsoft.Dynamics.BusinessPlatform.SharedTypes.InternalUseOnlyAttribute

Remarks

A section is printed on the report when the query for the report is executed or when the methods of the report are executed. This class lets you to create, read, update, and delete X++ code and metadata. Make sure that the user has access to the development security key (SysDevelopment) before this API is called. A report section can be one of the following types: prologue, page header, header, footer, page footer, epilogue, programmable section, header, body, or footer. The section template node type lets you define sections one time and then reuse them many times in different reports. A typical example of this is a check or a giro.

The following example adds a section to a report:

static void test(args a) 
{  
    report r; 
    reportDesign rd; 
    reportSection rs; 
    reportRun rr; 
    // Create a simple report that is not present in  
    // the Application Object Tree. 
    r = new report(); 
    rd = r.addDesign("myDesign"); 
    rs = rd.addProgrammableSection(1);  
    // Add a section triggered by execute(1). 
    rs.addTextControl("Hello world"); 
    // Run the report. 
    rr = new reportRun(r); 
    if (rr.prompt()) // Run the sysPrintForm form. 
    { 
        rr.execute(1); // Execute the programmableSection. 
        rr.print();   // Print report to the target 
                      // (for example, printer or screen) 
                      // selected during the previous prompt call. 
    } 
}

Constructors

ReportSection()
ReportSection(IntPtr)

Fields

__k_ReportSectionId
kernelClass (Inherited from XppObjectBase)

Methods

__shouldCallNew(Type) (Inherited from TreeNode)
addBitmapControl()

Adds a bitmap control to a report section.

addBoxControl()

Adds a shape control to a report section.

addBoxControl(ShapeType)
addControl(Int32, Int32, Int32)
addControl(Int32, Int32)

Adds a report control to a report section.

addDateControl(Int32, Int32)

Adds a date control to a report section.

addDateDisplayControl(String, Int32)
addDateDisplayControl(String)

Adds a date control to a report section.

addDateTimeControl(Int32, Int32)
addDateTimeDisplayControl(String, Int32)
addDateTimeDisplayControl(String)
addDisplayControl(String, Int32)
addDisplayControl(String)
addEnumControl(Int32, Int32)
addEnumDisplayControl(String, Int32)
addEnumDisplayControl(String)
addFieldGroup(Int32, String)
addGuidControl(Int32, Int32)
addGuidDisplayControl(String, Int32)
addGuidDisplayControl(String)
addInt64Control(Int32, Int32)
addInt64DisplayControl(String, Int32)
addInt64DisplayControl(String)
addIntegerControl(Int32, Int32)
addIntegerDisplayControl(String, Int32)
addIntegerDisplayControl(String)
addPromptControl(Int32, Int32)
addPromptControl(Int32)
addRealControl(Int32, Int32)
addRealDisplayControl(String, Int32)
addRealDisplayControl(String)
addSection(Int32, Int32)
addSection(Int32)
addShapeControl()
addShapeControl(ShapeType)
addStringControl(Int32, Int32)
addStringDisplayControl(String, Int32)
addStringDisplayControl(String)
addSumControl(Int32, Int32)
addSumNameControl(String)
addTextControl(String)
addTimeControl(Int32, Int32)
addTimeDisplayControl(String, Int32)
addTimeDisplayControl(String)
addXppProxyReference(Type, Object) (Inherited from XppObjectBase)
AOTadd(String) (Inherited from TreeNode)
AOTaddExtendedDataType(String, Types) (Inherited from TreeNode)
AOTaddRelation() (Inherited from TreeNode)
AOTaddSubNode(Int32) (Inherited from TreeNode)
AOTaddXref(String, xRefKind, Int32, Int32, XRefReference, Int32) (Inherited from TreeNode)
AOTaddXref(String, xRefKind, Int32, Int32, XRefReference) (Inherited from TreeNode)
AOTaddXref(String, xRefKind, Int32, Int32) (Inherited from TreeNode)
AOTAllowEdit() (Inherited from TreeNode)
AOTbitmapId()

Returns the resource ID of the bitmap of the tree node.

(Inherited from TreeNode)
AOTchildNodeCount()

Counts the number of child nodes that a given tree node has.

(Inherited from TreeNode)
AOTcompile() (Inherited from TreeNode)
AOTcompile(Int32, Boolean, Boolean) (Inherited from TreeNode)
AOTcompile(Int32, Boolean) (Inherited from TreeNode)
AOTcompile(Int32) (Inherited from TreeNode)
AOTconfigure() (Inherited from TreeNode)
AOTdelete() (Inherited from TreeNode)
AOTDrop(TreeNode, TreeNode) (Inherited from TreeNode)
AOTDrop(TreeNode)

Creates a copy of a specified tree node as a child to the TreeNode object.

(Inherited from TreeNode)
AOTDuplicate() (Inherited from TreeNode)
AOTedit()

Opens the appropriate editor for this node.

(Inherited from TreeNode)
AOTedit(Int32, Int32) (Inherited from TreeNode)
AOTedit(Int32) (Inherited from TreeNode)
AOTendXref() (Inherited from TreeNode)
AOTfindChild(String, Int32) (Inherited from TreeNode)
AOTfindChild(String)

Finds the specified child node of this node.

(Inherited from TreeNode)
AOTfirstChild()

Retrieves the first child of the tree node.

(Inherited from TreeNode)
AOTfirstChildEx() (Inherited from TreeNode)
AOTfirstChildEx(Boolean) (Inherited from TreeNode)
AOTgetExecutableLineCount()

Returns the number of executable lines of code for this node.

(Inherited from TreeNode)
AOTgetExecutableLines()

Returns the executable lines of code for this node.

(Inherited from TreeNode)
AOTGetModel() (Inherited from TreeNode)
AOTgetProperties()

Returns a string containing the properties of the tree node.

(Inherited from TreeNode)
AOTgetProperties(Boolean, Boolean, Boolean) (Inherited from TreeNode)
AOTgetProperties(Boolean, Boolean) (Inherited from TreeNode)
AOTgetProperties(Boolean) (Inherited from TreeNode)
AOTgetPropertiesExt() (Inherited from TreeNode)
AOTgetPropertiesExt(String) (Inherited from TreeNode)
AOTgetProperty(String) (Inherited from TreeNode)
AOTgetSource()

Returns the source code of this node.

(Inherited from TreeNode)
AOTIncludeInCompare() (Inherited from TreeNode)
AOTinsert(TreeNode, TreeNode, Boolean) (Inherited from TreeNode)
AOTinsert(TreeNode, TreeNode) (Inherited from TreeNode)
AOTinsert(TreeNode)

Inserts a node among the subnodes of this node.

(Inherited from TreeNode)
AOTIsDirty() (Inherited from TreeNode)
AOTIsOld()

Indicates whether this node is from a file found in the old model store.

(Inherited from TreeNode)
AOTIsPersisted()

Indicates whether this node has been persisted in the model store.

(Inherited from TreeNode)
AOTIsProxyNode() (Inherited from TreeNode)
AOTiterator()

Returns an object which can be used to iterate the child nodes of the tree node.

(Inherited from TreeNode)
AOTKernelHelpType() (Inherited from TreeNode)
AOTLayer()

Returns the layer of the tree node.

(Inherited from TreeNode)
AOTLayers()

Returns a collection of the layers the tree node is defined in.

(Inherited from TreeNode)
AOTLayers(Boolean) (Inherited from TreeNode)
AOTload()

Ensures that the object is loaded.

(Inherited from TreeNode)
AOTmakeXref()

Compiles this node and its subtree in the AOT, updating the cross-reference system.

(Inherited from TreeNode)
AOTmakeXref(Int32, Boolean) (Inherited from TreeNode)
AOTmakeXref(Int32) (Inherited from TreeNode)
AOTmessageLine(String, Int32)

Writes text to the Application Object Tree (AOT) Message window.

(Inherited from TreeNode)
AOTMove(TreeNode, TreeNode) (Inherited from TreeNode)
AOTMove(TreeNode) (Inherited from TreeNode)
AOTname()

Returns the value of the name property of the node.

(Inherited from TreeNode)
AOTnewWindow()

Opens a new AOT tree window with the tree node as the root.

(Inherited from TreeNode)
AOTnextSibling()

Returns the next node on the same level as the tree node.

(Inherited from TreeNode)
AOTObjectNode()

Indicates whether the node is an application object.

(Inherited from TreeNode)
AOToverlayBitmapId()

Returns the resource ID of the overlay in the AOT associated with this node.

(Inherited from TreeNode)
AOTparent()

Returns the parent node of the tree node.

(Inherited from TreeNode)
AOTprevious()

Returns the previous sibling of this tree node.

(Inherited from TreeNode)
AOTrefresh()

Refreshes the node with the latest changes to the .aod file.

(Inherited from TreeNode)
AOTregenerate() (Inherited from TreeNode)
AOTRename(String) (Inherited from TreeNode)
AOTrestore()

Reloads this node from the disk, if applicable.

(Inherited from TreeNode)
AOTrestore(Boolean) (Inherited from TreeNode)
AOTrun()

Compiles this node and its subtree in the Application Object Tree (AOT).

(Inherited from TreeNode)
AOTrun(xArgs) (Inherited from TreeNode)
AOTsave() (Inherited from TreeNode)
AOTSetModel(Int32) (Inherited from TreeNode)
AOTsetProperties(String) (Inherited from TreeNode)
AOTsetPropertiesExt(Struct) (Inherited from TreeNode)
AOTsetProperty(String, Object) (Inherited from TreeNode)
AOTsetSource(String, Boolean) (Inherited from TreeNode)
AOTsetSource(String) (Inherited from TreeNode)
AOTshowProperties()

Opens the property sheet (if not already open) and shows the properties for this node.

(Inherited from TreeNode)
AOTtoolTip()

Returns the tool tip associated with the tree node.

(Inherited from TreeNode)
AOTToString() (Inherited from TreeNode)
AOTtypeStr()

Returns the internal string code for the element type used in XPO files.

(Inherited from TreeNode)
AOTUtilFileType()

Retrieves the value of the UtilFileType enumeration type for the TreeNode object. The UtilFileType indicates which kind of file the application object is stored in.

(Inherited from TreeNode)
applObjectId()

Returns the application object ID, if applicable.

(Inherited from TreeNode)
applObjectLayerMask()

Returns a bitmask that specifies which layers contain this element.

(Inherited from TreeNode)
applObjectOldLayerMask()

Returns a bitmask that specifies which layers contain this element in the baseline model store.

(Inherited from TreeNode)
arrange()
arrangeMethod()
arrangeMethod(Int32)
arrangeWhen()
arrangeWhen(Int32)
autoDeclaration()

Determines whether the system can declare a member variable that has the same name as the control.

autoDeclaration(Boolean)
autoHeader()
autoHeader(Boolean)
bold()

Gets or sets the weight of font that is used to output text in the control.

bold(Int32)
bottom(Decimal, Units)
bottomMargin(Decimal, Units)
bottomMarginAndFrame()
bottomMarginMode()
bottomMarginMode(Int32)
bottomMarginStr()
bottomMarginStr(String)
bottomMarginUnit()
bottomMarginUnit(Units)
bottomMarginValue()
bottomMarginValue(Decimal)
bottomMode()
bottomMode(Int32)
bottomStr()
bottomStr(String)
bottomUnit()
bottomUnit(Units)
bottomValue()
bottomValue(Decimal)
Call(String, Object[], Type[], Object[]) (Inherited from XppObjectBase)
cancelTimeOut(Int32) (Inherited from XppObjectBase)
characterSet()

Gets or sets the character set of the font.

characterSet(Int32)
colorScheme()

Gets or sets the color scheme of the control.

colorScheme(Int32)
columnHeadingsStrategy()
columnHeadingsStrategy(Int32)
columns()
columns(Int32, ColumnsMode)
columns(Int32)
columnsMode()
columnsMode(ColumnsMode)
columnspace(Decimal, Units)
columnspaceMode()
columnspaceMode(Int32)
columnspaceStr()
columnspaceStr(String)
columnspaceUnit()
columnspaceUnit(Units)
columnspaceValue()
columnspaceValue(Decimal)
columnsValue()
columnsValue(Int32)
control(Int32, Int32)
control(Int32)

Finds a control in the section, based on the control"s table and dataField properties.

controlCount()
controlName(String)

Finds a control in a section, based on the control's Name property.

controlNo(Int32)
controlNumber()
controlNumber(Int32)
createKernelClass(Object[], Type[], Object[]) (Inherited from XppObjectBase)
delete()

Deletes the current node from the AOT.

equal(XppObjectBase) (Inherited from XppObjectBase)
executeColumnHeadings()
executeSection()

Prints the section on the report.

finalize() (Inherited from XppObjectBase)
font()

Gets or sets the name of the font for the control to use.

font(String)
fontSize()

Gets or sets the size of the font for the control to use.

fontSize(Int32)
footerText()
footerText(String)
foregroundColor()

Gets or sets the text color for the control to use.

foregroundColor(Int32)
GetIntPtr() (Inherited from XppObjectBase)
GetKernelInstanceUniqueId() (Inherited from XppObjectBase)
getNodeInLayer(UtilEntryLevel, Boolean) (Inherited from TreeNode)
getNodeInLayer(UtilEntryLevel)

Retrieves a version of the tree node from a specified layer.

(Inherited from TreeNode)
getTimeOutTimerHandle() (Inherited from XppObjectBase)
getXppProxyReference(Type) (Inherited from XppObjectBase)
grandHeader()
grandHeader(Boolean)
grandTotal()

Determines whether the FooterText property value can be displayed.

grandTotal(Boolean)
handle()
hasButtons()
hasButtons(Boolean)
hashKey() (Inherited from TreeNode)
headerDetailLevel()
headerDetailLevel(Int32, AutoMode)
headerDetailLevel(Int32)
headerDetailLevelMode()
headerDetailLevelMode(AutoMode)
headerDetailLevelValue()
headerDetailLevelValue(Int32)
headerText()
headerText(String)
height(Decimal, Units)

Gets or sets the height of the control.

height100mm()

Gets or sets the height of a section, excluding the height of the border and the top and bottom margins.

height100mm(Int32)
heightmm100()

Gets or sets the height of a section, including the height of the border and the top and bottom margins.

heightmm100(Int32)
heightMode()

Gets or sets a calculation mode for the height of the control.

heightMode(Int32)
heightStr()
heightStr(String)
heightUnit()
heightUnit(Units)
heightValue()

Gets or sets the height of the control.

heightValue(Decimal)
IsManagedValid() (Inherited from XppObjectBase)
italic()
italic(Boolean)
kernelhandle()
KernelInstanceDisposed() (Inherited from XppObjectBase)
label()

Gets the description of the section node in the AOT.

labelBottomMargin(Decimal, Units)
labelBottomMarginMode()
labelBottomMarginMode(Int32)
labelBottomMarginStr()
labelBottomMarginStr(String)
labelBottomMarginUnit()
labelBottomMarginUnit(Units)
labelBottomMarginValue()
labelBottomMarginValue(Decimal)
labelTopMargin(Decimal, Units)
labelTopMarginMode()
labelTopMarginMode(Int32)
labelTopMarginStr()
labelTopMarginStr(String)
labelTopMarginUnit()
labelTopMarginUnit(Units)
labelTopMarginValue()
labelTopMarginValue(Decimal)
leftMargin(Decimal, Units)
leftMarginMode()
leftMarginMode(Int32)
leftMarginsEtc()
leftMarginStr()
leftMarginStr(String)
leftMarginUnit()
leftMarginUnit(Units)
leftMarginValue()
leftMarginValue(Decimal)
lineAbove()
lineAbove(LineType)
lineBelow()
lineBelow(LineType)
lineLeft()

Gets or sets the type of line that is used as the left border of a section.

lineLeft(LineType)
lineRight()
lineRight(LineType)
makeCopy() (Inherited from TreeNode)
MakeReflectionCall(String, Object[]) (Inherited from XppObjectBase)
map()
map(Int32)
name()

Gets or sets the name that is used in code to identify a form, report, table, query, or another Finance and Operations application object.

name(String)
newmethod()

Initializes a new instance of the TreeNode class.

(Inherited from TreeNode)
newObjectName()

Returns a string that contains the name of the new element.

(Inherited from TreeNode)
newObjectName(String) (Inherited from TreeNode)
noOfHeadingLines()
noOfHeadingLines(Int32, AutoMode)
noOfHeadingLines(Int32)
noOfHeadingLinesMode()
noOfHeadingLinesMode(AutoMode)
noOfHeadingLinesValue()
noOfHeadingLinesValue(Int32)
notify() (Inherited from XppObjectBase)
notifyAll() (Inherited from XppObjectBase)
objectOnServer()
Obsolete.
(Inherited from XppObjectBase)
resolutionX()
resolutionX(String)
resolutionXStr(String)
resolutionXUnit()
resolutionXUnit(Units)
resolutionY()
resolutionY(String)
resolutionYStr(String)
resolutionYUnit()
resolutionYUnit(Units)
rightMargin(Decimal, Units)
rightMarginMode()
rightMarginMode(Int32)
rightMarginsEtc()
rightMarginStr()
rightMarginStr(String)
rightMarginUnit()
rightMarginUnit(Units)
rightMarginValue()
rightMarginValue(Decimal)
ruler()
ruler(Int32)
sectionGroup(Int32, Int32)
sectionGroup(Int32)

Finds an existing section group in the generated design.

sectionType()

Retrieves the type of a given report section, such as ReportBlockType::Prolog, ReportBlockType::PageHeader, or ReportBlockType::Body.

setTimeOut(String, Int32, Boolean)
Obsolete.
(Inherited from XppObjectBase)
setTimeOut(String, Int32)
Obsolete.
(Inherited from XppObjectBase)
sumDetailLevel()
sumDetailLevel(Int32, AutoMode)
sumDetailLevel(Int32)
sumDetailLevelMode()
sumDetailLevelMode(AutoMode)
sumDetailLevelValue()
sumDetailLevelValue(Int32)
table()

Gets or sets the table ID associated with the object.

table(Int32)
thickness()
thickness(LineThickness)
top(Decimal, Units)
topMargin(Decimal, Units)
topMarginAndFrame()
topMarginMode()
topMarginMode(Int32)
topMarginStr()
topMarginStr(String)
topMarginUnit()
topMarginUnit(Units)
topMarginValue()
topMarginValue(Decimal)
topMode()
topMode(Int32)
topStr()
topStr(String)
topUnit()
topUnit(Units)
topValue()
topValue(Decimal)
ToString()

Returns a string that represents the current object.

(Inherited from TreeNode)
treeNodeExport(String, Int32) (Inherited from TreeNode)
treeNodeExport(String)

Exports this node and its subtree from the Application Object Tree (AOT).

(Inherited from TreeNode)
treeNodeName()

Returns the name of the tree node.

(Inherited from TreeNode)
treeNodePath()

Returns the unique path to the tree node within the Application Object Tree (AOT).

(Inherited from TreeNode)
treeNodeRelease()

Releases the tree node explicitly.

(Inherited from TreeNode)
treeNodeType()

Retrieves an instance of a TreeNodeType class that provides reflection information for the tree node.

(Inherited from TreeNode)
underline()
underline(Boolean)
updateNodePermissions(Boolean) (Inherited from TreeNode)
usageCount() (Inherited from XppObjectBase)
utilElement()

Returns a UtilElements record that is related to the node.

(Inherited from TreeNode)
utilIdElement()

Returns a UtilIdElements record that is related to the node.

(Inherited from TreeNode)
validateNameCharacters(String) (Inherited from TreeNode)
VerifyKernelClass() (Inherited from XppObjectBase)
wait() (Inherited from XppObjectBase)
Xml() (Inherited from XppObjectBase)
Xml(Int32) (Inherited from XppObjectBase)

Applies to