Share via


NamedRange.NavigateArrow(Object, Object, Object) Method

Definition

Navigates a tracer arrow for the NamedRange 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

A Range object that represents the new selection.

Examples

The following code example makes cell A1 a dependent of a NamedRange. The example then uses the ShowDependents method to draw an arrow between the NamedRange and the dependent cell, and calls the NavigateArrow method to select the dependent cell.

This example is for a document-level customization.

private void DisplayAndSelectDependents()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["C1"],
        "namedRange1");
    namedRange1.Value2 = "Smith";

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

    namedRange1.ShowDependents(false);
    namedRange1.NavigateArrow(false, 1);
}
Private Sub DisplayAndSelectDependents()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("C1"), _
        "namedRange1")
    namedRange1.Value2 = "Smith"

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

    namedRange1.ShowDependents(False)
    namedRange1.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.

Applies to