将包含数字的变体的格式设置为字符串形式。
语法
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
指定是否在数字上包括前导数字。
| 值 | 含义 |
|---|---|
|
使用系统默认值。 |
|
包括前导数字。 |
|
不要包含前导数字。 |
[in] iUseParens
指定负数是否应使用括号。
| 值 | 含义 |
|---|---|
|
使用系统默认值。 |
|
使用括号。 |
|
请勿使用括号。 |
[in] iGroup
指定是否应对千人进行分组。 例如,10,000 与 10000。
注意 对于上述所有选项,常规数字和货币具有单独的系统默认值。
| 值 | 含义 |
|---|---|
|
使用系统默认值。 |
|
组数千人。 |
|
不要对数千人进行分组。 |
[in] dwFlags
VAR_CALENDAR_HIJRI是唯一可以设置的标志。
[out] pbstrOut
指向表示变体的带格式字符串。
返回值
此函数可以返回其中一个值。
| 返回代码 | 说明 |
|---|---|
|
成功。 |
|
一个或多个参数无效。 |
注解
此函数在调用 VarTokenizeFormatString 和 VarFormatFromTokens 时使用用户的默认区域设置。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | oleauto.h |
| Library | OleAut32.lib |
| DLL | OleAut32.dll |