Compartir a través de

Clase CAnimationPoint

  • Artículo

Implementa la funcionalidad de un punto cuyas coordenadas se pueden animar.

Sintaxis

class CAnimationPoint : public CAnimationBaseObject;

Miembros

Constructores públicos

Nombre Descripción
CAnimationPoint::CAnimationPoint Con sobrecarga. Construye un objeto CAnimationPoint.

Métodos públicos

Nombre Descripción
CAnimationPoint::AddTransition Agrega transiciones para las coordenadas X e Y.
CAnimationPoint::GetDefaultValue Devuelve los valores predeterminados de las coordenadas X e Y.
CAnimationPoint::GetValue Esta función se usa para obtener el valor actual.
CAnimationPoint::GetX Proporciona acceso a la coordenada X de CAnimationVariable.
CAnimationPoint::GetY Proporciona acceso a la coordenada Y de CAnimationVariable.
CAnimationPoint::SetDefaultValue Establece el valor predeterminado.

Métodos protegidos

Nombre Descripción
CAnimationPoint::GetAnimationVariableList Esta función se usa para colocar las variables de animación encapsuladas en una lista. Reemplaza CAnimationBaseObject::GetAnimationVariableList

Operadores públicos

Nombre Descripción
CAnimationPoint::operator CPoint Convierte CAnimationPoint en CPoint.
CAnimationPoint::operator= Asigna ptSrc a CAnimationPoint.

Miembros de datos protegidos

Nombre Descripción
CAnimationPoint::m_xValue Variable de animación encapsulada que representa la coordenada X del punto de animación.
CAnimationPoint::m_yValue Variable de animación encapsulada que representa la coordenada Y del punto de animación.

Comentarios

La clase CAnimationPoint encapsula dos objetos CAnimationVariable y puede representar en las aplicaciones un punto. Por ejemplo, puede usar esta clase para animar una posición de cualquier objeto en la pantalla, como una cadena de texto, un círculo, un punto, etc. Para usar esta clase en una aplicación, simplemente cree una instancia de un objeto de esta clase, agréguela al controlador de animación mediante CAnimationController::AddAnimationObject y llame a AddTransition en cada transición que se aplique a las coordenadas X o Y.

Jerarquía de herencia

CObject
CAnimationBaseObject
CAnimationPoint

Requisitos

Encabezado: afxanimationcontroller.h

CAnimationPoint::AddTransition

Agrega transiciones para las coordenadas X e Y.

void AddTransition(
    CBaseTransition* pXTransition,
    CBaseTransition* pYTransition);

Parámetros

pXTransition
Puntero a la transición de las coordenadas X.

pYTransition
Puntero a la transición de la coordenada Y.

Comentarios

Llame a esta función para agregar las transiciones especificadas a la lista interna de transiciones que se aplicarán a las variables de animación de las coordenadas X e Y. Al agregar transiciones, no se aplican inmediatamente, sino que se almacenarán en una lista interna. Las transiciones se aplican (se agregan a un guio gráfico para un valor determinado) cuando se llama a la función CAnimationController::AnimateGroup. Si no necesita aplicar una transición a una de las coordenadas, puede pasar NULL.

CAnimationPoint::CAnimationPoint

Construye un objeto CAnimationPoint.

CAnimationPoint();

CAnimationPoint(
    const CPoint& ptDefault,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parámetros

ptDefault
Especifica las coordenadas de punto predeterminadas.

nGroupID
Especifica el identificador de grupo.

nObjectID
Este parámetro se usa para especificar el id. de objeto.

dwUserData
Este parámetro se usa para especificar los datos definidos por el usuario.

Comentarios

Construye un objeto CAnimationPoint con las propiedades predeterminadas. Las coordenadas de punto predeterminadas, el identificador de grupo y el identificador de objeto se establecen en cero.

CAnimationPoint::GetAnimationVariableList

Esta función se usa para colocar las variables de animación encapsuladas en una lista.

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

Parámetros

lst
Cuando la función devuelve resultados, contiene punteros a dos objetos CAnimationVariable que representan las coordenadas X e Y.

CAnimationPoint::GetDefaultValue

Devuelve los valores predeterminados de las coordenadas X e Y.

CPoint GetDefaultValue();

Valor devuelto

Punto que contiene el valor predeterminado.

Comentarios

Llame a esta función para recuperar el valor predeterminado que se estableció anteriormente mediante el constructor o SetDefaultValue.

CAnimationPoint::GetValue

Esta función se usa para obtener el valor actual.

BOOL GetValue(CPoint& ptValue);

Parámetros

ptValue
Salida. En este valor, se almacena el valor actual en el momento en que se devuelve este método.

Valor devuelto

TRUE, si el valor actual se recuperó correctamente; de lo contrario, FALSE.

Comentarios

Llame a esta función para recuperar el valor actual de un punto de animación. Si se produce un error en este método o no se han inicializado los objetos COM subyacentes para las coordenadas X e Y, ptValue contiene el valor predeterminado establecido previamente en el constructor o mediante SetDefaultValue.

CAnimationPoint::GetX

Proporciona acceso a CAnimationVariable para la coordenada X.

CAnimationVariable& GetX();

Valor devuelto

Referencia al objeto CAnimationVariable encapsulado que representa la coordenada X.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que representa la coordenada X.

CAnimationPoint::GetY

Proporciona acceso a CAnimationVariable para la coordenada Y.

CAnimationVariable& GetY();

Valor devuelto

Referencia al objeto CAnimationVariable encapsulado que representa la coordenada Y.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que representa la coordenada Y.

CAnimationPoint::m_xValue

Variable de animación encapsulada que representa la coordenada X del punto de animación.

CAnimationVariable m_xValue;

CAnimationPoint::m_yValue

Variable de animación encapsulada que representa la coordenada Y del punto de animación.

CAnimationVariable m_yValue;

CAnimationPoint::operator CPoint

Convierte CAnimationPoint en CPoint.

operator CPoint();

Valor devuelto

El valor actual de CAnimationPoint como CPoint.

Comentarios

Esta función llama internamente a GetValue. Si se produce un error en GetValue, el punto devuelto contendrá valores predeterminados para las coordenadas X e Y.

CAnimationPoint::operator=

Asigna ptSrc a CAnimationPoint.

void operator=(const CPoint& ptSrc);

Parámetros

ptSrc
Hace referencia a CPoint o POINT.

Comentarios

Asigna ptSrc a CAnimationPoint. Se recomienda hacerlo antes del inicio de una animación, ya que este operador llama a SetDefaultValue, que vuelve a crear los objetos COM subyacentes de las coordenadas X e Y si se han creado. Si ha suscrito este objeto de animación a eventos (ValueChanged o IntegerValueChanged), vuelva a habilitar estos eventos.

CAnimationPoint::SetDefaultValue

Establece el valor predeterminado.

void SetDefaultValue(const POINT& ptDefault);

Parámetros

ptDefault
Especifica el valor de punto predeterminado.

Comentarios

Use esta función para establecer un valor predeterminado en el objeto de animación. Este método asigna valores predeterminados a las coordenadas X e Y del punto de animación. También se vuelven a crear los objetos COM subyacentes si estos se han creado. Si ha suscrito este objeto de animación a eventos (ValueChanged o IntegerValueChanged), vuelva a habilitar estos eventos.

Consulte también

Clases