Partager via


Fonction VarFormatNumber (oleauto.h)

Met en forme une variante contenant des nombres sous forme de chaîne.

Syntaxe

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

Paramètres

[in] pvarIn

Variante contenant la valeur à mettre en forme.

[in] iNumDig

Nombre de chiffres à ajouter après la virgule décimale. Spécifiez -1 pour utiliser la valeur par défaut du système.

[in] iIncLead

Spécifie s’il faut inclure le chiffre de début sur les nombres.

Valeur Signification
-2
Utilisez la valeur par défaut du système.
-1
Incluez le chiffre de début.
0
N’incluez pas le chiffre de début.

[in] iUseParens

Spécifie si les nombres négatifs doivent utiliser des parenthèses.

Valeur Signification
-2
Utilisez la valeur par défaut du système.
-1
Utilisez des parenthèses.
0
N’utilisez pas de parenthèses.

[in] iGroup

Spécifie si des milliers doivent être regroupés. Par exemple, 10 000 contre 10 000.

Note Les nombres et les devises standard ont des valeurs système par défaut distinctes pour toutes les options ci-dessus.
 
Valeur Signification
-2
Utilisez la valeur par défaut du système.
-1
Regroupez des milliers.
0
Ne regroupez pas des milliers.

[in] dwFlags

VAR_CALENDAR_HIJRI est le seul indicateur qui peut être défini.

[out] pbstrOut

Pointe vers la chaîne mise en forme qui représente la variante.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
Réussite.
E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.

Remarques

Cette fonction utilise les paramètres régionaux par défaut de l’utilisateur lors de l’appel de VarTokenizeFormatString et VarFormatFromTokens.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête oleauto.h
Bibliothèque OleAut32.lib
DLL OleAut32.dll

Voir aussi

Routines de mise en forme

VarFormatFromTokens

VarTokenizeFormatString