Função VarFormatPercent (oleauto.h)

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

Sintaxe

HRESULT VarFormatPercent(
  [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 que contém o valor a ser formatado.

[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

Recebe 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