XmlMappedRange.NavigateArrow(Object, Object, Object) Method

Definition

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

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

public object NavigateArrow (object TowardPrecedent, object ArrowNumber, object LinkNumber);

abstract member NavigateArrow : obj * obj * obj -> obj

Public Function NavigateArrow (Optional TowardPrecedent As Object, Optional ArrowNumber As Object, Optional LinkNumber As Object) As Object

Parameters

TowardPrecedent

Object

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

ArrowNumber

Object

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

LinkNumber

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.

Returns

Object

A Range that represents the new selection.

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 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);
}

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

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.