L_CreateMarkers
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_CreateMarkers(phMarkers)
HANDLE L_FAR * phMarkers; |
/* pointer to a marker handle */ |
Creates an empty marker collection.
Parameter |
Description |
phMarkers |
Pointer to a variable to be updated with a handle to an empty marker collection. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Markers can be added to the collection using L_InsertMarker function.
When the marker collection handle is no longer needed, free it by calling L_FreeMarkers.
Required DLLs and Libraries
LTFIL For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Platforms
Windows 95 / 98 / Me, Windows 2000 / XP.
See Also
Functions: |
L_LoadMarkers, L_FreeMarkers, L_InsertMarker, L_EnumMarkers, L_GetMarkerCount, L_GetMarker |
Topics: |
|
|
Example
L_INT EXT_CALLBACK MyCopyCallback(L_UINT uMarker, L_UINT uMarkerSize, L_VOID L_FAR * pMarkerData, L_VOID L_FAR * pUserData, LEADMARKERCALLBACK pfnLEADCallback, L_VOID L_FAR * pLEADUserData)
{
// is it a APPn marker?
if(uMarker >= 0xE0 && uMarker < 0xF0)
{
// just insert all the markers in the destination collection list
// L_InsertMarker will never return SUCCESS_IGNOREMARKER, so the source collection list will not be changed.
return L_InsertMarker(*(HANDLE L_FAR*)pLEADUserData, 0xFFFFFFFF, uMarker, uMarkerSize, pLEADUserData);
}
return SUCCESS;
}
// This example will copy all APPn markers from one marker collection to another
L_INT CopyMarkers(HANDLE hSrcMarkers, HANDLE L_FAR*phDstMarkers)
{
L_INT nRet;
nRet = L_CreateMarkers(phDstMarkers);
if(nRet != SUCCESS)
return nRet;
// copy the APPn markers from hSrcMarkers
nRet = L_EnumMarkers(hSrcMarkers, 0, MyCopyCallback, (L_VOID L_FAR*)phDstMarkers);
if(nRet != SUCCESS)
{
// An error occurred. Free the marker list we have created
L_FreeMarkers(*phDstMarkers);
*phDstMarkers = NULL;
}
return nRet;
}