LBitmapWindow::DestroyZoomView

#include "ltwrappr.h"

L_INT LBitmapWindow::DestroyZoomView(uIndex)

L_UINT uIndex;

/* index of the zoomed view to be destroyed*/

Destroys the specified Zoom View, and releases all resources associated with it.

Parameter

Description

uIndex

Index of the zoomed view to be destroyed. This is a zero-based index.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

To attach a Zoom View to a window, call the LBitmapWindow::AddZoomView function.

When a Zoom View is no longer needed, call the LBitmapWindow::DestroyZoomView function to stop the specified Zoom View procedure and to detach it from the window handle.

If you need to destroy all the zoomed views that are attached to a specified window, destroy them from the last Zoom View to the first Zoom View. For example, if you have 5 Zoom Views associated with the specified window you need to do the following:

   L_UINT uCount,i;
   if(m_LAniWnd.HasZoomView ())
   {
      uCount = m_LAniWnd.GetZoomViewsCount ();

      for(i=0; i < uCount;++i)
      {
         m_LAniWnd.DestroyZoomView(uCount-i-1);
      }
   }

Required DLLs and Libraries

LTZMV

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:

LBitmapWindow::HasZoomView, LBitmapWindow::AddZoomView, LBitmapWindow::UpdateZoomView, LBitmapWindow::GetZoomViewProps, LBitmapWindow::GetZoomViewsCount, Class Members.

Topics:

Using the Zoom View

 

Raster Image Functions: Displaying Images

Example

L_INT LBitmapWindow__DestroyZoomViewExample(LBitmapWindow &BmpWnd)
{
   L_UINT uCount,i;
   if(BmpWnd.HasZoomView ())
   {
      uCount = BmpWnd.GetZoomViewsCount ();
      for(i=0; i < uCount;++i)
      {
         BmpWnd.DestroyZoomView (uCount-i-1);
      }
   }
   return SUCCESS;
}