How to Use The Top Banner

 

Overview

The Top Banner feature is a unique section in the top of the screen where you can display a text that is not part of the question’s text. This text can be displayed in any color, as well as the Top Banner background.

The Top Banner, once defined and activated, is displayed on all screens, and can be changed or disabled in any stage of the interview.

 

Step 1: Enable the Top Panel property 

Go to the Survey Properties tab, and enable the “show top panel” property:

Step 2: Activate the Top Banner

To view the Top Banner on screen, its “Visible” property must be set to ‘true’:

You decide when you want the Top Banner to appear. From the point you set it to ‘true’ – it will be displayed on all following screens.

 

Step 3: Define and Use the Top Banner Properties

After enabling the Top Banner, you can customize its appearance by setting the displayed text and defining the text and background colors.

Set the Top Banner Text

Assign the text you want to display using the Text property.

TopBanner.Text = CurrChapter.Name 

Set the Top Banner Colors

You can customize both the text color and the background color of the Top Banner.

To create a color, use the following function:

CreateRGBColor(red, green, blue)

The function accepts three values representing the Red, Green, and Blue (RGB) color components. Each value must be between 0 and 255.

It returns an RGB color value that can be assigned to the Top Banner properties.

Set the Text Color

Create the desired RGB color and assign it to the ARGBColor property.

For example, the following configuration sets the banner text color to blue.

TopBanner.ARGBColor = dblColorFromRGB(1,1,1);

Image Reference: Top Banner with blue text.

Set the Background Color

Create the desired RGB color and assign it to the ARGBBackColor property.

For example, the following configuration sets the banner background to a light blue shade.

TopBanner.ARGBBackColor = dblColorFromRGB (255,0,0)

Image Reference: Top Banner with a light blue background.

Combining all settings above, the Top Banner will appear like this: