IMLangCodePages  Interface

IID_IMLangCodePages

{359F3443-BD4A-11D0-B188-00AA0038C969}

This interface provides the foundation of the IMLangFontLink interface and implements methods for working with code pages.

Remarks

This interface defines a set of code pages and implements a number of methods for working with those code pages. IMLangCodePages contains methods to translate between individual code page identifier values and sets of code pages. Also it provides methods that determine which code pages contain a given Unicode character or string. Because IMLangFontLink inherits from IMLangCodePages, every IMLangCodePages method is available through the IMLangFontLink interface.

Crucial to the IMLangCodePages interface is the concept of a set of code pages. A DWORD is used to represent a set of code pages, and each bit in the DWORD represents a specific code page.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IMLangCodePages Methods

Description

GetCharCodePages

Retrieves the set of code pages to which the given Unicode character belongs.

GetStrCodePages

Retrieves the set of code pages to which the Unicode characters in the given string belong.

CodePageToCodePages

Translates the given code page identifier value into the corresponding entry in a set of code pages.

CodePagesToCodePage

Retrieves the identifier value for a code page in the given set of code pages.

GetCharCodePages

FUNCTION IMLangCodePages_GetCharCodePages ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL chSrc AS DWORD _
, BYREF pdwCodepages AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[3] USING IMLangCodePages_GetCharCodePages (pthis, chSrc, pdwCodepages) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION
 

GetStrCodePages

FUNCTION IMLangCodePages_GetStrCodePages ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pszSrc AS DWORD _
, BYVAL cchSrc AS LONG _
, BYVAL dwPriorityCodePages AS DWORD _
, BYREF pdwCodepages AS DWORD _
, BYREF pcchCodePages AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[4] USING IMLangCodePages_GetStrCodePages (pthis, pszSrc, cchSrc, dwPriorityCodePages, pdwCodePages, pcchCodePages) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION

CodePageToCodePages

FUNCTION IMLangCodePages_CodePageToCodePages ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL uCodePage AS DWORD _
, BYREF pdwCodepages AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[5] USING IMLangCodePages_CodePageToCodePages (pthis, uCodePage, pdwCodePages) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION

CodePagesToCodePage

FUNCTION IMLangCodePages_CodePagesToCodePage ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL dwCodePages AS DWORD _
, BYVAL uDefaultCodePage AS DWORD _
, BYREF puCodePage AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[6] USING IMLangCodePages_CodePagesToCodePage (pthis, dwCodePages, uDefaultCodePage, puCodePage) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION