The Objective Toolkit currency edit control classes provide a specialized edit control for the display and entry of currency data. The control includes a bitmap button for dropping down a calculator.

4.9.1 SECDropEdit

The SECDropEdit class adds a combo-like drop-down button to an edit control.

SECCurrencyEdit uses the special SECDropEdit capabilities to display a bitmap button that activates a calculator to help in the data entry.

4.9.2 SECCurrencyEdit

SECCurrencyEdit provides an extensible class for entering and displaying custom-formatted currency data. In addition, it includes a context menu and an optional bitmap button.

The methods of the Format class, a helper class, provide a comprehensive set of custom formatting options. If you need implement behavior that is not addressed by Format's methods, you can customize the input data parsing and output display formatting by descending new classes from SECCurrencyEdit::Format and SECCurrencyEdit.

4.9.3 Using SECCurrencyEdit

4.9.4 SECCurrencyEdit::Format

Format is a nested helper class that provides the core currency formatting and parsing methods used by an SECCurrencyEdit control. As the following list of methods suggests, the Format class provides extensive control over the appearance of the currency data.

• void EnableLeadingZero(BOOL b);

• void EnableDecimalSeparatorLine(BOOL b);

• void SetMonetarySymbol(LPCTSTR p);

• void SetThousandSeparator(TCHAR c);

• void EnableLeadingThousSeparator (BOOL b);

• void SetDecimalSeparator(TCHAR c);

• BOOL SetGrouping(LPCTSTR x);

• BOOL SetPaddingCharacter(TCHAR c);

• void SetPositiveFormat(int i);

• void SetNegativeFormat(int i);

• void SetDecimalDigits(int i);

• void SetFractionalDigits(int i);

• void SetBackgroundColor(COLORREF cr);

• void SetNegativeColor(COLORREF cr);

• void SetPositiveColor(COLORREF cr);

• void SetDecimalSeparatorLineColor(COLORREF cr);

Consider the following facts before you use the currency display options:

• Setting the thousands separator to the null character ('\0') prevents its use.

• With EnableLeadingThousSeparator, the thousands separator will present '5555555' as '$ , 5,555,555.00' as opposed to '$ 5,555,555.00'.

• When you set decimal digits to negative one (-1) the application uses every digit that is necessary to display the number. If the number of decimal digits is greater than is required, the output is padded with the padding character.

• You can use the values in the table below with the SetNegativeFormat() and SetPositiveFormat() methods. These values are taken directly from Microsoft's documentation regarding the international section of WIN.INI.

The ParseValue() and FormatValue() methods convert between a numeric and a string representation. If you need to use a format that is not supported by the basic Format class, derive your own Format class and override those methods. Then, derive your own version of SECCurrencyEdit and override its CreateFormatObject() method to provide an object of your descendant class.

For example, the following code:

SECCurrencyEdit m_Edit; // fmt(TRUE) will load the default system settings. SECCurrencyEdit::Format fmt(FALSE); fmt.EnableLeadingZero(TRUE); fmt.EnableDecimalSeparatorLine(FALSE); fmt.SetMonetarySymbol(_T("$")); fmt.SetThousandSeparator(_T(',')); fmt.SetDecimalSeparator(_T('.')); fmt.SetGrouping(_T("3;0")); // 3 digits per group repeated. fmt.SetPaddingCharacter(_T(' ')); fmt.SetPositiveFormat(0); fmt.SetNegativeFormat(0); fmt.SetDecimalDigits(10); fmt.SetFractionalDigits(2); fmt.SetNegativeColor(RGB(255,0,0)); fmt.SetPositiveColor(RGB(0,0,255)); m_Edit.SetFormat(fmt);

will present "5555555" as "$ , 5,555,555.00" in blue color; and "-5555555" as "($ , 5,555,555.00)" in red color.

4.9.5 SECCurrencyEdit Messages

The supported messages are as follows:

Table 9: Windows Messages Supported by SECCurrencyEdit

Table 10: Edit Control Messages Supported by SECCurrencyEdit

4.9.6 SECCurrencyEdit Sample