4D v13.4

METHOD RESOLVE PATH

Home

 
4D v13.4
METHOD RESOLVE PATH

METHOD RESOLVE PATH 


 

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

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.

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: ""

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"

 
PROPERTIES 

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

 
INDEX

Alphabetical list of commands

 
HISTORY 

New
Created: 4D v13

 
SEE ALSO 

METHOD Get path