Get(ActivePortalRowNumber)

Returns a number representing the portal row that has the focus.

Format 

Get ( ActivePortalRowNumber )

Parameters 

None

Data type returned 

number

Originated in version 

6.0 or earlier

Description 

When no portal row contains the focus, this function returns 0. If there are multiple windows open in the current file, each window can have its own portal row number value, but results are returned for only the foreground window. If a user navigates to a portal without selecting a specific portal row and without making an object active within a specific portal row, Get(ActivePortalRowNumber) returns row 0 rather than row 1.

Notes 

  • If a field on a layout is defined as Get(ActivePortalRowNumber), the window must be refreshed before the field will display the current portal row number.

Example 1 

Returns 5 when the fifth row of a portal has the focus, or when the focus is in a field in the fifth portal row.

Returns 1 after the Go to Portal Row [Select: Off ; First] script step runs.

Returns 0 when a portal is not selected.

Related topics