IKSxfP21FileLoad

This function loads vector image data from a SFX p21 format file.

[C++Builder/Visual C++] HANDLE IKSxfP21FileLoad(LPCTSTR FileName, long Width, long Height, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button);

[Delphi] function IKSxfP21FileLoad(FileName: PChar; Width, Height: Longint; UserProc: LONG_PTR; Caption, Message, Button: PChar): THandle;

[Visual Basic] Function IKSxfP21FileLoad(ByVal FileName As String, ByVal Width As Long, ByVal Height As Long, ByVal UserProc As Long, ByVal Caption As String, ByVal Message As String, ByVal Button As String) As Long

Parameters

Name	Explanation
FileName	The name of the image file that is loaded into the memory
Width	The width of the loaded image (in pixels)
Height	The height of the loaded image (in pixels)
UserProc	The address of the user function (If not using the user function then set to 0)
Caption	Sets the text displayed in the title bar of the progress dialog box
Message	Sets the message displayed in the progress dialog box
Button	Sets the name of the button displayed in the progress dialog box

Return Value

Returns the image handle of the vector image if successful. Returns 0 if unsuccessful.

Explanation

The IKSxfP21FileLoad function loads vector image data from a SXF p21 fromat file into the memory. To load vector image data from an SXF Sfc file, please use the IKSxfSfcFileLoad function. If the Width parameter is 0 or less, then the default image width of 800 is used. Likewise, if the Height parameter is 0 or less, then the default image height of 600 is used.

If the user function is set or if the Caption, Message, and Button parameters are blank then the Progress dialog box is not displayed. If the Progress dialog box is displayed, it indicates the percentage of the current process completed. For more information about the user function please refer to the Definition of User Function in the Ik9File.dll, Ik9FileA.dll, Ik9File64.dll, Ik9File64A.dll section.

To execute this function, you must first execute the Ik9VectCom.dll, Ik9VectComA.dll, Ik9VectCom64.dll, or Ik9VectCom64A.dll's IKVectorGdipStart function.

Note: When a vector image is loaded, the ratio of the height and width of the original image is maintained and the largest pixel size of the image is scaled within the area defined by the Height and Width parameters.