4D Doc Center : METHOD RESOLVE PATH

4D v13.4

METHOD RESOLVE PATH


METHOD RESOLVE PATH ( path ; methodType ; ptrTable ; objectName ; formObjectName {; *} )

Parameter	Type	Description
path	Text	Path to resolve
methodType	Longint	Object type selector
ptrTable	Pointer	Table reference
objectName	Text	Name of form or database method
formObjectName	Text	Name of form object
*	Operator	If passed = command applies to host database when executed from a component (parameter ignored outside of this context)

Description

The METHOD RESOLVE PATH command parses the internal path name passed in the path parameter and returns its different components in the methodType, ptrTable, objectName, and formObjectName parameters.

The methodType parameter receives a value indicating the type of the method. You can compare this value with the following constants of the Design Object Access theme:

Constant	Type	Value	Comment
Path Database method	Longint	2	Path of database methods specified (English name). List of these methods: [databaseMethod]/onStartup [databaseMethod]/onExit [databaseMethod]/onDrop [databaseMethod]/onBackupStartup [databaseMethod]/onBackupShutdown [databaseMethod]/onWebConnection [databaseMethod]/onWebAuthentication [databaseMethod]/onWebSessionSuspend [databaseMethod]/onServerStartup [databaseMethod]/onServerShutdown [databaseMethod]/onServerOpenConnexion [databaseMethod]/onServerCloseConnection [databaseMethod]/onSystemEvent [databaseMethod]/onSqlAuthentication
Path Project form	Longint	4	Path of project form methods and all their object methods. Examples: [projectForm]/myForm/{formMethod} [projectForm]/myForm/button1 [projectForm]/myForm/my%2list [projectForm]/myForm/button1
Path Project method	Longint	1	Name of method. Example: MyProjectMethod
Path Table form	Longint	16	Path of table form methods and all their object methods. Example: [tableForm]/table_1/Form1/{formMethod} [tableForm]/table_1/Form1/button1 [tableForm]/table_1/Form1/my%2list [tableForm]/table_2/Form1/my%2list
Path Trigger	Longint	8	Path of database triggers. Example: [trigger]/table_1 [trigger]/table_2

The ptrTable parameter contains a pointer to a database table when the path references a table form method or a trigger.

The objectName parameter contains either:

A form name when the path references a table form or project form
A database method name when the path references a database method.

The formObjectName parameter contains a form object name when the path references an object method.

If the command is executed from a component, it considers by default that path designates a component method. If you pass the * parameter, then it considers that path designates a host database method.

Example 1

Resolution of a database method path:

 C_LONGINT($methodType)

 C_POINTER($tablePtr)

 C_TEXT($objectName)

 C_TEXT($formObjectName)

 

 METHOD RESOLVE PATH("[databaseMethod]/onStartup";$methodType;$tablePtr;$objectName;$formObjectName)

  // $methodType: 2

  // $tablePtr: Nil pointer

  // $objectName: "onStartup"

  // $formObjectName: ""

Example 2

Resolution of a path for an object of a table form method:

 C_LONGINT($methodType)

 C_POINTER($tablePtr)

 C_TEXT($objectName)

 C_TEXT($formObjectName)

 

 METHOD RESOLVE PATH("[tabletForm]/Table1/output%2A1/myVar%2A1";$methodType;$tablePtr;$objectName;$formObjectName)

  // $methodType: 16

  // $tablePtr: -> [Table1]

  // $objectName: "output*1"

  // $formObjectName: "Btn*1"