COleCurrency::GetStatus

Artykuł
06/10/2015

Wywołać funkcję Członkowskich uzyskanie statusu (ważność) danego COleCurrency obiektu.

CurrencyStatus GetStatus( ) const;

Wartość zwracana

Zwraca stan to COleCurrency wartości.

Uwagi

Wartość zwracana jest zdefiniowany przez CurrencyStatus wyliczone typu zdefiniowanego w COleCurrency klasy.

enum CurrencyStatus{

valid = 0,

invalid = 1,

null = 2,

};

Krótki opis tych wartości stanu listę:

COleCurrency::valid wskazuje że COleCurrency obiektu jest nieprawidłowy.
COleCurrency::invalid wskazuje że COleCurrency obiektu jest nieprawidłowy; oznacza to, że jego wartość mogą być nieprawidłowe.
COleCurrency::null wskazuje że COleCurrency obiekt jest null, oznacza to, że wartość nie zostały dostarczone dla tego obiektu.(Jest to "null" w rozumieniu bazy danych "posiadające żadnej wartości" a nie C++ NULL.)

Stan COleCurrency obiektu jest nieprawidłowy w następujących przypadkach:

Jeśli jego wartość jest z WARIANTU lub COleVariant wartość, która nie może być konwertowana na wartość waluty.
Jeśli ten obiekt napotkał przepełnienie lub niedomiar podczas operacji arytmetycznych przypisania, na przykład += lub * =.
Jeśli nieprawidłowa wartość został przypisany do tego obiektu.
Jeśli stan ten obiekt jawnie ustawiono nieprawidłową za pomocą SetStatus.

Więcej informacji na temat operacji, które może ustawić stan nieprawidłowy, zobacz następujące funkcje składowe:

Przykład

// 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);