In This Topic ▼

LAnimationWindow::MovePreviousFrame

Summary

Moves to the previous frame in the animation object, if one exists.

Syntax

#include "ltwrappr.h"

virtual L_INT LAnimationWindow::MovePreviousFrame()

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

You can use this function, if the animation in not currently playing, to move to the previous item in the bitmap list.

The previous bitmap becomes the active bitmap and is displayed.

If animation events are enabled, this function triggers the EVENT_MOVE_PREV event.

Required DLLs and Libraries

LTDIS
LTDLG
LTEFX
LTFIL
LTIMG
LTSCR
LTTWN
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

Example

L_INT LAnimationWindow_MovePreviousFrameExample(HWND hWndParent) 
{ 
   L_INT nRet; 
 
   LBase::LoadLibraries(LT_ALL_LEADLIB);  
 //make sure all libraries are loaded 
 
   LAnimationWindow MyAnimation; 
   MyAnimation.SetFileName(MAKE_IMAGE_PATH(TEXT("eye.gif"))); 
 
 
   nRet = MyAnimation.Load(); 
   if (nRet==SUCCESS) 
 
   { 
      MyAnimation.CreateWnd(hWndParent,0, WS_VISIBLE|WS_CHILD|WS_BORDER,0,0,300,300); 
 
      nRet = MyAnimation.MoveLastFrame(); 
      if(nRet != SUCCESS) 
         return nRet; 
 
      if (MyAnimation.IsPreviousFrameAvailable()) 
 
      { 
 
         nRet = MyAnimation.MovePreviousFrame(); 
         if(nRet != SUCCESS) 
            return nRet; 
 
         MessageBox(hWndParent, TEXT("This frame is previous to last"),TEXT("Example"), MB_OK | MB_ICONINFORMATION); 
 
      } 
 
      else 
         MessageBox(hWndParent, TEXT("Previous frame not available"),TEXT("Example"), MB_OK | MB_ICONINFORMATION); 
 
   } 
   else 
      return nRet; 
 
   return SUCCESS; 
}