Using Frame Control on Studio Reports

Applies to: Kyvos Reporting

You can use the Frame control in Kyvos Reporting Studio to group multiple controls visually and manage their collective properties such as visibility. A frame can be placed in any report section and supports conditional display using scripting.

Placing a Frame Control

To place a frame control on the report canvas:

Open the target report in Kyvos Reporting Studio.
On the menu bar, go to Insert > Frame or click the Frame tool button on the toolbar.
The mouse pointer changes to a crosshair. Drag from the top-left to the bottom-right area where you want to place the frame.

Once placed, the frame’s properties appear in the Properties pane and can be modified as required.

Adding Controls to a Frame

You can drag fields and supported controls onto the frame from the Fields list or toolbar. The following controls can be added inside a frame:

Label
Field
Checkbox
Image
Line
Shape

Note

You cannot place chart, crosstab, page break, sub-report, barcode, or databar inside a frame.

Each control inside a frame can be individually selected and configured using the Properties pane.

Using Frames for Conditional Display

Frames can help manage conditional visibility of grouped content. For example, you can display different field sets based on a parameter input.

Example Scenario

Create a character-type parameter named UserType.
In the Detail section:
- Add Frame A, and place ProductID, ProductName, and Sales_92 inside it.
- Add Frame B, and place ProductName, Sales_92, and Sales_93 inside it.
On the OnFormat event of the Detail section, use the following script:

FrameA.Visible = false;
FrameB.Visible = false;
if (UserType == "A") {
    FrameA.Visible = true;
}
if (UserType == "B") {
    FrameB.Visible = true;
}

When the report is run:

The Input Parameter Form prompts the user to enter a value for UserType.
If the value is "A", only Frame A is shown.
If the value is "B", only Frame B is shown.

Scripting for Frames

You can control the visibility of frames dynamically during report execution using scripting. This allows you to conditionally display grouped fields based on parameter values or runtime logic.

Example Requirement

If UserType is A, display ProductID, ProductName, and Sales_92.
If UserType is B, display ProductName, Sales_92, and Sales_93.

Use two frames (Frame A and Frame B), and implement the logic in the OnFormat event of the section, as demonstrated above.