PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Loading an external component
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Loads the specified external component in memory. This external component will be loaded in memory until the end of the application.
Notes:
  • The mode for loading the external component (when starting the project or when using a component element for the first time) is defined when the component is included in the project.
  • The following processes are run when the component is loaded:
    • process for declaring the classes of the external component.
    • process for declaring the sets of procedures of the external component.
    • initialization process of the external component.
Example
// Load the external component
ResLoad is int
ResLoad = ComponentLoad(MyComponent, "C:MyApplication")
SWITCH ResLoad
CASE cisAbsent:
Error("The specified path does not correspond to the specified external component")
CASE cisVersionTooOld, cisVersionTooRecent:
Error("The version of the external component is not compatible with the executable")
CASE cisLoaded:
Info("The external component is loaded")
END
Syntax
<Result> = ComponentLoad(<Component Name> [, <Component Directory> [, <Load Mode>]])
<Result>: Integer constant
Status report of the load operation:
cisAbsentThe external component is not found in the specified path.
cisLoadedThe external component was successfully loaded.
cisVersionTooOldThe version of the external component is too old. It is not compatible with the current executable.
cisVersionTooRecentThe version of the external component is too recent. It is not compatible with the current executable.
<Component Name>: Character string (with or without quotes)
Name of the external component (as it appears in the editor) to load. A WLanguage error occurs if the name of the external component is unknown.
<Component Directory>: Optional character string (with quotes)
Directory of the external component (WDK file) to load. This directory may (or may not) end with a "\". A full path, a relative path or a UNC path can be used.
If this parameter is not specified, the external component will be sought:
<Load Mode>: Optional Integer constant
Versions 15 and later
Load mode of external component. Corresponds to one of the following constants:
ccGlobalThe external component is loaded globally. For example, the same context will be used if the component is loaded by the project and by a component of the project.
ccIsolated
(Default value)
The external component is isolated. For example, if the component is loaded by the project and by a component of the project, each component will use a specific context.
New in version 15
Load mode of external component. Corresponds to one of the following constants:
ccGlobalThe external component is loaded globally. For example, the same context will be used if the component is loaded by the project and by a component of the project.
ccIsolated
(Default value)
The external component is isolated. For example, if the component is loaded by the project and by a component of the project, each component will use a specific context.
Load mode of external component. Corresponds to one of the following constants:
ccGlobalThe external component is loaded globally. For example, the same context will be used if the component is loaded by the project and by a component of the project.
ccIsolated
(Default value)
The external component is isolated. For example, if the component is loaded by the project and by a component of the project, each component will use a specific context.
Remarks

Loading an external component

The mode for loading the external component (when starting the project or when using a component element for the first time) is defined when the component is included in the project.
To modify this load mode:
  1. Select "Workshop .. External component .. List of components imported into the project".Display the list of external components imported into the project:
    • In the "Project explorer" pane, select the "External components" folder.
    • Display the popup menu of the folder and select "List of external components imported into the project".
  2. Select the requested component and click the "Description" button.
  3. Modify the load mode ("Load mode of component").
Reminder: The following processes are run when a component is loaded:
  • process for declaring the classes of the external component.
  • process for declaring the sets of procedures of the external component.
  • initialization process of the external component.
Components
WINDEVWEBDEV - Server codeReports and Queries wd230vm.dll
Linux wd230vm.so
Windows Mobile wp230vm.dll
Minimum required version
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment