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

~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

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.

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

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.

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

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

  - None

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None