Finds the first user data pair from the list of key value pairs for the existing element.
Visual Basic |
---|
Public Sub ElementUserDataFindFirst( _ ByVal elementHandle As Long, _ ByRef pKey As String, _ ByRef pValue As String _ ) |
- elementHandle
- The handle of an element returned by the ElementCreate method.
- pKey
- The address of a string to receive the first key from the list of key value pairs.
- pValue
- The address of a string to receive the first value from the list of key value pairs.
Element User Data is two text fields called key and value (a map). These are allocated by each element and reserved for use by the application to store a private key value pair to associate to an element.
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