CreateReference Method (IUltraCalcReference)

Create a new reference relative to this reference.

Syntax

Visual Basic

'Declaration
 
Function CreateReference( _
   ByVal referenceString As String _
) As IUltraCalcReference

C#

IUltraCalcReference CreateReference( 
   string referenceString
)

Parameters

referenceString

The reference string.

Return Value

The new reference.

Remarks

A reference string may be external or internal.

A external reference has the form "//object_name/object_specific_part". The control identified by object_name must implement IUltraCalcReference and be able to parse object_specific_part.

An internal reference is a reference within the same control that implements this instance of the interface. An internal reference can be absolute or relative. Absolute references must begin with the "/" character. Such references must be created relative to the root object in the control. Relative references are created relative to this reference.

Note that in complex reference models, multiple reference strings may point to the same underlying object. The reference string used to create the reference must be available to other methods such as ResolveReference, References and MarkRelativeIndicies. Consequently, if the reference string is relative, a proxy reference object should be returned that retains the relative reference string.

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2