LAnimationWindow::EnableLoop

#include "ltwrappr.h"

L_BOOL LAnimationWindow::EnableLoop(bEnableLoop=TRUE)

L_BOOL bEnableLoop;

/* flag that indicates whether to enable animation looping */

Enables or disables animation looping. If animation loop is enabled, animation playback will continuously loop through the items in the associated bitmap list.

Parameter	Description
bEnableLoop	Flag that indicates whether to enable animation looping. Possible values are:
	Value	Meaning
	TRUE	Enable animation looping.
	FALSE	Disable animation looping.

Returns

The previous state.

Comments

The setting for auto loop overrides this setting.

If auto loop is enabled, this function will have no effect.

If auto loop is disabled, then you can use this function to enable or disable animation playback looping for the class object.

Required DLLs and Libraries

LTDIS
LTDLG
LTEFX
LTFIL
LTIMG
LTISI
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.

See Also

Functions:	LAnimationWindow::LAnimationWindow, LAnimationWindow::IsLoopEnabled, LAnimationWindow::EnableAutoLoop, LAnimationWindow::PlayAnimation, Class Members
Topics:	Implementing Animation

Example

L_VOID TestFunction(HWND hWndParent)
{
   LBase::LoadLibraries(LT_ALL_LEADLIB); //make sure all libraries are loaded
   LAnimationWindow MyAnimation;

   WRPUNLOCKSUPPORT();

   //Set auto loop to TRUE
   MyAnimation.EnableLoop();
   MyAnimation.SetFileName(TEXT("eye.gif"));
   if (MyAnimation.Load()!=SUCCESS)
   {
      MessageBox(hWndParent, TEXT("Error loading file!"),TEXT("Sample"), MB_OK|MB_ICONSTOP);
      return;
   }
   MyAnimation.CreateWnd(hWndParent,0, WS_VISIBLE|WS_CHILD|WS_BORDER,0,0,300,300);

   MyAnimation.PlayAnimation();
   while (MyAnimation.IsPlaying())
   {
      L_BOOL bCanceled;

      L_BOOL bQuit = MyAnimation.DoEvents(&bCanceled);

      if (bCanceled || bQuit)
      {
         MyAnimation.StopAnimation();
         break;
      }
   }
}