METHOD SET COMMENTS

Home

4D v18

METHOD SET COMMENTS


METHOD SET COMMENTS ( path ; comments {; *} )

Parameter	Type	Description
path	Text, Text array	Text or Text array containing one or more method path(s)
comments	Text, Text array	Comments of designated method(s)
*	Operator	If passed = command applies to host database when executed from a component (parameter ignored outside of this context)

Description

The METHOD SET COMMENTS command replaces the comments of the method(s) designated by the path parameter by those specified in the comments parameter.

The comments modified by this command are those specified in the 4D Explorer (not to be confused with lines of comments in the code). They contain styled text.

These comments can only be generated:

in project databases, for triggers only,
in binary databases, for triggers, project methods and form methods.

Note: Forms and form methods share the same comments..

You can use two types of syntaxes, based either on text arrays, or text variables:

 C_TEXT(tVpath) // text variables

 C_TEXT(tVcomments)

 METHOD SET COMMENTS(tVpath;tVcomments) // comments for a single method

 ARRAY TEXT(arrPaths;0) // text arrays

 ARRAY TEXT(arrComments;0)

 METHOD SET COMMENTS(arrPaths;arrComments) // comments for several methods

You cannot mix the two syntaxes.

If you pass an invalid pathname, an error is generated.

You can execute this command from a component, but in this case, you must pass the * parameter because access to the component code is read-only. If you omit the * parameter in this context, the error -9763 is generated

Example

Add a modification date to an existing trigger comment:

 METHOD GET COMMENTS("[trigger]/Table1";$comments)

 $comments:="Modif:"+String(Current date)+"\r"+$comments

 METHOD SET COMMENTS("[trigger]/Table1";$comments)