LBitmapWindow

Description

The LBitmapWindow class is derived from LBitmap, and extends it by adding full user interface (UI) functionality. You can consider this class as a full windowed control that is capable of displaying bitmaps. The LBitmapWindow class provides the following functionality:

Bitmap Displaying
Scrolling (which can be enabled or disabled)
Palette handling
Region drawing & floater bitmap
Zooming
Pan Window
Keyboard handling
Various UI tools including pan image, zoom in/out on mouse click, drawing zoom rects, and drawing regions of interest
Painting while loading of a bitmap from file
Paint effects, transitions, gradients, and patterns
Windows Drag/Drop operations for loading files

Using command notification messages, the LBitmapWindow object can be used in a manner similar to standard Windows controls for dialogs. By overriding the virtual functions provided by LBitmapWindow, you can use LBitmapWindow objects as a regular window, which handles most messages for you.

For more information on the two ways in which LBitmapWindow objects can be used, refer to Using LBitmapWindow as a Window, Using LBitmapWindow as a Control, and LBitmapWindow:Window vs Control.

The LBitmapWindow control handles processing the mouse messages automatically when the internal tool type is not TOOL_USERMODE. Use LBitmapWindow::SetToolType, LBitmapWindow::SetCursor, LBitmapWindow::OnSetCursor to set tools and cursor types for window actions.

Double clicking the floater of an LBitmapWindow object will cause the floater to be pasted in its place and reactivated again for additional drag operations, while clicking beside the floater will cause the floater to be pasted and then freed.

Some inherited functions will work only on an LBitmapWindow object's floater (if a one exists). These functions do not affect the main displayed bitmap. For a list of these functions, refer to LBitmapWindow Inherited Floater Functions.

Certain keys are handled by the LBitmapWindow object when the bitmap window control has the focus. For a list of these keys and the associated action, refer to LBitmapWindow Keys.

Required Libraries

You must load all required libraries using LBase::LoadLibraries before using the classes.

LTKRN
LTDIS
LTDLGKRN
LTDLGIMG
LTDLGEFX
LTDLGWEB
LTDLGFILE
LTDLGIMGEFX
LTDLGCLR
LTDLGIMGDOC
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.

For a listing of the exact LTDLGXXX DLLs and Libraries needed, based on the toolkit version, refer to Common Dialog Files To Be Included With Your Application.