ScriptApplyDigitSubstitution function (usp10.h)

Applies the specified digit substitution settings to the specified script control and script state structures.

Syntax

HRESULT ScriptApplyDigitSubstitution(
  [in]  const SCRIPT_DIGITSUBSTITUTE *psds,
  [out] SCRIPT_CONTROL               *psc,
  [out] SCRIPT_STATE                 *pss
);

Parameters

[in] psds

Pointer to a SCRIPT_DIGITSUBSTITUTE structure. The application sets this parameter to NULL if the function is to call ScriptRecordDigitSubstitution with LOCALE_USER_DEFAULT.

[out] psc

Pointer to a SCRIPT_CONTROL structure with the fContextDigits and uDefaultLanguage members updated.

[out] pss

Pointer to a SCRIPT_STATE structure with the fDigitSubstitute member updated.

Return value

Returns S_OK if successful. The function returns a nonzero HRESULT value if it does not succeed.

The function returns E_INVALIDARG if it does not recognize the DigitSubstitute member of SCRIPT_DIGITSUBSTITUTE.

Remarks

This function does not actually substitute digits. It just fills in the structures that describe the digit substitution policy. See Displaying Text with Uniscribe for a discussion of the context in which this function is normally called.

Requirements

See also

Digit Shapes

Displaying Text with Uniscribe

SCRIPT_CONTROL

SCRIPT_DIGITSUBSTITUTE

SCRIPT_STATE

ScriptRecordDigitSubstitution

Uniscribe

Uniscribe Functions