Use the nested class IWindow::ChildCursor to iterate over the children of any window. The library accesses the children in Z-order, from top to bottom.
Constructors & DestructorYou can construct and destruct objects of the IWindow::ChildCursor class. You cannot copy or assign IWindow::ChildCursor objects because both the copy constructor and the assignment operator are private functions.
![]() |
public:
virtual ~ChildCursor()
| IAccessError | The operating system failed to deallocate resources used by the cursor. |
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
ChildCursor( IWindow& parent, bool onlyIWindowChildren = false )
Constructs objects of the IWindow::ChildCursor class. You can use the resulting object to enumerate the child windows of the specified window by using this object with IWindow::childAt.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Cursor MovementUse these members to control cursor movement.
![]() |
public:
virtual bool setToFirst()
Resets the cursor position to the first child window (in Z-order).
| IAccessError | The operating system failed to allocate resources for the cursor; possible invalid window handle. |
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
virtual bool setToNext()
Advances the cursor position to the next child window (in Z-order).
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Cursor ValidationUse these members to query or set the validity of the cursor.
![]() |
public:
virtual void invalidate()
Marks the cursor as invalid.
| IAccessError | The operating system failed to deallocate resources used by the cursor. |
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
virtual bool isValid() const
If the cursor is in a valid area, true is returned. Otherwise, false is returned.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |