GrpUserDataFindNext Method

Description

Finds the next user data pair from the list of key value pairs for the specific group.

Syntax

Visual Basic
Public Sub GrpUserDataFindNext( _ ByVal layerHandle As Long, _ ByVal groupID As Long, _ ByRef pKey As String, _ ByRef pValue As String _ )

Parameters

layerHandle: The handle of a layer returned by the CreateLayer method.
groupID: The handle of a group returned by the GrpCreateGroup method.
pKey: The address of a string to receive the next key from the list of key value pairs.
pValue: The address of a string to receive the next value from the list of key value pairs.

Remarks

Group User Data is two text fields called key and value (a map). These are allocated by each group and reserved for use by the application to store a private key value pair to associate to a group.

User data can be programmatically modified or added via the NX_XML file format

User data may be associated with an element, group, layer, or page