VarFormatNumber 函式 (oleauto.h)

將包含數位的變體格式化為字串格式。

語法

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

參數

[in] pvarIn

包含要格式化之值的變體。

[in] iNumDig

小數點之後要填補的位數。 指定 -1 以使用系統預設值。

[in] iIncLead

指定是否要在數位中包含前置數位。

值	意義
-2	使用系統預設值。
-1	包含前置數位。
0	請勿包含前置數位。

[in] iUseParens

指定負數是否應該使用括號。

值	意義
-2	使用系統預設值。
-1	使用括弧。
0	請勿使用括號。

[in] iGroup

指定是否應該將數千個群組在一起。 例如，10,000 與 10000。

注意 上述所有選項的一般數位和貨幣都有個別的系統預設值。

 

值	意義
-2	使用系統預設值。
-1	將數千個群組。
0	請勿將數千個群組。

[in] dwFlags

VAR_CALENDAR_HIJRI是唯一可以設定的旗標。

[out] pbstrOut

指向代表變體的格式化字串。

傳回值

此函式可以傳回下列其中一個值。

傳回碼	描述
S_OK	成功。
E_INVALIDARG	一或多個自變數無效。

備註

此函式會在呼叫 VarTokenizeFormatString 和 VarFormatFromTokens 時使用使用者的預設地區設定。

規格需求

需求	值
目標平台	Windows
標頭	oleauto.h
程式庫	OleAut32.lib
Dll	OleAut32.dll

另請參閱

格式化例程

VarFormatFromTokens

VarTokenizeFormatString