FocusPageObjectHandle

 

Type

 

ObjectHandle

 

Description

 

This is the ObjectHandle for the page currently containing the UI focus. This UI focus page is the page that receives user keystrokes, such as scrolling keys or Form data entry.

 

Example

 

REM Get the ObjectHandle of the current UI focus page:

focusObjectHandle = WebsterPro1.FocusPageObjectHandle

 

Remarks

 

Normally, this ObjectHandle is identical to PageObjectHandle. There are two circumstances under which they are different:

 

  1. If the current page is a FRAMESET and one of it’s FRAME pages has UI focus then FocusObjectHandle is the ObjectHandle of the FRAME page that currently has the UI focus, while PageObjectHandle identifies the top FRAMESET page.

  2. If the current active page is still pending then FocusObjectHandle is the ObjectHandle of the page which currently has the UI focus, while PageObjectHandle identifies the logically current (but not yet visible) page

 

The FocusPageChange event is fired every time FocusObjectHandle changes.