Compartir a través de

CAnimationRect (clase)

  • Artículo

Implementa la funcionalidad de un rectángulo cuyos lados se pueden animar.

Sintaxis

class CAnimationRect : public CAnimationBaseObject;

Miembros

Constructores públicos

Nombre Descripción
CAnimationRect::CAnimationRect Con sobrecarga. Se usa para construir un objeto de rectángulo de animación.

Métodos públicos

Nombre Descripción
CAnimationRect::AddTransition Esta función se usa para agregar transiciones para las coordenadas izquierda, superior, derecha e inferior.
CAnimationRect::GetBottom Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada inferior.
CAnimationRect::GetDefaultValue Esta función se usa para obtener los valores predeterminados de los límites del rectángulo.
CAnimationRect::GetLeft Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada izquierda.
CAnimationRect::GetRight Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada derecha.
CAnimationRect::GetTop Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada superior.
CAnimationRect::GetValue Esta función se usa para obtener el valor actual.
CAnimationRect::SetDefaultValue Esta función se usa para establecer el valor predeterminado.

Métodos protegidos

Nombre Descripción
CAnimationRect::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
CAnimationRect::operator RECT Este operador se usa para convertir a un objeto CAnimationRect en un objeto RECT.
CAnimationRect::operator= Este operador se usa para asignar un objeto de rectángulo a un objeto CAnimationRect.

Miembros de datos públicos

Nombre Descripción
CAnimationRect::m_bFixedSize Este miembro se usa para especificar si el rectángulo tiene un tamaño fijo.

Miembros de datos protegidos

Nombre Descripción
CAnimationRect::m_bottomValue Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite inferior de un rectángulo de animación.
CAnimationRect::m_leftValue Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite izquierdo de un rectángulo de animación.
CAnimationRect::m_rightValue Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite derecho de un rectángulo de animación.
CAnimationRect::m_szInitial Este miembro se usa para especificar el tamaño inicial de un rectángulo de animación.
CAnimationRect::m_topValue Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite superior de un rectángulo de animación.

Comentarios

En la clase CAnimationRect, se encapsulan cuatro objetos CAnimationVariable que se usan para representar un rectángulo en una aplicación. 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 a las coordenadas izquierda, superior e inferior.

Jerarquía de herencia

CObject

CAnimationBaseObject

CAnimationRect

Requisitos

Encabezado: afxanimationcontroller.h

CAnimationRect::AddTransition

Esta función se usa para agregar transiciones para las coordenadas izquierda, superior, derecha e inferior.

void AddTransition(
    CBaseTransition* pLeftTransition,
    CBaseTransition* pTopTransition,
    CBaseTransition* pRightTransition,
    CBaseTransition* pBottomTransition);

Parámetros

pLeftTransition
El valor de este parámetro se usa para especificar la transición del lado izquierdo.

pTopTransition
El valor de este parámetro se usa para especificar la transición del lado superior.

pRightTransition
El valor de este parámetro se usa para especificar la transición del lado derecho.

pBottomTransition
El valor de este parámetro se usa para especificar la transición del lado inferior.

Comentarios

Llame a esta función para agregar las transiciones que especifique a la lista interna de transiciones que, a su vez, se aplicarán a las variables de animación de cada lado del rectángulo. 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 uno de los lados del rectángulo, puede pasar el valor NULL.

CAnimationRect::CAnimationRect

Esta función se usa para construir un objeto CAnimationRect.

CAnimationRect();

