ParseConnectionSource Method

Parses the specified Data Source to determine if it is a valid connection.

Syntax

object.ParseConnectionSource bstrPropertyName, bstrSource, iStatus, pvaValidObjects, pvaUndefinedObjects, bstrFullyQualifiedSource

Properties

The ParseConnectionSource method syntax has these parts:

Part

Description

object

An object expression that evaluates to an object in the Applies To list.

bstrPropertyName

String. The name of the property being animated.

bstrSource

String. The Data Source. This can be either a Data System data source or a shape's property.

iStatus

Long. Returns the status of the connection.
Return values are:
0 – OK
1 – Invalid Syntax (Data Source could never exist
2 – Undefined Object (Data Source does not exist, could be added)
3 – Data Type Mismatch

pvaValidObjects

Variant. Returns an array of objects that are identified as part of the Data Source and are currently valid and used in the system.

pvaUndefinedObjects

Variant. Returns an array of objects that are identified as part of the Data Source but are not yet defined (Use Anyway objects).

bstrFullyQualifiedSource

Variant. Returns an array of objects that are identified as part of the Data Source but are not yet defined (Use Anyway objects).

Remarks

The object that you apply this method to has a property that may be animated by another object. Parsing checks to see the status of the Data Source and also checks to see if each object that is part of the source is defined or undefined.

ParseConnectionSource also checks complex expressions and returns individual sources. For example, when used on AI1+AI2, the method will return AI1 and AI2 in the Valid or Undefined object array.

 

Example

Applies To