Skip to main content

GetDefName

Returns the ApiName object by the range name.

Syntax

expression.GetDefName(defName);

expression - A variable that represents a Api class.

Parameters

NameRequired/OptionalData typeDefaultDescription
defNameRequiredstringThe range name.

Returns

ApiName

Example

This example shows how to get the ApiName object by the range name.

// How to work with named ranges in a spreadsheet using the API.

// Get name of an object using a range name.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange("A1").SetValue("1");
worksheet.GetRange("B1").SetValue("2");Api.AddDefName("numbers", "Sheet1!$A$1:$B$1");
let defName = Api.GetDefName("numbers");
worksheet.GetRange("A3").SetValue("DefName: " + defName.GetName());