MLang Objects

Objects

Code Page Enumeration

Conversion

Locale Enumeration

Multilanguage

Script Enumeration

Code Page Enumeration Object

Retrieves a list of all the code pages the system recognizes.

Remarks

The Code Page Enumeration object maintains the position of the client in the enumeration sequence. This position is advanced or reset by calls to IEnumCodePage interface methods.

Creation/Access Functions

IMultiLanguage::EnumCodePages

Interfaces Implemented

IEnumCodePage

Object Information

Stock Implementation	mlang.dll
Custom Implementation	No
Header and IDL files	mlang.h, mlang.idl
CLSID	Not available
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows 95, Windows NT 4.0, Windows CE 2.12

Conversion Object

A conversion engine dedicated to a specified combination of source and destination code pages.

Remarks

To avoid creating and deleting many instances of the Conversion object, callers can reinitialize an object whenever a change in code pages is needed.

A client should use this object to perform a number of conversions between the same two code pages.

Creation/Access Functions

CoCreateInstance	Call CoCreateInstance setting the CLSID parameter to CLSID_CMLangConvertCharset.
IMultiLanguage::CreateConvertCharset

Interfaces Implemented

IMLangConvertCharset

Object Information

Stock Implementation	mlang.dll
Custom Implementation	No
Header and IDL files	mlang.h, mlang.idl
CLSID	CLSID_CMLangConvertCharset
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows 95, Windows NT 4.0, Windows CE 2.12

Locale Enumeration Object

Retrieves a sequence of RFC1766INFO structures.

Remarks

The Locale Enumeration object maintains the position of the client in the enumeration sequence of RFC1766INFO structures. This position is advanced or reset by calls to IEnumRfc1766 interface methods.

Creation/Access Functions

IMultiLanguage::EnumRfc1766

Interfaces Implemented

IEnumRfc1766

Object Information

Stock Implementation	mlang.dll
Custom Implementation	No
Header and IDL files	mlang.h, mlang.idl
CLSID	Not available
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows 95, Windows NT 4.0, Windows CE 2.12

MultiLanguage Object

Provides access to all other objects and interfaces implemented by MLang. The MultiLanguage object is the primary MLang object.

Remarks

The MultiLanguage object supports four interfaces that provide the following services.

• Retrieving code page and locale information from the registry.

• Converting between different code pages.

• Determining the code pages to which a given character or set of characters belongs.

• Creating custom fonts to display characters from multiple code pages.

• Determining where a line break should occur based on the given locale.

In addition, the MultiLanguage object provides access to the Code Page Enumeration Object, the Locale Enumeration Object, and the Conversion Object, each of which provides a specialized set of services to the client.

 

Creation/Access Functions

CoCreateInstance

Call CoCreateInstance setting the CLSID parameter to CLSID_CMultiLanguage.

Interfaces Implemented

IMLangCodePages

IMLangFontLink

IMLangFontLink2

IMLangLineBreakConsole

IMultiLanguage

IMultiLanguage2

Object Information

Stock Implementation	mlang.dll
Custom Implementation	No
Header and IDL files	mlang.h, mlang.idl
CLSID	CLSID_CMultiLanguage
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows 95, Windows NT 4.0, Windows CE 2.12

Script Enumeration Object

Retrieves a list of all the scripts on the system.

Remarks

Use IMultiLanguage2::EnumScripts to retrieve an IEnumScript interface pointer, and then use IEnumScript methods such as IEnumScript::Next and IEnumScript::Skip to enumerate the scripts.

Creation/Access Functions

IMultiLanguage2::EnumScripts

Interfaces Implemented

IEnumScript

Object Information

Stock Implementation	mlang.dll
Custom Implementation	No
Header and IDL files	mlang.h, mlang.idl
CLSID	Not available
Minimum availability	Internet Explorer 4.0
Minimum operating systems	Windows 95, Windows NT 4.0, Windows CE 2.12