IMLangFontLink::MapFont

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method creates a font to output the characters from the given set of code pages.

Syntax

HRESULT MapFont( 
  HDC hDC,
  DWORD dwCodePages,
  HFONT hSrcFont,
  HFONT* phDestFont
);

Parameters

• hDC
  [in] Handle to a device context.

• dwCodePages
  [in] Specifies the source set of code pages.

• hSrcFont
  [in] Handle to the source font object from which the font object pointed to by the phDestFont parameter will be inherited.

• phDestFont
  [out] Pointer to a font object where the created font will be returned.

Return Value

Returns S_OK if successful or an error value otherwise.

Remarks

MLang implements a font cache to store the custom fonts created by this method. When a client has finished using a font created by this method, it should call to remove the font object from the cache.

Requirements