Compartilhar via


Função VarFormatCurrency (oleauto.h)

Formata uma variante que contém valores de moeda em um formulário de cadeia de caracteres.

Sintaxe

HRESULT VarFormatCurrency(
  [in]  LPVARIANT pvarIn,
  [in]  int       iNumDig,
  [in]  int       iIncLead,
  [in]  int       iUseParens,
  [in]  int       iGroup,
  [in]  ULONG     dwFlags,
  [out] BSTR      *pbstrOut
);

Parâmetros

[in] pvarIn

A variante.

[in] iNumDig

O número de dígitos a serem adicionados após o ponto decimal. Especifique -1 para usar o valor padrão do sistema.

[in] iIncLead

Especifica se o dígito à esquerda deve ser incluído nos números.

Valor Significado
-2
Use o padrão do sistema.
-1
Inclua o dígito à esquerda.
0
Não inclua o dígito à esquerda.

[in] iUseParens

Especifica se os números negativos devem usar parênteses.

Valor Significado
-2
Use o padrão do sistema.
-1
Use parênteses.
0
Não use parênteses.

[in] iGroup

Especifica se milhares devem ser agrupados. Por exemplo, 10.000 versus 10000.

Nota Números regulares e moedas têm padrões de sistema separados para todas as opções acima.
 
Valor Significado
-2
Use o padrão do sistema.
-1
Agrupar milhares.
0
Não agrupe milhares.

[in] dwFlags

VAR_CALENDAR_HIJRI é o único sinalizador que pode ser definido.

[out] pbstrOut

A cadeia de caracteres formatada que representa a variante.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
Um ou mais dos argumentos não são válidos.

Comentários

Essa função usa a localidade padrão do usuário ao chamar VarTokenizeFormatString e VarFormatFromTokens.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll

Confira também

Rotinas de formatação

VarFormatFromTokens

VarTokenizeFormatString