Share via


CAnimationValue クラス

1 つの値を持つアニメーション オブジェクトの機能を実装します。

構文

class CAnimationValue : public CAnimationBaseObject;

メンバー

パブリック コンストラクター

名前 説明
CAnimationValue::CAnimationValue 過負荷です。 CAnimationValue オブジェクトを構築します。

パブリック メソッド

名前 説明
CAnimationValue::AddTransition 値に適用する遷移を追加します。
CAnimationValue::GetValue 過負荷です。 現在の値を取得します。
CAnimationValue::GetVariable カプセル化されたアニメーション変数へのアクセスを提供します。
CAnimationValue::SetDefaultValue 既定値を設定します。

保護メソッド

名前 説明
CAnimationValue::GetAnimationVariableList カプセル化されたアニメーション変数をリストに格納します。 (オーバーライド CAnimationBaseObject::GetAnimationVariableList.)

パブリック演算子

名前 説明
CAnimationValue::operator DOUBLE CAnimationValue と DOUBLE の間の変換を提供します。
CAnimationValue::operator INT32 CAnimationValue と INT32 の間の変換を提供します。
CAnimationValue::operator= 過負荷です。 INT32 値を CAnimationValue に割り当てます。

プロテクト データ メンバー

名前 説明
CAnimationValue::m_value アニメーション値を表すカプセル化されたアニメーション変数。

解説

CAnimationValue クラスは、単一の CAnimationVariable オブジェクトをカプセル化し、1 つのアニメーション化された値をアプリケーションで表すことができます。 たとえば、アニメーション化された透明度 (フェード 効果)、角度 (オブジェクトを回転させる場合)、または 1 つのアニメーション値に応じてアニメーションを作成する必要がある場合に、このクラスを使用できます。 アプリケーションでこのクラスを使用するには、このクラスのオブジェクトをインスタンス化し、CAnimationController::AddAnimationObject を使用してアニメーション コントローラーに追加し、値に適用する遷移ごとに AddTransition を呼び出します。

継承階層

CObject

CAnimationBaseObject

CAnimationValue

必要条件

ヘッダー: afxanimationcontroller.h

CAnimationValue::AddTransition

値に適用する遷移を追加します。

void AddTransition(CBaseTransition* pTransition);

パラメーター

pTransition
遷移オブジェクトへのポインター。

解説

アニメーション変数に適用する遷移の内部リストに遷移を追加するには、この関数を呼び出します。 画面切り替えを追加しても、すぐには適用されず、内部リストに格納されます。 CAnimationController::AnimateGroup を呼び出すと、遷移が適用されます (特定の値のストーリーボードに追加されます)。

CAnimationValue::CAnimationValue

CAnimationValue オブジェクトを構築します。

CAnimationValue();

CAnimationValue(
    DOUBLE dblDefaultValue,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

パラメーター

dblDefaultValue
既定値を指定します。

nGroupID
グループ ID を指定します。

nObjectID
オブジェクト ID を指定します。

dwUserData
は、ユーザー定義データを指定します。

解説

既定値、グループ ID、およびオブジェクト ID が 0 に設定されている既定のプロパティを持つ CAnimationValue オブジェクトを構築します。

CAnimationValue::GetAnimationVariableList

カプセル化されたアニメーション変数をリストに格納します。

virtual void GetAnimationVariableList(
    CList<CAnimationVariable*,
    CAnimationVariable*>& lst);

パラメーター

Lst
関数が戻ると、アニメーション化された値を表す CAnimationVariable へのポインターが含まれます。

CAnimationValue::GetValue

現在の値を取得します。

BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);

パラメーター

dblValue
出力。 関数が返されるときに、アニメーション変数の現在の値が含まれます。

nValue
出力。 関数が返されるときに、アニメーション変数の現在の値が含まれます。

戻り値

現在の値が正常に取得された場合は TRUE。それ以外の場合は FAL Standard Edition。

解説

現在の値を取得するには、この関数を呼び出します。 この実装は、カプセル化された COM オブジェクトを呼び出し、呼び出しが失敗した場合、このメソッドは、コンストラクターまたは SetDefaultValue で以前に設定された既定値を返します。

CAnimationValue::GetVariable

カプセル化されたアニメーション変数へのアクセスを提供します。

CAnimationVariable& GetVariable();

戻り値

カプセル化されたアニメーション変数への参照。

解説

カプセル化されたアニメーション変数にアクセスするには、このメソッドを使用します。 CAnimationVariable から、基になる IUIAnimationVariable オブジェクトにアクセスできます。このオブジェクトのポインターは、アニメーション変数が作成されていない場合は NULL になります。

CAnimationValue::m_value

アニメーション値を表すカプセル化されたアニメーション変数。

CAnimationVariable m_value;

CAnimationValue::operator DOUBLE

CAnimationValue と DOUBLE の間の変換を提供します。

operator DOUBLE();

戻り値

アニメーション値の現在の値。

解説

CAnimationValue と DOUBLE の間の変換を提供します。 このメソッドは内部的に GetValue を呼び出し、エラーのチェックしません。 GetValue が失敗した場合、戻り値には、コンストラクターまたは SetDefaultValue で以前に設定された既定値が含まれます。

CAnimationValue::operator INT32

CAnimationValue と INT32 の間の変換を提供します。

operator INT32();

戻り値

アニメーション値の現在の値 (整数)。

解説

CAnimationValue と INT32 の間の変換を提供します。 このメソッドは内部的に GetValue を呼び出し、エラーのチェックしません。 GetValue が失敗した場合、戻り値には、コンストラクターまたは SetDefaultValue で以前に設定された既定値が含まれます。

CAnimationValue::operator=

DOUBLE 値を CAnimationValue に割り当てます。

void operator=(DOUBLE dblVal);
void operator=(INT32 nVal);

パラメーター

dblVal
アニメーション値に割り当てる値を指定します。

nVal
アニメーション値に割り当てる値を指定します。

解説

DOUBLE 値を CAnimationValue に割り当てます。 この値は、カプセル化されたアニメーション変数の既定値として設定されます。 このアニメーション オブジェクトをイベント (ValueChanged または IntegerValueChanged) にサブスクライブした場合は、これらのイベントを再度有効にする必要があります。

CAnimationValue::SetDefaultValue

既定値を設定します。

void SetDefaultValue(DOUBLE dblDefaultValue);

パラメーター

dblDefaultValue
既定値を指定します。

解説

既定値を設定するには、このメソッドを使用します。 アニメーションが開始されていないか、基になる COM オブジェクトが作成されていない場合、既定値がアプリケーションに返されます。 CAnimationVarible にカプセル化された基になる COM オブジェクトが既に作成されている場合、このメソッドはそれを再作成するため、EnableValueChanged/EnableIntegerValueChanged メソッドをもう一度呼び出す必要があります。

関連項目

クラス