Property Value
The width, in pixels, of the vector image that is being displayed as the background image in the ImageKit Control. (default is 0).Explanation
The BackgroundImageVectorWidth property sets the width of the vector image that is being displayed in the ImageKit Control as the background image.
If a DXF or SXF image is set in the BackgroundImageFile
property:
If 0 or less is set in the either the BackgroundImageVectorHeight
property or the BackgroundImageVectorWidth property, then
the background image will have a height of 600 and a width of
800.
If an EMF, SVG, or WMF image is set in the BackgroundImageFile
property:
If 0 or less is set in the either the BackgroundImageVectorHeight
property or the BackgroundImageVectorWidth property, then
the background image size will be determined by the height and
width values stored in the image file.
Note: The actual display size will be the largest size possible
to fit within the rectangle specified while maintaining the
original height/width ratio.
The BackgroundImageVectorHeight
property value and the BackgroundImageVectorWidth property
value must be set prior to the BackgroundImageFile
property.
Example Code
In C++Builder:
//set the background image
VImageKit1->BarkgroundImageVectorWidth = 640;
VImageKit1->BarkgroundImageVectorHeight = 480;
VImageKit1->BackgroundImageFile = "C:\\BackImage.emf";
//set the transparent color in the base image to white
VImageKit1->TransBlue = 255;
VImageKit1->TransGreen = 255;
VImageKit1->TransRed = 255;
VImageKit1->Transparent = true;
In Delphi:
//set the background image
VImageKit1.BarkgroundImageVectorWidth := 640;
VImageKit1.BarkgroundImageVectorHeight := 480;
VImageKit1.BackgroundImageFile := 'C:\BackImage.emf';
//set the transparent color in the base image to white
VImageKit1.TransBlue := 255;
VImageKit1.TransGreen := 255;
VImageKit1.TransRed := 255;
VImageKit1.Transparent := True;
Setting this value
This value can be set at run-time.
Retrieving this value
This value can be retrieved at run-time.