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
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.