This function displays the image in a window usint the window handle.
[C++Builder] BOOL
IKImageOutToHwnd(HWND hWnd, HANDLE Handle, COLORREF Color, BOOL
Aspect, BOOL DXFBlack);
[Delphi] function
IKImageOutToHwnd(hWnd: HWND; Handle: THandle; Color: COLORREF;
Aspect, DXFBlack: LongBool): LongBool;
Parameters
| Name | Explanation |
|---|---|
| hWnd | The window handle |
| Handle | The image handle of the raster or vector image |
| Color | Sets the background color of the window |
| Aspect | Maintains the height to width ratio [True (nonzero): Ratio maintained, False (0): Ratio not maintained] |
| DXFBlack | In DXF images only, this sets black to white and white to black. [True (nonzero): Black and white are exchanged, False (0): Black and white are not exchanged] |
Return Value
Returns True (nonzero) if successful. Returns False (0) if unsuccessful.
Explanation
The IKGetImageOutToHwnd function displays the image in a window using the window handle. If the image does not fit within the window's canvas the image will be scaled to fit. If the Aspect parameter is False, the image will be stretched to fill the window canvas, i.e. the height to width ratio will not be maintained. If the Aspect parameter is True, the image will be displayed within the window canvas with the height to width ratio maintained. To set the background color of the window, enter the appropriate RGB (red, green, blue) values in the Color parameter.
The differences from the ImageKit5
| Function Name | Parameters |
|---|---|
| IK5ImageOutToHwnd: | hDC, Handle, Color, Aspect |
| IKImageOutToHwnd: | hDC, Handle, Color, Aspect, DXFBlack |