PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US
  • Overview
  • Characteristics of an external component
  • What is an external component made of?
  • What is included in 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
Overview
An external component is a set of WINDEV, WEBDEV or WINDEV Mobile elements: windows, pages, reports, analysis, ... This set of elements performs a specific feature. For example, a component can correspond to one of the following features:
  • Sending faxes,
  • Sending emails,
  • ...
An external component can be redistributed to other WINDEV, WEBDEV or WINDEV Mobile developers (free of charge or not). These developers will be able to easily include the feature proposed by the component in their application. The component will be included in the application and distributed with the application.
For the multilingual applications, a distributed external component can be translated via WDMSG from the project that uses the component.
Note: To optimize the organization of your projects, you have the ability to use the internal components. The internal components allow you to group your resources according to specific topics.
Characteristics of an external component
When creating the external component, the author specifies:
  • the component elements visible (or not) to the component user. The visible elements will be accessible in the project graph or by programming.
  • the mode for using the component (how to use the component, the parameters used to access the component features, ...). A short documentation (to be completed) is automatically generated and associated with the component.
Caution: A component differs from a supercontrol. The supercontrol can only be made of controls while a component is made of windows, pages, reports, ... In most cases, the component expects parameters, processes them and returns a result to the application that is using it. Furthermore, unlike a supercontrol, a component has a specific setup.
Note: Several sample components are supplied with WINDEV, WEBDEV and WINDEV Mobile.
These components are accessible from the "Wizards, Examples and Components" pane ("Components" option). See Managing the components from the "Wizards, Examples and Components" pane for more details.These components are accessible from the "Project" pane of the editor: on the "Project" pane, in the "Project" group, expand "Import" and select "An external component .. Utility or sample component". The corresponding projects can be opened from the home window.

What is an external component made of?

An external component is defined and generated from an existing WINDEV, WEBDEV or WINDEV Mobile project. It can then be included in other WINDEV, WEBDEV or WINDEV Mobile projects.
All component elements are independent of the project in which the component is included. The external component can have its own analysis, its windows, its reports, its files, ...
When creating the generation of the external component, all you have to do is specify whether these elements can be handled (or not) in the project that includes this component.
The external component includes three files:
<ComponentName>.WDKComponent file. Contains all the elements of the external component.
This file is required to include the external component in a project.
This file must also be supplied in the client version of the application that uses the external component.
<ComponentName>.WDIDescription of the component (when developing applications only).
This file is required to include the external component in a project.
This file must not be supplied in the client version of the application that uses the external component.
<ComponentName>.WDOOptional file
File in text format containing the list of additional elements supplied with the external component (data files, .INI files, ...). See The WDO file for more details.
What is included in an external component?
An external component contains:
  • the different elements to distribute (windows, reports, ...). These elements can be accessible (or not) when importing the component into a WINDEV, WEBDEV or WINDEV Mobile project. These elements cannot be modified from the project that uses the component.
  • a short description of the component.
  • a help allowing you to reuse this component. This help is generated from the code comments.
Note: By default, if an external component uses an analysis, data files, ... the HFSQL functions will handle these elements in an independent HFSQL context. These parameters can be modified in the advanced options of the component. See Advanced options of an external component for more details.
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment