NamedRange.NavigateArrow(Object, Object, Object) Method

Reference

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Object

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

Share via