Export (0) Print
Expand All


Constructs a COleCurrency object.

COleCurrency( ); 
   CURRENCY cySrc  
   const COleCurrency& curSrc  
   const VARIANT& varSrc  
   long nUnits, 
   long nFractionalUnits  


A CURRENCY value to be copied into the new COleCurrency object.


An existing COleCurrency object to be copied into the new COleCurrency object.


An existing VARIANT data structure (possibly a COleVariant object) to be converted to a currency value (VT_CY) and copied into the new COleCurrency object.

nUnits, nFractionalUnits

Indicate the units and fractional part (in 1/10,000's) of the value to be copied into the new COleCurrency object.

All of these constructors create new COleCurrency objects initialized to the specified value. A brief description of each of these constructors follows. Unless otherwise noted, the status of the new COleCurrency item is set to valid.

  • COleCurrency( )   Constructs a COleCurrency object initialized to 0 (zero).

  • COleCurrency( cySrc )   Constructs a COleCurrency object from a CURRENCY value.

  • COleCurrency( curSrc )   Constructs a COleCurrency object from an existing COleCurrency object. The new object has the same status as the source object.

  • COleCurrency( varSrc )   Constructs a COleCurrency object. Attempts to convert a VARIANT structure or COleVariant object to a currency (VT_CY) value. If this conversion is successful, the converted value is copied into the new COleCurrency object. If it is not, the value of the COleCurrency object is set to zero (0) and its status to invalid.

  • COleCurrency( nUnits, nFractionalUnits )   Constructs a COleCurrency object from the specified numerical components. If the absolute value of the fractional part is greater than 10,000, the appropriate adjustment is made to the units. Note that the units and fractional part are specified by signed long values.

For more information, see the CURRENCY and VARIANT entries in the Windows SDK.

The following examples show the effects of the zero-parameter and two-parameter constructors:

COleCurrency curZero;         // value: 0.0000
COleCurrency curA(4, 500);    // value: 4.0500
COleCurrency curB(2, 11000);  // value: 3.1000
COleCurrency curC(2, -50);    // value: 1.9950

Header: afxdisp.h

© 2014 Microsoft