COleCurrency::GetStatus

Статья
02/20/2013

Эта функция-член вызывается с целью получить состояние (допустимость) заданного объекта COleCurrency.

CurrencyStatus GetStatus( ) const;

Возвращаемое значение

Возвращает состояние данного значения COleCurrency.

Заметки

Возвращаемое значение определяется типом CurrencyStatus, перечисленные в котором определен класс COleCurrency.

enum CurrencyStatus{

valid = 0,

invalid = 1,

null = 2,

};

Для краткое описание этих значений состояния см. в следующем списке:

COleCurrency::valid указывает, что данный объект COleCurrency допустимым.
COleCurrency::invalid указывает, что данный объект COleCurrency недопустим. то есть, его значение может быть неверной.
COleCurrency::null указывает, что данный объект COleCurrency пуст, то есть, что значение не предоставлено для данного объекта.(Это "null" в смысле базы данных "не иметь никакого значения, в отличие от C++) 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);