Subfile Scroller

axSubfileScroller

Description

axSubfileScroller allows a subfile scrolling control to be inserted into the 5250 screen.

Usability

Context	Supported
Input screen fields	No
Output screen fields	No
Input subfile fields	No
Output subfile fields	No
New screen elements	Yes

Properties

Name	Description and Comments	JavaScript	Shipped default
enabled	Indicates whether this element is enabled. TS2 only.	Yes. Must return a Boolean.	True
markerFieldName	The name of the field that contains the string that indicates the subfile extends to another page	No	Blank
pgDnImagePath	Path to locate the page down image file	No	/ts/skins/images
pgDnImageName	Name of the page down image file	No	pagedown.gif
pgUpImageName	Name of the page up image file	No	pageup.gif
pgUpImagePath	Path to locate the page up image file	No	/ts/skins/images
pgUpOnClick	Event that fires when clicking on page up.	Yes	SENDKEY("PageUp");
pgDnOnClick	Event that fires when clicking on page down.	Yes	SENDKEY("PageDown");
scrollMarkers	List of strings that indicates that the subfile extends to another page	No	"+", "More..."
style	CSS to apply to the subfile scrolling buttons.	No	Height = 17px Width = 17px

Examples

Insert subfile scroll buttons into the Maintain Employee Information screen of the aXes Demo HR system.

Step 1: Open the Projects Home Page. Select your project and then use the Work as Developer option and sign on to a 5250 session.

Step 2: Start the shipped aXes demo system by entering the commands:

ADDLIBLE AXESDEMO

CALL XHRRPGTRN

The resulting 5250 screen should look like this:

Step 3: Start editing the screen and click on the "+" sign and name that field PageMarker.

Step 4: Add an axSubfileScroller eXtension.

This is done by adding a new element to the screen.

Make it into a Subfile Scroller by checking that option.

Change the scroller's markerFieldName property to "PageMarker".

Then move and position the scroller as required.

Step 5: Select the PageMarker field and uncheck its Default Visualization option so that its contents no longer appear.

Save your changes.

The modified screen should look like this:

Change Scroller Button Images

This example assumes that anaxSubfileScroller eXtension has been added to an aXes screen as in the previous example.

Step 1: Open the Projects Home Page. Selectyour project and then use the Work as Developer option and sign on to a 5250 session.

Step 2: Start the shipped aXes demo systemby entering the commands:

ADDLIBLE AXESDEMO

CALL XHRRPGTRN

Step 3: Start editing the screen and click on the Subfile Scroller eXtension to highlight it and bring up its properties into the aXes Designer window.

Step 4: Click on and change the pgUpImageName property to movepageup.jpg. Then click on and change the pgDnImageName property to movepagedown.jpg.

Step 5: Click on the style property and change the height and width style attributes so that the scroller buttons will be large enough to display the new images. Use 22px for each attribute.

Save your changes.

The modified screen should look like this:

The display of the Up and Down button will change based on the theme set in Application->Styling->appStylesTheme property. When JQueryUI is selected, the Up and Down button will be displayed as a JQuery themeable button and the style will depend on the JQuery theme that is set inthe Application->Styling->jqueryTheme property. It is the same as when Material Design is selected, the buttons will be displayed as Material Design theme set in mdTheme property.