CAnimationSize (clase)

Implementa la funcionalidad de un objeto cuyas dimensiones se pueden animar.

Sintaxis

class CAnimationSize : public CAnimationBaseObject;

Miembros

Constructores públicos

Nombre	Descripción
CAnimationSize::CAnimationSize	Con sobrecarga. Construye un objeto de tamaño de animación.

Métodos públicos

Nombre	Descripción
CAnimationSize::AddTransition	Agrega transiciones para el ancho y el alto.
CAnimationSize::GetCX	Proporciona acceso a la CAnimationVariable que representa el ancho.
CAnimationSize::GetCY	Proporciona acceso a la CAnimationVariable que representa el alto.
CAnimationSize::GetDefaultValue	Devuelve los valores predeterminados de ancho y alto.
CAnimationSize::GetValue	Esta función se usa para obtener el valor actual.
CAnimationSize::SetDefaultValue	Esta función se usa para establecer el valor predeterminado.

Métodos protegidos

Nombre	Descripción
CAnimationSize::GetAnimationVariableList	Esta función se usa para colocar las variables de animación encapsuladas en una lista. (Invalida CAnimationBaseObject::GetAnimationVariableList.)

Operadores públicos

Nombre	Descripción
CAnimationSize::operator CSize	Convierte un elemento CAnimationSize en CSize.
CAnimationSize::operator=	Asigna szSrc a CAnimationSize.

Miembros de datos protegidos

Nombre	Descripción
CAnimationSize::m_cxValue	Variable de animación encapsulada que representa el ancho de un tamaño de animación.
CAnimationSize::m_cyValue	Variable de animación encapsulada que representa el alto de un tamaño de animación.

Comentarios

La clase CAnimationSize encapsula dos objetos CAnimationVariable y se puede representar un tamaño en una aplicación. Por ejemplo, puede usar esta clase para animar un tamaño de cualquier objeto bidimensional en la pantalla (como rectángulo, control, etc.). Para usar esta clase en una aplicación, basta con crear una instancia de un objeto de esta clase, agregarla al controlador de animación mediante la función CAnimationController::AddAnimationObject y, por último, llamar a la función AddTransition para que cada transición se aplique al ancho o al alto.

Jerarquía de herencia

CObject

CAnimationBaseObject

CAnimationSize

Requisitos

Encabezado: afxanimationcontroller.h

CAnimationSize::AddTransition

Agrega transiciones para el ancho y el alto.

void AddTransition(
    CBaseTransition* pCXTransition,
    CBaseTransition* pCYTransition);

Parámetros

pCXTransition
Puntero a la transición para el ancho.

pCYTransition
Puntero a la transición para el alto.

Comentarios

Llame a esta función para agregar las transiciones especificadas a la lista interna de transiciones que, a su vez, se aplicarán a las variables de animación para el ancho y el alto. Al agregar transiciones, estas no se aplicarán inmediatamente, sino que se almacenarán en una lista interna. Las transiciones se aplican (se agregan a un guión 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 dimensiones, puede pasar NULL.

CAnimationSize::CAnimationSize

Construye un objeto de tamaño de animación.

CAnimationSize();

CAnimationSize(
    const CSize& szDefault,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parámetros

szDefault
Especifica el tamaño predeterminado.

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

El objeto se construye con los valores predeterminados de ancho, alto, id. de objeto e id. de grupo que se establecerán en 0. Estos valores se pueden cambiar más tarde, en tiempo de ejecución, mediante las funciones SetDefaultValue y SetID.

CAnimationSize::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 se devuelve la función, contiene punteros a dos objetos CAnimationVariable, donde se representan el ancho y el alto.

CAnimationSize::GetCX

Proporciona acceso a la CAnimationVariable que representa el ancho.

CAnimationVariable& GetCX();

Valor devuelto

Referencia a un objeto CAnimationVariable encapsulado, que representa el ancho.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que representa el ancho.

CAnimationSize::GetCY

Proporciona acceso a la CAnimationVariable que representa el alto.

CAnimationVariable& GetCY();

Valor devuelto

Referencia a un objeto CAnimationVariable encapsulado, que representa el alto.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que representa el alto.

CAnimationSize::GetDefaultValue

Devuelve los valores predeterminados de ancho y alto.

CSize GetDefaultValue();

Valor devuelto

Objeto CSize que contiene valores predeterminados.

Comentarios

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

CAnimationSize::GetValue

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

BOOL GetValue(CSize& szValue);

Parámetros

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

Valor devuelto

Si el valor actual se recuperó correctamente, el valor devuelto será TRUE; de lo contrario, será FALSE.

Comentarios

Llame a esta función para recuperar el valor actual de tamaño de animación. Si se produce un error en este método o no se han inicializado los objetos COM subyacentes para el ancho y el tamaño, szValue contiene el valor predeterminado que se estableció anteriormente en un constructor o por SetDefaultValue.

CAnimationSize::m_cxValue

Variable de animación encapsulada que representa el ancho de un tamaño de animación.

CAnimationVariable m_cxValue;

CAnimationSize::m_cyValue

Variable de animación encapsulada que representa el alto de un tamaño de animación.

CAnimationVariable m_cyValue;

CAnimationSize::operator CSize

Convierte un elemento CAnimationSize en CSize.

operator CSize();

Valor devuelto

Valor actual del tamaño de animación como CSize.

Comentarios

Al usar esta función, se llama internamente a la función GetValue. Si se produce un error en GetValue por algún motivo, el tamaño devuelto contendrá los valores predeterminados para el ancho y el alto.

CAnimationSize::operator=

Asigna szSrc a CAnimationSize.

void operator=(const CSize& szSrc);

Parámetros

szSrc
Hace referencia a CSize o SIZE.

Comentarios

Asigna szSrc a CAnimationSize. Es recomendable realizar este proceso antes del inicio de una animación, ya que este operador llama a SetDefaultValue, que vuelve a crear los objetos COM subyacentes para el ancho y el alto si ya se han creado. Si ha suscrito este objeto de animación a algún evento (ValueChanged o IntegerValueChanged), deberá volver a habilitarlo.

CAnimationSize::SetDefaultValue

Esta función se usa para establecer el valor predeterminado.

void SetDefaultValue(const CSize& szDefault);

Parámetros

szDefault
Especifica el nuevo tamaño predeterminado.

Comentarios

Use esta función para establecer un valor predeterminado en el objeto de animación. Estos métodos asignan valores predeterminados al ancho y al alto de tamaño de animación. También se vuelven a crear los objetos COM subyacentes si estos ya se han creado. Si ha suscrito este objeto de animación a algún evento (ValueChanged o IntegerValueChanged), deberá volver a habilitarlo.

Consulte también

Clases