COleDateTimeSpan::SetStatus

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

この COleDateTimeSpan オブジェクトの状態 (有効性) を設定します。

void SetStatus(
   DateTimeSpanStatus status 
) throw( );

パラメータ

status
この COleDateTimeSpan オブジェクトの新しい状態値。

解説

パラメータ Status の値は、COleDateTimeSpan クラス内に定義されている DateTimeSpanStatus 列挙型により定義されます。

enum DateTimeSpanStatus{

valid = 0,

invalid = 1,

null = 2,

};

状態値の簡単な説明は、次の一覧を参照してください。

COleDateTimeSpan::valid この COleDateTimeSpan オブジェクトが有効であることを示します。
COleDateTimeSpan::invalid この COleDateTimeSpan オブジェクトが無効、つまりその値が不正である可能性を示します。

COleDateTimeSpan::null この COleDateTimeSpan オブジェクトが null、つまりこのオブジェクトに値が設定されていないことを示します。これは、C++ の NULL とは異なり、"値を持たない" というデータベース用語での "null" です。

注意 :
この関数は、高度なプログラミングのためのものです。この関数は、このオブジェクトのデータは変更しません。ほとんどの場合、状態を無効にするか、null に設定するために使用されます。代入演算子 (operator =) および SetDateTimeSpan は、コピー元の値を基にしてオブジェクトの状態を設定することに注意してください。

この関数は、高度なプログラミングのためのものです。この関数は、このオブジェクトのデータは変更しません。ほとんどの場合、状態を無効にするか、null に設定するために使用されます。代入演算子 (operator =) および SetDateTimeSpan は、コピー元の値を基にしてオブジェクトの状態を設定することに注意してください。

使用例

// if the person is not still in school, set days to graduation to null
if (!m_bStillInSchool || m_dtDateOfGraduation.GetStatus() == COleDateTime::null)
   m_dtsDaysToGraduation.SetStatus(COleDateTimeSpan::null);