SftMaskCalculator.FormatNumber Method	Softel vdm, Inc.

Converts a value into a displayable number.

Syntax       

		VB.NET	object.FormatNumber(ByVal Val As Double, ByVal FracDigits As Short, ByVal LeadZero As Short, ByVal Grouping As Short, ByVal DecimalSep As String, ByVal ThousandSep As String, ByVal NegativeOrder As Short, ByRef Text As String)
		VB	object.FormatNumber(ByVal Val As Double, ByVal FracDigits As Integer, ByVal LeadZero As Integer, ByVal Grouping As Integer, ByVal DecimalSep As String, ByVal ThousandSep As String, ByVal NegativeOrder As Integer, Text As String)
		C#.NET	void object.FormatNumber(double Val, short FracDigits, short LeadZero, short Grouping, string DecimalSep, string ThousandSep, short NegativeOrder, out string Text);
		VC++	HRESULT object->FormatNumber(double Val, short FracDigits, short LeadZero, short Grouping, _bstr_t DecimalSep, _bstr_t ThousandSep, short NegativeOrder, _bstr_t* Text);
		C	HRESULT object->raw_FormatNumber(double Val, short FracDigits, short LeadZero, short Grouping, BSTR DecimalSep, BSTR ThousandSep, short NegativeOrder, BSTR* Text);
		Delphi	procedure object.FormatNumber(Val : Double, FracDigits : Smallint, LeadZero : Smallint, Grouping : Smallint, DecimalSep : WideString, ThousandSep : WideString, NegativeOrder : Smallint, out Text : WideString);

object

A SftMaskCalculator object.

Val

A Double. This value is formatted as a string using the provided attributes and returned in Text.

FracDigits

The number of desired fractional digits (0-99) or -1. If -1 is specified, the user locale is used (see GetLocaleInfo, LOCALE_IDIGITS).

LeadZero

1 if leading zeros are desired, otherwise 0. If -1 is specified, the user locale is used (see GetLocaleInfo, LOCALE_ILZERO).

Grouping

Specifies the size of each group of digits to the left of the decimal point (0-9). If -1 is specified, the user locale is used (see GetLocaleInfo, LOCALE_SGROUPING).

DecimalSep

The decimal separator string (up to four characters). If an empty string is specified, the user locale is used (see GetLocaleInfo, LOCALE_SDECIMAL).

ThousandSep

The thousands (group) separator string (up to four characters). If an empty string is specified, the user locale is used (see GetLocaleInfo, LOCALE_STHOUSAND).

NegativeOrder

The display mode for negative values (0-4). If -1 is specified, the user locale is used (see GetLocaleInfo, LOCALE_INEGNUMBER).

NegativeOrder	Example	Description
-1		The user locale is used (see GetLocaleInfo, LOCALE_INEGNUMBER)
0	(1.1)	Left parenthesis, number, right parenthesis
1	-1.1	Negative sign, number
2	- 1.1	Negative sign, space, number
3	1.1-	Number, negative sign
4	1.1 -	Number, space, negative sign

Text

The formatted string is returned in the Text argument.

Comments

The FormatNumber method converts a value into a displayable number.

Calculator.FormatCurrency is used to format numbers with currency attributes.

Calculator.FormatNumberV is used for languages such as VBScript, which are limited by requiring Variant arguments and do not support strongly typed arguments for return values. For more information please see Using SftMask/OCX with Internet Explorer.