PC SOFT

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

  • Overview
  • Which comments are taken into account?
  • When is the component documentation generated?
  • How to access the component documentation?
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 must necessarily be supplied with a documentation.
WINDEV, WEBDEV and WINDEV Mobile simplify the creation of this documentation by proposing:
  • A general overview of the component. This general overview is typed when generating the component.
    When the component is used in a WINDEV application, this overview will be visible when hovering the component found in the "Wizards, Examples and Components" pane. See Managing the components from the "Wizards, Examples and Components" pane for more details.
  • An automatic generation of the technical documentation from the comments inserted into the code of the component elements.
Which comments are taken into account?
The following comments are automatically taken into account for the documentation of the component:
  • The comments found at the beginning of WLanguage procedures.
  • The comments found at the beginning of the following processes:
    • Initialization code of windows or pages,
    • Initialization code of reports,
    • Initialization code of classes,
    • Initialization code of sets of procedures.
When is the component documentation generated?
The documentation of the component is generated during the first generation of the component ("Workshop .. External Component .. Generate a component").The documentation of the component is generated during the first generation of the component: click the generation icon among the quick access buttons.
When generating the documentation:
  • the comments found in the code are used to create the documentation.
  • if no comment is found in your code, the accessible elements of the component will be automatically documented by specifying the input/output parameters expected by each element. The corresponding comments are automatically created in the different elements.
Note: You have the ability to regenerate the documentation associated with the component whenever the component is regenerated ("Regenerate" button).

Caution: The modifications performed in the generation wizard will be deleted if you click the "Regenerate" button.
How to access the component documentation?
The general overview of the component is automatically displayed when hovering the component found in the "Wizards, Examples and Components" pane.The general overview of the component is automatically displayed in the description window of the component.
The technical documentation of the component is available:
  • when a component is included in a project ("Workshop .. External component .. Import a component into the project").when a component is included in a project: on the "Project" pane, in the "Project" group, expand "Import" and select "An external component".
    • in the description of the components included in the project ("Workshop .. External component .. List of components imported into the project"). The [Description] button is used to get information and documentation about the component.
    in the description of the components included in the project.
    In the project explorer:
    • Select the "External components" folder.
    • Display the popup menu (right mouse click).
    • Select "List of components included in the project".
      The [Description] button is used to get information and documentation about the component.
The documentation specific to an element of the component (window, ...) is available:
  • by double-clicking this element (from the "Project explorer" pane or from the project graph) or by pressing [F2] from the code of this element.
  • in the list of components included in the project ("Workshop .. External component .. List of components imported into the project").from the project explorer:
    • select the "External components" folder.
    • Display the popup menu (right mouse click).
    • Select "List of components included in the project".
Minimum required version
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment