4D v14.3

METHOD GET PATHS FORM

Home

 
4D v14.3
METHOD GET PATHS FORM

METHOD GET PATHS FORM 


 

METHOD GET PATHS FORM ( {aTable ;} arrPaths {; filter}{; stamp}{; *} ) 
Parameter Type   Description
aTable  Table in Table reference
arrPaths  Text array in Array of method paths and names
filter  Text in Name filter
stamp  Longint variable in Minimum value of stamp
in New current value
Operator in If passed = command applies to host database when executed from a component (parameter ignored outside of this context)

The METHOD GET PATHS FORM command fills the arrPaths array with the internal pathnames and names of the methods for all form objects as well as form methods. Form methods are labeled {formMethod}.

Only objects containing code are listed. For example, buttons that are only associated with a standard action are not returned.

If you pass the aTable parameter, the command returns the objects of the table forms associated with this table. If you omit this parameter, the command returns objects of the database project forms. 

You can limit this list of forms by passing a comparison string in the filter parameter: in this case, only forms whose names match the filter are returned. You can use the @ character in order to specify "starts with", "ends with" or "contains" type filters. If you pass an empty string, the filter parameter is ignored.

The stamp parameter lets you only get the paths of methods modified after a specific point in time. As part of a version control system, this means that you can update only methods that were modified since the last backup.
Here is how it works: 4D maintains a counter of method modifications. Each time a method is created or saved again, this counter is incremented and its current value is stored in the internal stamp of the method.
If you pass the stamp parameter, the command only returns methods whose stamp is greater than or equal to the value passed in this parameter. Moreover, the command returns, in stamp, the new current value of the modification counter, i.e. the highest value. If you save this value, you can pass it the next time this command is called so that you only get new or modified methods.

If the command is executed from a component, it returns by default the paths of the component methods. If you pass the * parameter, the array contains the paths of the methods of the host database.

Note: The command does not list objects of inherited forms or of subforms.

If the command detects a duplicated method name, the error -9802 is generated ("Object path not unique"). In this case, it is advisable to use the MSC in order to verify the database structure.

List of all objects of the "input" form for the [Employees] table. Note that table form methods (and project form methods) are processed as objects belonging to the form:

 METHOD GET PATHS FORM([Employees];arrPaths;"input")
  // Contents of arrPaths (for example)
  // [tableForm]/input/{formMethod} -> Form method
  // [tableForm]/input/bOK -> Object method
  // [tableForm]/input/bCancel -> Object method

List of objects of the "dial" project form:

 METHOD GET PATHS FORM(arrPaths;"dial")

List of all objects of the "input" form for the [Employees] table from a component:

 METHOD GET PATHS FORM(([Employees];arrPaths;"input@";*)

 
PROPERTIES 

Product: 4D
Theme: Design Object Access
Number: 1168

 
HISTORY 

Created: 4D v13

 
SEE ALSO 

FORM GET NAMES

 
ARTICLE USAGE

4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)