Definition

Description

Use the Definition action to override the default name object of scroll buttons and the scroll parent. This is necessary, for example, when a page uses custom objects (such as links or pushbuttons) to handle conventional scroll actions such as adding or deleting rows from the scroll.

Parameters

Parameter Description

def=value;

The default name object type. Example: 

def=PARENT;

Valid def values are:

  • ADD: Overrides the Add new row button.

  • DEL: Overrides the Delete row button.

  • NEXT: Overrides the Next button.

  • PREV: Overrides the Previous button.

  • FIRST: Overrides the First button.

  • LAST: Overrides the Last button.

  • PARENT: Reassigns the parent for a specific scroll area.

type=value;

The object type for the new action.

Example 1:

type=Image;

Example 2:

type=PushButton;

value=value;

The scroll parent variable or the new object recognition string.

Example 1: 

value=&Scr1;

Example 2: 

value=Name=$ICField3$newm$0$$img$0;

start=value;

Used to set the scroll area index when the index is not $0 .

In this example the index will start the scroll index at $1.

def=START;Value=1

skipvalidation=value;

Used to skip the validation if the defined scroll has 1 or multiple rows in the scroll when the user deletes or adds a row to it.

PTF handles scroll validation assuming the new row is added to the bottom of the scroll area. There are many cases where the row is added as the top row which will cause the PTF internal scroll validation to fail after the row is inserted. Use the SKIPVALIDATION to handle this situation.

Example 1:

This example will skip the validation when a single row is inserted or deleted from the scroll area.

def=SKIPVALIDATION;type=SINGLE_ROW

Example 2:

This example will skip the validation if multiple rows have been inserted or deleted from the scroll area.

def=SKIPVALIDATION;type=MULTIPLE_ROW

Examples

This example uses the Definition action with the def=ADD parameter to assign the Add action to the image $ICField3$newm$0$$mg$0:

Type Action Recognition Parameters Value

Scroll

Definition

value=Name=$ICField3$newm$0$$mg$0

def=ADD;type=Image

In this example the Definition action with a def=PARENT parameter reassigns the parent:

Scroll ID Type Action Recognition Parameters Value

1

Scroll

Key_Set

Name=PSU_EMP_REVIEW_REVIEW_YEAR

type=Text

2009

1

Scroll

Action

ret=&Scr1

upd

Text

Set_Value

Name=PSU_EMP_REVIEW_REVIEW_DAYS&Scr1

Scroll 1 index variable = &Scroll1

365

2

Scroll

Definition

value=&Scr1

def=PARENT;type=Button

2

Scroll

Key_Set

Name=PSU_EMP_RVW_RVR_REVIEWER_ID

type=ComboBox

00013

2

Scroll

Action

  

ret=&Scr2

upd

ComboBox

Set_Value

Name=PSU_EMP_RVW_RVR_REVIEWER_TYPE&Scr2

S