LBitmapBase::EnableAlwaysEndNotification

#include "ltwrappr.h"

virtual L_BOOL LBitmapBase::EnableAlwaysEndNotification(bEnable=TRUE)

L_BOOL bEnable;

/* flag that indicates whether to allow the calling of the LBitmapBase::EndChanging member function */

Enables or disables the calling of the LBitmapBase::EndChanging member function.

Parameter

Description

bEnable

Flag that indicates whether to enable or disable the calling of the LBitmapBase::EndChanging member function if the operation on the bitmap failed. Possible values are:

 

Value

Meaning

 

TRUE

The LBitmapBase::EndChanging() member function will be called even if the operation function returned an error code.

 

FALSE

The LBitmapBase::EndChanging() member function will not be called if the operation function fails.

Returns

The previous setting.

Comments

Call this function to enable or disable the calling of the LBitmapBase::EndChanging function if the operation on the bitmap failed. The EndChanging function is normally called only if the operation was successful. Calling EnableAlwaysEndNotification with bEnable = TRUE will cause the EndChanging() member function to be called even if the operation function returned an error code.

Required DLLs and Libraries

LTDIS
LTFIL

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:

LBitmapBase::StartChanging, LBitmapBase::EndChanging, LBitmapBase::EnableChangeNotification, LBitmapBase::IsChangeNotificationEnabled, LBitmapBase::IsAlwaysEndNotification, Class Members

Example

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName
L_INT LBitmapBase__EnableAlwaysEndNotificationExample()
{
   L_INT nRet;
   LBitmapBase  MyBitmap;
   nRet =MyBitmap.Load(MAKE_IMAGE_PATH(TEXT("image1.cmp")),24);
   if(nRet !=SUCCESS)
      return nRet;
   if(MyBitmap.IsAlwaysEndNotification()==FALSE)
      MyBitmap.EnableAlwaysEndNotification(TRUE);
   return SUCCESS;
}