VECTORFONTMAPPERCALLBACK Function

#include "lvkrn.h"

L_INT pEXT_CALLBACK YourFunction (pVector, pFont, pUserData)

pVECTORHANDLE pVector;

/* pointer to a vector handle */

LPLOGFONTW pFont;

/* pointer to LOGFONTW structure */

L_VOID * pUserData;

/* pointer to additional parameters */

Processes each new font that is added to the resource list of the vector drawing.

Parameter

Description

pVector

Pointer to the vector handle to which the font is being added.

pFont

Pointer to a LOGFONTW structure. The user can modify the contents of this structure to control the attributes of the font before adding/using it in the drawing.

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

Thte L_VecSetFontMapper function calls your callback function for every font being added to the vector handle.

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_VecSetFontMapper, L_VecGetFontMapper

Example

L_INT WINAPI myFontMapper1( pVECTORHANDLE pVector, LPLOGFONT pLogFont, L_VOID* pUserData )
{
   UNREFERENCED_PARAMETER( pVector );
   UNREFERENCED_PARAMETER( pLogFont );
   UNREFERENCED_PARAMETER( pUserData );

   /* pUserData points to "Arial" .. copy it to pLogFont->lfFaceName to force the toolkit
      to render all fonts as Arial */
   lstrcpy( pLogFont->lfFaceName, (L_TCHAR *)pUserData );

   return SUCCESS;
}

L_INT  VectorFontMappercallBackExample(pVECTORHANDLE pVector )
{
   L_INT nRet;
   nRet = L_VecSetFontMapper( pVector, myFontMapper1, TEXT("Arial"));
   return nRet;
}