NamedRange.Precedents Property

Definition

Namespace:

Microsoft.Office.Tools.Excel

Assembly:

Microsoft.Office.Tools.Excel.dll

Gets a Range that represents all the precedents of the NamedRange control.

public:
 property Microsoft::Office::Interop::Excel::Range ^ Precedents { Microsoft::Office::Interop::Excel::Range ^ get(); };

public Microsoft.Office.Interop.Excel.Range Precedents { get; }

member this.Precedents : Microsoft.Office.Interop.Excel.Range

Public ReadOnly Property Precedents As Range

Property Value

Range

A Range that represents all the precedents of the NamedRange control.

Examples

The following code example sets a reference in cell A2 to refer to cell A1, and then sets a reference in a NamedRange to refer to cell A2. The code example then uses the Precedents property to select the precedents of the NamedRange, which are cells A1 and A2.

This example is for a document-level customization.

Microsoft.Office.Tools.Excel.NamedRange precedentsRange;
private void SelectPrecedents()
{
    precedentsRange = this.Controls.AddNamedRange(
         this.Range["C1"], "precedentsRange");

    this.Range["A1"].Value2 = "1710";
    this.Range["A2"].Value2 = "=A1";

    this.precedentsRange.Value2 = "=A2";
    this.precedentsRange.Precedents.Select();
}

Private precedentsRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub SelectPrecedents()
    precedentsRange = Me.Controls.AddNamedRange( _
        Me.Range("C1"), "precedentsRange")

    Me.Range("A1").Value2 = "1710"
    Me.Range("A2").Value2 = "=A1"

    Me.precedentsRange.Value2 = "=A2"
    Me.precedentsRange.Precedents.Select()
End Sub

Remarks

This can be a multiple selection (a union of Microsoft.Office.Interop.Excel.Range objects) if there is more than one precedent.