Share via

ScriptApplyDigitSubstitution (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function applies the digit substitution settings recorded in a SCRIPT_DIGITSUBSTITUTE structure to the SCRIPT_CONTROL and SCRIPT_STATE structures.

Syntax

HRESULT WINAPI ScriptApplyDigitSubstitution(
  const SCRIPT_DIGITSUBSTITUTE* psds, 
  SCRIPT_CONTROL* psc, 
  SCRIPT_STATE* pss
);

Parameters

  • psc
    [out] Pointer to a SCRIPT_CONTROL structure. When this function returns, the fContextDigits and uDefaultLanguage members are updated.
  • pss
    [out] Pointer to a SCRIPT_STATE structure. When this function returns, the fDigitSubstitute member will be updated.

Return Value

If the function succeeds, it returns S_OK.

If the DigitSubstitute member of the SCRIPT_DIGITSUBSTITUTE structure is unrecognized, the function returns E_INVALIDARG. If any other unrecoverable error is encountered, it is returned as an HRESULT.

Remarks

The DigitSubstitute member of SCRIPT_DIGITSUBSTITUTE structure is normally set by ScriptRecordDigitSubstitution. However, it may be replaced by any one of the following values:

Value Description

SCRIPT_DIGITSUBSTITUTE_CONTEXT

Digits U+0030 to U+0039 are substituted using the language of the prior letters. If there are no prior letters, digits are substituted using the TraditionalDigitLanguage member of the SCRIPT_DIGITSUBSTITUTE structure. This member is normally set to the primary language of the locale passed to ScriptRecordDigitSubstitution.

SCRIPT_DIGITSUBSTITUTE_NATIONAL

Digits U+0030 to U+0039 are substituted using the NationalDigitLanguage member of the SCRIPT_DIGITSUBSTITUTE structure. This member is normally set to the national digits returned for the NLS LCTYPE LOCALE_SNATIVEDIGITS by ScriptRecordDigitSubstitution.

SCRIPT_DIGITSUBSTITUTE_NONE

Digits are not substituted. Unicode values U+0030 to U+0039 are displayed with Arabic, that is Western, numerals.

SCRIPT_DIGITSUBSTITUTE_TRADITIONAL

Digits U+0030 to U+0039 are substituted using the TraditionalDigitLanguage member of the SCRIPT_DIGITSUBSTITUTE structure. This member is normally set to the primary language of the locale passed to ScriptRecordDigitSubstitution.

Requirements

Header usp10.h
Library Uspce.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

ScriptRecordDigitSubstitution
SCRIPT_DIGITSUBSTITUTE
SCRIPT_CONTROL
SCRIPT_STATE

Other Resources

Uniscribe Functions