COleCurrency::GetStatus
更新 : 2007 年 11 月
指定された COleCurrency オブジェクトの状態 (有効性) を取得します。
CurrencyStatus GetStatus( ) const;
戻り値
この COleCurrency 値の状態を返します。
解説
戻り値は、COleCurrency クラス内で定義されている列挙型 CurrencyStatus として定義されています。
enum CurrencyStatus{
valid = 0,
invalid = 1,
null = 2,
};
状態値の簡単な説明は、次の一覧を参照してください。
COleCurrency::valid この COleCurrency オブジェクトが有効であることを示します。
COleCurrency::invalid この COleCurrency オブジェクトが無効、つまりその値が不正である可能性を示します。
COleCurrency::null この COleCurrency オブジェクトが null、つまりこのオブジェクトに値が設定されていないことを示します。これは、C++ の NULL とは異なり、"値を持たない" というデータベース用語での "null" です。
次の場合 COleCurrency オブジェクトの状態は無効になります。
値が、通貨値に変換できない VARIANT 値、または COleVariant 値から設定された場合。
オブジェクトが、たとえば += または *= などの代入演算中にオーバーフローまたはアンダーフローになった場合。
このオブジェクトに無効な値が代入された場合。
このオブジェクトの状態が SetStatus を使って、明示的に無効に設定された場合。
状態が無効に設定される可能性のある演算の詳細については、次のメンバ関数を参照してください。
使用例
// even an empty COleCurrency is valid
COleCurrency cy;
ASSERT(cy.GetStatus() == COleCurrency::valid);
// always valid after being set
cy.SetCurrency(4, 500);
ASSERT(cy.GetStatus() == COleCurrency::valid);
// some conversions aren't possible and will
// cause an invalid state, like this:
CByteArray array;
COleVariant varBogus(array);
cy = varBogus;
ASSERT(cy.GetStatus() == COleCurrency::invalid);
必要条件
ヘッダー : afxdisp.h