NextPreferenceGroup()

Syntax

Result = NextPreferenceGroup()
Description
Retrieves information about the next group found in the enumeration started with ExaminePreferenceGroups(). To get the name of the group, use PreferenceGroupName(). The current examined preference group will also be used when values are read from the preferences or when the keys are examined with ExaminePreferenceKeys().

Parameters

None.

Return value

Nonzero if more groups are available in the current enumeration, zero otherwise.

Example

  ; Open a preference file
  OpenPreferences(#PB_Compiler_Home +"Examples\Sources\Data\test.pref")
  
  ; Examine groups
  ExaminePreferenceGroups()
  While NextPreferenceGroup() ; While group exists
    MessageRequester("Groups", PreferenceGroupName())  ; Display this group
  Wend
  
  ; Close the preference file
  ClosePreferences() 

See Also

ExaminePreferenceGroups(), PreferenceGroupName(), ExaminePreferenceKeys()

Supported OS

All

<- FlushPreferenceBuffers() - Preference Index - NextPreferenceKey() ->