CAnimationRect(
    const CRect& rect,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    const CPoint& pt,
    const CSize& sz,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

CAnimationRect(
    int nLeft,
    int nTop,
    int nRight,
    int nBottom,
    UINT32 nGroupID,
    UINT32 nObjectID = (UINT32)-1,
    DWORD dwUserData = 0);

Parámetros

rect
Este parámetro se usa para especificar el uso de un rectángulo 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.

pt
Este parámetro se usa para especificar la coordenada de la esquina superior izquierda.

sz
El valor de este parámetro se corresponde con el nombre del rectángulo.

nLeft
Este parámetro se usa para especificar la coordenada del límite izquierdo.

nTop
Este parámetro se usa para especificar la coordenada del límite superior.

nRight
Este parámetro se usa para especificar la coordenada del límite derecho.

nBottom
Este parámetro se usa para especificar la coordenada del límite inferior.

Comentarios

El objeto se construye con los valores predeterminados de los lados izquierdo, superior, derecho e inferior. Asimismo, los valores de id. de objeto e id. de grupo se establecerán en 0. Estos valores se pueden cambiar más tarde, en tiempo de ejecución, mediante las funciones SetDefaultValue y SetID.

CAnimationRect::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 se devuelve, en este parámetro se incluyen los punteros que apuntan a cuatro objetos CAnimationVariable, donde se representan las coordenadas del rectángulo.

CAnimationRect::GetBottom

Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada inferior.

CAnimationVariable& GetBottom();

Valor devuelto

El valor devuelto se corresponde con una referencia a un objeto CAnimationVariable encapsulado, que se usa para representar la coordenada inferior.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que se usa para representar la coordenada inferior.

CAnimationRect::GetDefaultValue

Esta función se usa para obtener los valores predeterminados de los límites del rectángulo.

CRect GetDefaultValue();

Valor devuelto

El valor devuelto será un valor CRect, donde se incluirán los valores predeterminados de los lados izquierdo, derecho, superior e inferior.

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.

CAnimationRect::GetLeft

Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada izquierda.

CAnimationVariable& GetLeft();

Valor devuelto

El valor devuelto se corresponde con una referencia a un objeto CAnimationVariable encapsulado, que se usa para representar la coordenada izquierda.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que se usa para representar la coordenada izquierda.

CAnimationRect::GetRight

Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada derecha.

CAnimationVariable& GetRight();

Valor devuelto

El valor devuelto se corresponde con una referencia a un objeto CAnimationVariable encapsulado, que se usa para representar la coordenada derecha.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que se usa para representar la coordenada derecha.

CAnimationRect::GetTop

Esta función se usa para proporcionar acceso al objeto CAnimationVariable donde se representa la coordenada superior.

CAnimationVariable& GetTop();

Valor devuelto

El valor devuelto se corresponde con una referencia a un objeto CAnimationVariable encapsulado, que se usa para representar la coordenada superior.

Comentarios

Puede llamar a este método para obtener acceso directo al objeto CAnimationVariable subyacente que se usa para representar la coordenada superior.

CAnimationRect::GetValue

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

BOOL GetValue(CRect& rect);

Parámetros

rect
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 un rectángulo de animación. Si se produce un error en este método o no se han inicializado los objetos COM subyacentes de los objetos COM izquierdo, superior, derecho e inferior, el parámetro rect tendrá el valor predeterminado que se estableció anteriormente mediante un constructor o la función SetDefaultValue.

CAnimationRect::m_bFixedSize

Este miembro se usa para especificar si el rectángulo tiene un tamaño fijo.

BOOL m_bFixedSize;

Comentarios

Si el valor de este miembro es TRUE, el tamaño del rectángulo será fijo y los valores derecho e inferior se volverán a calcular cada vez que la esquina superior izquierda se mueva, en función del tamaño que se fije. Establezca este valor en TRUE para mover el rectángulo fácilmente por la pantalla. En este caso, se omitirán las transiciones que se aplican a las coordenadas derecha e inferior. El tamaño se almacena internamente al construir el objeto o al llamar a la función SetDefaultValue. De manera predeterminada, el valor de este miembro se establece en FALSE.

CAnimationRect::m_bottomValue

Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite inferior de un rectángulo de animación.

CAnimationVariable m_bottomValue;

CAnimationRect::m_leftValue

Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite izquierdo de un rectángulo de animación.

CAnimationVariable m_leftValue;

CAnimationRect::m_rightValue

Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite derecho de un rectángulo de animación.

CAnimationVariable m_rightValue;

CAnimationRect::m_szInitial

Este miembro se usa para especificar el tamaño inicial de un rectángulo de animación.

CSize m_szInitial;

CAnimationRect::m_topValue

Este miembro se corresponde con la variable de animación encapsulada donde se representa el límite superior de un rectángulo de animación.

CAnimationVariable m_topValue;

CAnimationRect::operator RECT

Este operador se usa para convertir a un objeto CAnimationRect en un objeto RECT.

operator RECT();

Valor devuelto

El valor devuelto se corresponderá con el valor actual del rectángulo de animación como objeto RECT.

Comentarios

Al usar esta función, se llama internamente a la función GetValue. Si por algún motivo se produce un error en la función GetValue, en el objeto RECT que se devuelva se incluirán los valores predeterminados de todas las coordenadas del rectángulo.

CAnimationRect::operator=

Este operador se usa para asignar un objeto de rectángulo a un objeto CAnimationRect.

void operator=(const RECT& rect);

Parámetros

rect
El valor de este parámetro se corresponde con el nuevo valor del rectángulo de animación.

Comentarios

Este proceso de asignación debe realizarse antes del inicio de una animación, ya que al usarlo se llama a la función SetDefaultValue y, gracias a esta, se vuelven a crear los objetos COM subyacentes de los componentes de color 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.

CAnimationRect::SetDefaultValue

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

void SetDefaultValue(const CRect& rect);

Parámetros

rect
El valor de este parámetro se usa para especificar nuevos valores predeterminados para los lados izquierdo, superior, derecho e inferior.

Comentarios

Use esta función para establecer un valor predeterminado en el objeto de animación. Al usar estos métodos, se asignan valores predeterminados a los límites del rectángulo. 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