IWindow::ChildCursor

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.


IWindow::ChildCursor - Member Functions and Data by Group

Constructors & Destructor

You 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.


[view class]
~ChildCursor
public:
virtual ~ChildCursor()

Exception

IAccessError The operating system failed to deallocate resources used by the cursor.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
ChildCursor
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.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Cursor Movement

Use these members to control cursor movement.


[view class]
setToFirst
public:
virtual bool setToFirst()

Resets the cursor position to the first child window (in Z-order).

Exception

IAccessError The operating system failed to allocate resources for the cursor; possible invalid window handle.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
setToNext
public:
virtual bool setToNext()

Advances the cursor position to the next child window (in Z-order).

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Cursor Validation

Use these members to query or set the validity of the cursor.


[view class]
invalidate
public:
virtual void invalidate()

Marks the cursor as invalid.

Exception

IAccessError The operating system failed to deallocate resources used by the cursor.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
isValid
public:
virtual bool isValid() const

If the cursor is in a valid area, true is returned. Otherwise, false is returned.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


IWindow::ChildCursor - Inherited Member Functions and Data

Inherited Public Functions

Inherited Public Data

Inherited Protected Functions

Inherited Protected Data