VarFormatNumber-Funktion (oleauto.h)

Artikel
03/01/2024

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

Freigeben über