### ITabControl::Cursor

  The nested class ITabControl::Cursor defines objects that you can use to iterate through the pages of a tab control. In the same way that you can use a cursor to iterate through the objects in a collection, you can use this cursor object to iterate through a tab control, one ITabPage at a time.

#### AIX Considerations

  This class is not supported in the AIX environment.

### ITabControl::Cursor - Member Functions and Data by Group

### Constructors & Destructor

~Cursor

      public:
      virtual ~Cursor()

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

Cursor

      public:
      Cursor(const ITabControl& tabControl)

  Create objects of this nested class by specifying a tab control. Use the cursor to iterate through the ITabPage objects that are currently added to the specified tab control.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

### Tab Page Iteration

Use these members to iterate through the ITabPage objects that are currently added to the tab control.

invalidate

      public:
      virtual void invalidate()

  Flags this cursor as not valid.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

isValid

      public:
      virtual bool isValid() const

  Queries whether the cursor points to a valid ITabPage and returns true if it does.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

setCurrent

      public:
      void setCurrent(const ITabPage* current)

  Sets the cursor to point to the specified ITabPage in the tab control.

Exception

  IInvalidParameter | currentmust be a nonzero pointer.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

setToFirst

      public:
      virtual bool setToFirst()

  Sets the cursor to point to the first ITabPage in the tab control.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

setToLast

      public:
      virtual bool setToLast()

  Sets the cursor to point to the last ITabPage in the tab control.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

setToNext

      public:
      virtual bool setToNext()

  Sets the cursor to point to the next ITabPage in the tab control. The cursor is invalidated if it was already positioned to the last ITabPage in the tab control.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

setToPrevious

      public:
      virtual bool setToPrevious()

  Sets the cursor to point to the previous ITabPage in the tab control. The cursor is invalidated if it was already positioned to the first ITabPage in the tab control.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

### Tab Page Retrieval

Use these members to retrieve the ITabPage objects that are currently added to the tab control.

current

      public:
      virtual ITabPage* current() const

  Returns a pointer to the ITabPage at the current cursor position or 0 if the cursor is invalid.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

### ITabControl::Cursor - Inherited Member Functions and Data

#### Inherited Public Functions

  - None

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None