ScriptApplyDigitSubstitution (Compact 2013)

3/28/2014

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/regional 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

See Also

Reference

Uniscribe Functions
ScriptRecordDigitSubstitution
SCRIPT_DIGITSUBSTITUTE
SCRIPT_CONTROL
SCRIPT_STATE

  • Last updated on