VarFormatNumber-Funktion (oleauto.h)

  • Artikel

Formatiert eine Variante, die Zahlen enthält, in ein Zeichenfolgenformular.

Syntax

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

Parameter

[in] pvarIn

Die Variante, die den zu formatierenden Wert enthält.

[in] iNumDig

Die Anzahl der Ziffern, die nach dem Dezimaltrennzeichen gepadet werden sollen. Geben Sie -1 an, um den Standardwert des Systems zu verwenden.

[in] iIncLead

Gibt an, ob die führende Ziffer in Zahlen eingeschlossen werden soll.

Wert Bedeutung
-2
 Verwenden Sie die Standardeinstellung des Systems.
-1
 Schließen Sie die führende Ziffer ein.
0
 Schließen Sie die führende Ziffer nicht ein.

[in] iUseParens

Gibt an, ob für negative Zahlen Klammern verwendet werden sollen.

Wert Bedeutung
-2
 Verwenden Sie die Standardeinstellung des Systems.
-1
 Verwenden Sie Klammern.
0
 Verwenden Sie keine Klammern.

[in] iGroup

Gibt an, ob Tausende gruppiert werden sollen. Beispiel: 10.000 im Vergleich zu 10000.

Hinweis Reguläre Zahlen und Währungen verfügen über separate Systemstandardwerte für alle oben genannten Optionen.
 
Wert Bedeutung
-2
 Verwenden Sie die Standardeinstellung des Systems.
-1
 Gruppiert Tausende.
0
 Gruppiert nicht Tausende.

[in] dwFlags

VAR_CALENDAR_HIJRI ist das einzige Flag, das festgelegt werden kann.

[out] pbstrOut

Zeigt auf die formatierte Zeichenfolge, die die Variante darstellt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_INVALIDARG
 Mindestens eines der Argumente ist ungültig.

Hinweise

Diese Funktion verwendet beim Aufrufen von VarTokenizeFormatString und VarFormatFromTokens das Standardgebietsschema des Benutzers.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile oleauto.h
Bibliothek OleAut32.lib
DLL OleAut32.dll

Weitere Informationen

Formatierungsroutinen

VarFormatFromTokens

VarTokenizeFormatString