PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Home | Sign in | English US

  • Finding out the version number of the external component
  • Information about a WINDEV/WEBDEV library
  • Searching for the patch number accepted by an external component
  • Searching for the patch number accepted by the WINDEV/WEBDEV elements
  • External components sharing the context of the project
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
Returns information about an external component. This external component corresponds to:
  • an external component included in the current project.
  • to the current project used to define and generate an external component.
  • an external component not included in the current project.
Note: For a WINDEV/WEBDEV library (WDL file), this function is also used to know:
  • the version number.
  • Versions 23 and later
    the generation date.
    New in version 23
    the generation date.
    the generation date.
// Information about the OverviewComp component
Trace(ComponentInfo(OverviewComp, ciVersion))
// Information about the OverviewComp component
// found in "C:\MyDirectory"
Trace(ComponentInfo(OverviewComp, ciVersion, "C:\MyDirectory"))
// Information about the current component
Trace(ComponentInfo("", ciVersion))
// Information about an external component
Trace(ComponentInfo("", ciVersion, "D:\MyComponents\MyComponent.WDK"))
Syntax

Finding out information about an external component included in the current project Hide the details

<Result> = ComponentInfo(<Component name> , <Sought information> [, <Component directory>])
<Result>: Character string
Requested information.
<Component name>: Character string
Logical name of the external component (displayed in the editor). A WLanguage error occurs if the name of external component is unknown.
<Sought information>: Integer constant
Information about the component:
Versions 15 and later
ciGlobalCommponent
New in version 15
ciGlobalCommponent
ciGlobalCommponent
Load mode of the external component:
  • True if the external component was loaded globally.
  • False if the external component is isolated
ciLoadedAtStartupLoad the external component as soon as the project is started:
  • True if the external component was loaded when starting the project.
  • False otherwise.
ciCopyrightCopyright of the component
Versions 23 and later
ciGenerationDate
New in version 23
ciGenerationDate
ciGenerationDate
Date on which the component or library (WDL file) was generated.
ciStatusStatus of external component. This status corresponds to one of the following variables:
  • cisAbsent: WDK file known to the project but not found physically
  • cisLoaded: WDK file already loaded
  • cisUnknown: WDK file unknown to the project
  • cisReady: WDK file ready to be used
  • cisVersionTooOld: WDK file too old
  • cisVersionTooRecent: WDK file too recent and not compatible
ciCaptionCaption of the component.
ciPhysicalNameName of physical file associated with the external component.
ciPatchNumberNumber of first patch accepted by the external component.
ciOwnerCompany that publishes the external component.
ciCompanyCompany that publishes the external component (same as ciOwner)
ciVersionReal version of the component or library (WDL file).
ciCompatibleVersionCompatible version of the component
ciInternalVersionVersion of WINDEV or WEBDEV that was used to create the component
ciProjectVersionVersion of the component that was used to compile the project
<Component directory>: Optional character string
Directory of the <Component name> external component (WDK file). This parameter is ignored if <Component name> is already loaded.

Getting information about the current project used to define and generate an external component Hide the details

<Result> = ComponentInfo(<Component name> , <Sought information>)
<Result>: Character string
Requested information.
<Component name>: Character string
Empty string (""). The current external component will be used. This project is used to define and generate an external component.
<Sought information>: Integer constant
Information available about the current external component:
Versions 15 and later
ciGlobalCommponent
New in version 15
ciGlobalCommponent
ciGlobalCommponent
Load mode of the external component:
  • True if the external component was loaded globally.
  • False if the external component is isolated
ciCopyrightCopyright of external component.
Versions 23 and later
ciGenerationDate
New in version 23
ciGenerationDate
ciGenerationDate
Date on which the component or library (WDL file) was generated.
ciStatusStatus of external component. This status corresponds to the cisLoaded constant: WDK file already loaded.
ciCaptionCaption of external component.
ciLogicalNameLogical name of external component.
ciPhysicalNameName of physical file associated with the external component.
ciPatchNumberNumber of first patch accepted by the external component.
ciOwnerCompany that publishes the external component.
ciVersionReal version of the external component or library (WDL file).
ciCompanyCompany that publishes the external component (same as ciOwner).
ciCompatibleVersionCompatible version of external component.
ciInternalVersionWINDEV or WEBDEV version that was used to create the external component.
ciProjectVersionVersion of external component that was used to compile the project.

