LAnimationWindow::MoveFirstFrame

#include "ltwrappr.h"

virtual L_INT LAnimationWindow::MoveFirstFrame()

Moves to the first frame in the animation object.

Returns

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 first item in the bitmap list. The first bitmap becomes the active bitmap and is displayed.

If animation events are enabled, this function triggers the EVENT_MOVE_FIRST 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.

See Also

Functions:

LAnimationWindow::LAnimationWindow, LAnimationWindow::IsPlaying, LAnimationWindow::MoveNextFrame, LAnimationWindow::MovePreviousFrame, LAnimationWindow::MoveLastFrame, LAnimationWindow::MoveToFrame, LAnimationWindow::AnimateEvent , Class Members

Example

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName
L_INT LAnimationWindow_MoveFirstFrameExample(HWND hWndParent)
{
   L_INT nRet;
   LBase::LoadLibraries(LT_ALL_LEADLIB); //make sure all libraries are loaded
   LAnimationWindow MyAnimation;
   WRPUNLOCKSUPPORT();
   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.MoveFirstFrame();
      if (nRet ==SUCCESS)
      {
         MessageBox(hWndParent, TEXT("This is the first frame"),TEXT("Example"), MB_OK | MB_ICONINFORMATION);
      }
      else
      {
         MessageBox(hWndParent, TEXT("Failed to move to first frame"),TEXT("Example"), MB_OK | MB_ICONINFORMATION); 
         return nRet; 
      }
   }
   else
      return nRet; 
   return SUCCESS;
}