Descends through the hierarchy from the current schematic and collects each distinct schematic in use. The result is a list of schematic path names. Each path name is accompanied by a list of hierarchy references where that schematic is used.
Number | Type | Compulsory | Default | Description |
---|---|---|---|---|
1 |
string |
No |
'Ref' |
Property used to report 'where used' references |
2 |
real |
No |
-1 |
Schematic ID |
3 |
string |
Yes |
|
options |
Name of property to be used to report 'where used' references. Each entry in the return value contains a list of schematic instance references that identify where the schematic component is used. The references are in the form of a series of property values separated by a period ('.'). The property used defaults to 'Ref' but this argument may be used to identify another property - e.g. 'Handle'.
Schematic ID as returned by the OpenSchematic function. This allows this function to be used with a schematic that is not open or not currently selected. If equal to -1, the currently selected schematic will be used.
If set to 'pathtypes' will return information on the type of path. Possible values are 'absolute', 'relative' and 'symbolic'
Return type: string array
Returns a string array with one element for each schematic file used in the hierarchy. Each element is a semi-colon delimited list of values. The first value is the full path to the schematic in UNC form if applicable. UNC paths begin with '\ \' followed by a server name and path. Paths referenced by a local drive letter are not returned in UNC form even if sharing is enabled for that drive.
The remaining values are a list of hierarchical references identifying where that schematic is used within the hierarchy. The references use the value of the property defined in argument 1.
|