Método StringFormat::SetDigitSubstitution (gdiplusstringformat.h)

O método StringFormat::SetDigitSubstitution define o método de substituição de dígito e o idioma que corresponde aos substitutos de dígito.

Sintaxe

Status SetDigitSubstitution(
  [in] LANGID                language,
  [in] StringDigitSubstitute substitute
);

Parâmetros

[in] language

Tipo: LANGID

Valor de dezesseis bits que forma um identificador de linguagem NLS. O identificador especifica o idioma associado aos dígitos substitutos. Por exemplo, se esse objeto StringFormat usar dígitos de substituição árabes, esse método retornará um valor que indica um idioma árabe. Um identificador de linguagem NLS é construído pela macro MAKELANGID, declarada em Winnt.h.

[in] substitute

Tipo: StringDigitSubstitute

Elemento da enumeração StringDigitSubstitute que especifica o método de substituição de dígito a ser usado.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

O método de substituição de dígito, especificado por um elemento da enumeração StringDigitSubstitute , substitui, em uma cadeia de caracteres, dígitos da Europa Ocidental por dígitos que correspondem à localidade ou idioma de um usuário.

Ao especificar LANG_NEUTRAL como a ID do idioma, é uma prática comum passar apenas LANG_NEUTRAL como no exemplo a seguir:

stat = FontFamily.GetFamilyName(name, LANG_NEUTRAL);

Se você estiver especificando um idioma diferente de LANG_NEUTRAL, use MAKELANGID para criar a combinação de linguagem e sublanguagem como no exemplo a seguir:

LANGID language = MAKELANGID(LANG_CHINESE, SUBLANG_CHINESE_TRADITIONAL);

Para obter uma lista dos idiomas e sublanguages disponíveis, consulte Winnt.h.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho gdiplusstringformat.h (inclua Gdiplus.h)
Biblioteca Gdiplus.lib
DLL Gdiplus.dll