Getting information about an external component not included in the current project Hide the details

<Result> = ComponentInfo(<Component name> , <Sought information> [, <Component physical name>])
<Result>: Character string
Requested information.
<Component name>: Character string
Empty string (""). The external component named <Component physical name> will be used.
<Sought information>: Integer constant
Information available about the external component:
Versions 15 and later
ciGlobalCommponent
New in version 15
ciGlobalCommponent
ciGlobalCommponent
Load mode of the external component:
  • True if the external component was loaded globally.
  • False if the external component is isolated
ciCopyrightCopyright of external component.
Versions 23 and later
ciGenerationDate
New in version 23
ciGenerationDate
ciGenerationDate
Date on which the component or library (WDL file) was generated.
ciStatusStatus of external component. This status corresponds to one of the following constants:
  • cisAbsent: WDK file not found physically
  • cisReady: WDK file ready to be used
ciCaptionCaption of external component.
ciLogicalNameLogical name of external component.
ciPhysicalNameName of physical file associated with the external component.
ciPatchNumberNumber of first patch accepted by the external component.
ciOwnerCompany that publishes the external component.
ciCompanyCompany that publishes the external component (same as ciOwner).
ciVersionReal version of the external component or library (WDL file).
ciCompatibleVersionCompatible version of external component.
ciInternalVersionWINDEV or WEBDEV version that was used to create the external component.
ciProjectVersionInformation not available. <Result> will be equal to "" (empty string).
<Component physical name>: Optional character string
Name and full path of the external component (WDK file).
Remarks

Finding out the version number of the external component

If the version of an external component loaded when starting the project is incorrect in relation to the project, a WLanguage error occurs before running the initialization code of the project.
To test the version of an external component by programming (ciVersionXX or ciStatus constant), the external component must be loaded when first used. The load mode of an external component is defined in the description window of the external component imported into the project ("General" tab).

Information about a WINDEV/WEBDEV library

To find out:
  • the version number of a WINDEV/WEBDEV library (WDL file), use the following syntax:
    ComponentInfo("", ciVersion, <WDL physical name>)
  • Versions 23 and later
    the generation date of a WINDEV/WEBDEV library (WDL file), use the following syntax:
    ComponentInfo("", ciGenerationDate, <WDL physical name>)
    New in version 23
    the generation date of a WINDEV/WEBDEV library (WDL file), use the following syntax:
    ComponentInfo("", ciGenerationDate, <WDL physical name>)
    the generation date of a WINDEV/WEBDEV library (WDL file), use the following syntax:
    ComponentInfo("", ciGenerationDate, <WDL physical name>)

Searching for the patch number accepted by an external component

To be taken into account:
  • A patch must have been created from the same project configuration as the external component.
  • The patch number of a patch must be greater than or equal to the patch number of the external component.

Searching for the patch number accepted by the WINDEV/WEBDEV elements

  • To find out the patch number of the first patch accepted by the application (EXE file), use the following syntax:
    ComponentInfo( "", ciPatchNumber, <Executable physical name>)
  • To find out the patch number of the first patch accepted by the library (WDL file), use the following syntax:
    ComponentInfo( "", ciPatchNumber, <WDL physical name> )
Note: The full example of this function presents a solution for listing the patches used by an application.
Note: To be taken into account:
  • A patch must have been created from the same project configuration as the executable or the library.
  • The patch number of a patch must be greater than or equal to the patch number of the executable or library.

External components sharing the context of the project

The information returned by ComponentInfo is not available for the components that share the project context. The function returns "" (empty string).
Component : wd240vm.dll
Minimum required version
  • Version 9
This page is also available for…
Comments
Exemplo

SAI_projeto=ComposantInfo("",ciVersion,EDT_componente)+CR // Frances
SAI_projeto=ComponentInfo("",ciVersion,EDT_componente)+CR // Ingles

//Blog com Video e Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/01/windev21-curso-228-informacoes-do.html
De matos AMARILDO
Jan. 17 2016