XmlMappedRange.NavigateArrow Method

Article
06/14/2013

Navigates a tracer arrow for the XmlMappedRange control to the precedent, dependent, or error-causing cell or cells.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Function NavigateArrow ( _
    TowardPrecedent As Object, _
    ArrowNumber As Object, _
    LinkNumber As Object _
) As Object

Object NavigateArrow(
    Object TowardPrecedent,
    Object ArrowNumber,
    Object LinkNumber
)

Parameters

TowardPrecedent
Type: System.Object

Specifies the direction to navigate: true to navigate toward precedents; false to navigate toward dependents.

ArrowNumber
Type: System.Object

Specifies the arrow number to navigate; corresponds to the numbered reference in the cell's formula.

LinkNumber
Type: System.Object

If the arrow is an external reference arrow, this argument indicates which external reference to follow. If this argument is omitted, the first external reference is followed.

Return Value

Type: System.Object
A Range that represents the new selection.

Remarks

Selects the precedent, dependent, or error cells. This method causes an error if it is applied to a cell without visible tracer arrows.

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example makes cell A1 a dependent of an XmlMappedRange. The example then uses the ShowDependents method to draw an arrow between an XmlMappedRange and the dependent cell, and calls the NavigateArrow method to select the dependent cell. This code example assumes that the current worksheet contains an XmlMappedRange named CustomerLastNameCell.

Private Sub DisplayAndSelectDependent()
    Me.CustomerLastNameCell.Value2 = "Smith" 

    Me.Range("A1").Value2 = "=" & _
        Me.CustomerLastNameCell.Address(False, True, _
        Excel.XlReferenceStyle.xlA1, False)

    Me.CustomerLastNameCell.ShowDependents(False)
    Me.CustomerLastNameCell.NavigateArrow(False, 1)
End Sub

private void DisplayAndSelectDependent()
{
    this.CustomerLastNameCell.Value2 = "Smith";

    this.Range["A1"].Value2 = "=" +
        this.CustomerLastNameCell.Address[false, true,
        Excel.XlReferenceStyle.xlA1, false];

    this.CustomerLastNameCell.ShowDependents(false);
    this.CustomerLastNameCell.NavigateArrow(false, 1);
}

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via