CAnimationPoint クラス
座標をアニメーション化できる点の機能を実装します。
構文
class CAnimationPoint : public CAnimationBaseObject;
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
CAnimationPoint::CAnimationPoint |
過負荷です。 オブジェクト CAnimationPoint 構築します。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
CAnimationPoint::AddTransition |
X 座標と Y 座標の遷移を追加します。 |
CAnimationPoint::GetDefaultValue |
X 座標と Y 座標の既定値を返します。 |
CAnimationPoint::GetValue |
現在の値を返します。 |
CAnimationPoint::GetX |
CAnimationVariable X 座標へのアクセスを提供します。 |
CAnimationPoint::GetY |
CAnimationVariable Y 座標へのアクセスを提供します。 |
CAnimationPoint::SetDefaultValue |
既定値を設定します。 |
保護メソッド
| 名前 | 説明 |
|---|---|
CAnimationPoint::GetAnimationVariableList |
カプセル化されたアニメーション変数をリストに配置します。 オーバーライド CAnimationBaseObject::GetAnimationVariableList |
パブリック演算子
| 名前 | 説明 |
|---|---|
CAnimationPoint::operator CPoint |
CAnimationPoint を CPointに変換します。 |
CAnimationPoint::operator= |
ptSrc を CAnimationPoint に代入します。 |
プロテクト データ メンバー
| 名前 | 説明 |
|---|---|
CAnimationPoint::m_xValue |
アニメーション ポイントの X 座標を表すカプセル化されたアニメーション変数。 |
CAnimationPoint::m_yValue |
アニメーション ポイントの Y 座標を表すカプセル化されたアニメーション変数。 |
解説
CAnimationPoint クラスは、2 つのCAnimationVariable オブジェクトをカプセル化し、ポイントをアプリケーションで表すことができます。 たとえば、このクラスを使用すると、テキスト文字列、円、ポイントなどの画面上の任意のオブジェクトの位置をアニメーション化できます。 アプリケーションでこのクラスを使用するには、このクラスのオブジェクトをインスタンス化し、 CAnimationController::AddAnimationObjectを使用してアニメーション コントローラーに追加し、X 座標または Y 座標に適用される遷移ごとに AddTransition を呼び出します。
継承階層
CObject
CAnimationBaseObject
CAnimationPoint
要件
ヘッダー: afxanimationcontroller.h
CAnimationPoint::AddTransition
X 座標と Y 座標の遷移を追加します。
void AddTransition(
CBaseTransition* pXTransition,
CBaseTransition* pYTransition);
パラメーター
pXTransition
X 座標の遷移へのポインター。
pYTransition
Y 座標の遷移へのポインター。
解説
この関数を呼び出して、指定した遷移を、X 座標と Y 座標のアニメーション変数に適用する遷移の内部リストに追加します。 画面切り替えを追加しても、すぐには適用されず、内部リストに格納されます。 CAnimationController::AnimateGroupを呼び出すと、遷移が適用されます (特定の値のストーリーボードに追加されます)。 いずれかの座標に遷移を適用する必要がない場合は、 NULL渡すことができます。
CAnimationPoint::CAnimationPoint
CAnimationPoint オブジェクトを構築します。
CAnimationPoint();
CAnimationPoint(
const CPoint& ptDefault,
UINT32 nGroupID,
UINT32 nObjectID = (UINT32)-1,
DWORD dwUserData = 0);
パラメーター
ptDefault
既定の点座標を指定します。
nGroupID
グループ ID を指定します。
nObjectID
オブジェクト ID を指定します。
dwUserData
ユーザー定義データを指定します。
解説
既定のプロパティを使用して CAnimationPoint オブジェクトを構築します。 既定のポイント座標であるグループ ID とオブジェクト ID は 0 に設定されます。
CAnimationPoint::GetAnimationVariableList
カプセル化されたアニメーション変数をリストに配置します。
virtual void GetAnimationVariableList(CList<CAnimationVariable*, CAnimationVariable*>& lst);
パラメーター
lst
関数が戻るときに、X 座標と Y 座標を表す 2 つの CAnimationVariable オブジェクトへのポインターが含まれます。
CAnimationPoint::GetDefaultValue
X 座標と Y 座標の既定値を返します。
CPoint GetDefaultValue();
戻り値
既定値を含むポイント。
解説
この関数を呼び出して、コンストラクターまたは SetDefaultValueによって以前に設定された既定値を取得します。
CAnimationPoint::GetValue
現在の値を返します。
BOOL GetValue(CPoint& ptValue);
パラメーター
ptValue
出力。 このメソッドが返されたときの現在の値を格納します。
戻り値
TRUE現在の値が正常に取得された場合。それ以外の場合は FALSE。
解説
アニメーション ポイントの現在の値を取得するには、この関数を呼び出します。 このメソッドが失敗した場合、または X 座標と Y 座標の基になる COM オブジェクトが初期化されていない場合、 ptValue には、コンストラクターまたは SetDefaultValue によって以前に設定された既定値が含まれます。
CAnimationPoint::GetX
X 座標の CAnimationVariable へのアクセスを提供します。
CAnimationVariable& GetX();
戻り値
X 座標を表すカプセル化された CAnimationVariable への参照。
解説
このメソッドを呼び出すと、X 座標を表す基になる CAnimationVariable に直接アクセスできます。
CAnimationPoint::GetY
Y 座標の CAnimationVariable へのアクセスを提供します。
CAnimationVariable& GetY();
戻り値
Y 座標を表すカプセル化された CAnimationVariable への参照。
解説
このメソッドを呼び出すと、Y 座標を表す基になる CAnimationVariable に直接アクセスできます。
CAnimationPoint::m_xValue
アニメーション ポイントの X 座標を表すカプセル化されたアニメーション変数。
CAnimationVariable m_xValue;
CAnimationPoint::m_yValue
アニメーション ポイントの Y 座標を表すカプセル化されたアニメーション変数。
CAnimationVariable m_yValue;
CAnimationPoint::operator CPoint
CAnimationPoint を CPointに変換します。
operator CPoint();
戻り値
CPointとしてのCAnimationPointの現在の値。
解説
この関数は、 GetValueを内部的に呼び出します。 GetValue失敗した場合、返されるポイントには X 座標と Y 座標の既定値が含まれます。
CAnimationPoint::operator=
ptSrc を CAnimationPoint に代入します。
void operator=(const CPoint& ptSrc);
パラメーター
ptSrc
CPointまたはPOINTを参照します。
解説
ptSrc を CAnimationPoint に代入します。 この演算子は SetDefaultValue を呼び出し、作成されている場合は X 座標と Y 座標の基になる COM オブジェクトを再作成するため、アニメーションを開始する前に実行することをお勧めします。 このアニメーション オブジェクトをイベント (ValueChanged または IntegerValueChanged) にサブスクライブした場合は、これらのイベントを再度有効にします。
CAnimationPoint::SetDefaultValue
既定値を設定します。
void SetDefaultValue(const POINT& ptDefault);
パラメーター
ptDefault
既定のポイント値を指定します。
解説
この関数を使用して、既定値をアニメーション オブジェクトに設定します。 このメソッドは、アニメーション ポイントの X 座標と Y 座標に既定値を割り当てます。 また、基になる COM オブジェクトが作成されている場合は再作成されます。 このアニメーション オブジェクトをイベント (ValueChanged または IntegerValueChanged) にサブスクライブした場合は、これらのイベントを再度有効にします。