SimpleDispCtrl (ImageKit Control/ Custom Property)

This property allows you to limit the ImageKit Control to displaying only to the base image

[Visual Basic] imagekitcontrolname.SimpleDispCtrl [= Boolean ]

[Visual C++] [BOOL = ]imagekitcontrolname.GetSimpleDispCtrl()
imagekitcontrolname.SetSimpleDispCtrl(BOOL Val)

Property Value

Value	Explanation
True	Limits the ImageKit Control to displaying only the base image.
False (default)	ImageKit Control functionality is as normal which means it can display the, background image, the base image and the various image layer images.

Explanation

The SimpleDispCtrl property allows you to limit the ImageKit Control to displaying only to the base image. The default value is False.

When not using the editing functionality (either the Image Editing Toolbars or the HdcMemory property) or when not displaying multiple image layers, setting the SimpleDispCtrl property to True results in increased speed displaying images. When the SimpleDispCtrl property is True, the Grid functionality is disabled. (The base image refers to the image set in the ImageHandle property)

Sample code to limit the ImageKit Control to only the base image...

In Visual Basic:

    ImageKit1.LayerNo = -1
    ImageKit1.DisplayMode = ikActualSize
    ImageKit1.File.FileName = "c:\abc.jpg"
    ImageKit1.File.LoadFile ikLoad
    ImageKit1.Edit.EditEnable = False
    ImageKit1.SimpleDispCtrl = True
    ImageKit1.DisplayImage  'Disabled when AutoDisplay is True

Setting this value

This value can be set at design-time and run-time.

Retrieving this value

This value can be retrieved at run-time.