ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / Windows functions / Project functions
  • Loading an external component
  • Finding the external component to load
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Specifies the access path to an external component of project. This external component is not loaded.
Note The loading mode of the external component (when the project is launched, or when an element of the external component is used for the first time) is defined when the external component is integrated into the project.
Example
// Chemin d'accès au composant
ResChemin is int
ResChemin = ComponentLocate(MonComposant, "C:\MesComposants")
SWITCH ResChemin
	CASE cisAbsent :
	Error("Le composant spécifié n'est pas présent dans le répertoire indiqué")
	CASE cisVersionTooOld, cisVersionTooRecent :
	Error("La version du composant est incompatible avec l'exécutable")
	CASE cisLoaded :
	Info("Le composant spécifié est déjà chargé")
	CASE cisReady :
	Info("Le composant spécifié est disponible")
END
Syntax
<Result> = ComponentLocate(<Component name> , <Access path to component>)
<Result>: Integer constant
Status report of operation:
cisAbsentThe external component is not found in the specified path.
cisLoadedThe external component is already loaded. ComponentLocate has no effect.
cisReadyThe external component is available and usable.
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
Name of the external component (displayed in the editor) whose access path must be specified. A WLanguage error occurs if the name of the external component is unknown.
<Access path to component>: Character string
Directory of the external component (WDK file). This directory may (or may not) end with a "\". A full path, a relative path or a UNC path can be used.
Remarks

Loading an external component

The load mode of the external component (when starting the project or during the first use of a component element) is defined when the external component is included in the project.
To change the loading mode:
  1. In the "Project explorer" pane:
    • select the "External components" folder.
    • right-click to open the folder context menu
    • select "List of external components imported into the project".
  2. In the window that appears, select the desired external component and click "Description".
  3. Change the load mode ("Component load mode" option).
Reminder When an external Component is loaded, the following events are executed:
  • declaration event of the classes of the component.
  • declaration event of the sets of procedures of the component.
  • initialization event of the component.

Finding the external component to load

When loading the external component, the external component will be sought:
  • first, in the directory specified in the <Component directory> of ComponentLoad.
  • then, in the directory specified in <Component directory> of ComponentLocate.
  • then, in the directory specified in "<Component name>.INI". For more details on this file, see Deploying an application that uses an external component.
  • finally, in the EXE directory of the project.
Component: wd300vm.dll
Minimum version required
  • Version 10
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 03/27/2025

Send a report | Local help