NamedRange.NavigateArrow Method

Article
06/14/2013

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

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

.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