LayoutAction Property

Visual Basic
C#

'Declaration
 
Public Property LayoutAction As LayoutAction

public LayoutAction LayoutAction {get; set;}

Property Value

Current layout action. The default is LayoutAction.MoveLayout | LayoutAction.NextRecord | LayoutAction.PrintSection, which returns a value of 7.

PrintSection has a value of 1.
MoveLayout has a value of 2.
NextRecord has a value of 4.

ActiveReports automatically performs the following actions for each record in the data source after each Detail section format:

Prints the section.
Moves the layout (sets the next print position for the rest of the report).
Moves to the next record.

The LayoutAction property allows you to control which of these steps should be performed or omitted. Using a combination of layout actions when the report is executed can change a report's layout.

This property can be used only in the Detail section's Format event.

The following table shows the results of different combinations of LayoutActions

Value	Print	Layout	NextR	Description
7	True	True	True	(Default) Move to next print location, get next record, and print data.
3	True	True	False	Move to the next print location, don't advance to the next record, but print the data.
4	False	False	True	Skip a record without leaving a blank space on the page.
6	False	True	True	Skip a record and leave a blank space on the page.
2	False	True	False	Leave a blank space without skipping a record.
5	True	False	True	Print the next record on top of the current record (UnderlayNext).

C#

int counter=0; 
private void detail_Format(object sender, System.EventArgs eArgs)
{
    //repeat each row five times
    counter = counter + 1; 
    if (counter <= 4) 
    { 
        this.LayoutAction =  LayoutAction.MoveLayout|LayoutAction.PrintSection; 
    } 
    else 
    { 
        this.LayoutAction = LayoutAction.MoveLayout|LayoutAction.NextRecord|LayoutAction.PrintSection; 
        counter = 0; 
    }
}

Visual Basic

Private Sub Detail1_Format(ByVal sender As Object, ByVal e As System.EventArgs) Handles Detail1.Format
    'repeat each row five times
    Static counter As Integer
    counter = counter + 1
    If counter <= 4 Then
        Me.LayoutAction = 3
    Else
        Me.LayoutAction = 7
        counter = 0
    End If
End Sub

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ActiveReport Class
ActiveReport Members
Format Event
LayoutAction Enumeration