The IProfile::Cursor class creates and manages the cursor for an IProfile object. IProfile uses this cursor to iterate through the application names or keys in a profile. In the same way that you can use a cursor to iterate through the objects in a collection, you can use this cursor to iterate through a profile one item at a time.
Constructors & DestructorUse these members to construct and destruct objects of this nested class. You can construct objects of this class by using a reference to the profile, or a reference to the profile data and an application name.
![]() |
public:
virtual ~Cursor()
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
Cursor(IProfile& profile, const char* applName)
You can construct an object of this class by using a reference to the profile and an application name. Use this constructor to create a cursor to iterate through the keys.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
public:
Cursor(IProfile& profile)
You can construct an object of this class by using a reference to the profile. Use this constructor to create a cursor to iterate through the application names.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
Profile IterationUse these members to iterate through the application names or keys in a profile.
![]() |
public:
virtual void invalidate()
Marks the cursor as invalid.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
virtual bool isValid(bool checkFile = false) const
Determines if the cursor is still valid. If the cursor is valid, true is returned. If the parameter, checkFile, is set to true, this function checks to see if the data set's application and key information has been changed by another application while your application still has the data set open.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
AIX does not support checkFile.
If checkFile is set to true, this function determines whether the file application and key information have been changed by another application while your application still has them open.
![]() |
public:
virtual bool setToFirst()
Sets the cursor's position to the first application or key.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
virtual bool setToLast()
Sets the cursor's position to the last application or key.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
virtual bool setToNext()
Sets the cursor's position to the next application or key.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |
![]() |
public:
virtual bool setToPrevious()
Set the cursor's position to the previous application or key.
| Windows | OS/2 | AIX |
| Yes | Yes | Yes |