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 を呼び出します。
継承階層
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);
パラメーター
上陸用舟艇
関数が戻ると、アニメーション化された値を表す CAnimationVariable へのポインターが含まれます。
CAnimationValue::GetValue
現在の値を取得します。
BOOL GetValue(DOUBLE& dblValue);
BOOL GetValue(INT32& nValue);
パラメーター
dblValue
出力。 関数が返されるときに、アニメーション変数の現在の値が含まれます。
nValue
出力。 関数が返されるときに、アニメーション変数の現在の値が含まれます。
戻り値
現在の値が正常に取得された場合は TRUE。それ以外の場合は FALSE。
解説
現在の値を取得するには、この関数を呼び出します。 この実装は、カプセル化された 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 メソッドをもう一度呼び出す必要があります。