VECTORENUMOBJECTSPROC Function

#include "lvkrn.h"

L_INT pEXT_CALLBACK YourFunction (pVector, pObject, pUserData)

pVECTORHANDLE pVector;

/* pointer to a vector handle */

pVECTOROBJECT pObject;

/* pointer to a vector Object */

L_VOID L_FAR * pUserData;

/* pointer to additional parameters */

Processes each vector object enumerated by the L_VecEnumObjects or L_VecEnumObjectsInLayer functions.

Parameter

Description

pVector

Pointer to the vector image containing the objects to enumerate.

PObject

Pointer to the vector object being processed.

pUserData

A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of the calling function.)

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The L_VecEnumObjects function or the L_VecEnumObjectsInLayer function calls your callback function as it gets the handle of each vector object.

Required DLLs and Libraries

LVKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_VecEnumObjects, L_VecEnumObjectsInLayer

Example

For an example, refer to L_VecEnumObjects.