Estrutura CURRENCYFMTA (winnls.h)

Artigo
11/20/2024

Contém informações que definem o formato de uma cadeia de caracteres de moeda. A função GetCurrencyFormat usa essas informações para personalizar uma cadeia de caracteres de moeda para uma localidade especificada.

Sintaxe

typedef struct _currencyfmtA {
  UINT  NumDigits;
  UINT  LeadingZero;
  UINT  Grouping;
  LPSTR lpDecimalSep;
  LPSTR lpThousandSep;
  UINT  NegativeOrder;
  UINT  PositiveOrder;
  LPSTR lpCurrencySymbol;
} CURRENCYFMTA, *LPCURRENCYFMTA;

Membros

NumDigits

Número de dígitos fracionários. Esse número é equivalente a LOCALE_ICURRDIGITS.

LeadingZero

Valor que indica se zeros à esquerda devem ser usados em campos decimais. Esse valor é equivalente a LOCALE_ILZERO.

Grouping

Número de dígitos em cada grupo de números à esquerda do separador decimal especificado por lpDecimalSep. O dígito de agrupamento mais significativo indica o número de dígitos no grupo menos significativo imediatamente à esquerda do separador decimal. Cada dígito de agrupamento subsequente indica o próximo grupo significativo de dígitos à esquerda do grupo anterior. Se o último valor fornecido não for 0, os grupos restantes repetirão o último grupo. Exemplos típicos de configurações para este membro são: 0 para agrupar dígitos como em 123456789.00; 3 para agrupar dígitos como em 123.456.789,00; e 32 para agrupar dígitos como em 12,34,56.789,00.

Observação Você pode usar configurações diferentes das configurações típicas, mas elas não aparecerão na parte regional e de configurações de idioma do Painel de Controle. Essas configurações são extremamente incomuns e podem ter resultados inesperados.

lpDecimalSep

Ponteiro para uma cadeia de caracteres separador decimal terminada em nulo.

lpThousandSep

Ponteiro para uma cadeia de caracteres separador de mil terminadas em nulo.

NegativeOrder

Modo de moeda negativo. Esse modo é equivalente a LOCALE_INEGCURR.

PositiveOrder

Modo de moeda positivo. Esse modo é equivalente a LOCALE_ICURRENCY.

lpCurrencySymbol

Ponteiro para uma cadeia de caracteres de símbolo de moeda terminada em nulo.

Observações

Nota

O cabeçalho winnls.h define CURRENCYFMT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
cabeçalho	winnls.h (inclua Windows.h)

Consulte também

GetCurrencyFormat

estruturas de suporte à linguagem nacional

Compartilhar via