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

---

~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

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

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

• None

• None

• None

• None