CAnimationRect (clase)
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
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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de