getCustomName Method

Gets the specified custom name information.

Syntax

Javascript (Usage)
Javascript (Specification)

var instance = new GC.Spread.Sheets.Workbook(host);
var value; // Type: NameInfo
value = instance.getCustomName(name);

function getCustomName( 
   name : string
) : NameInfo;

Parameters

name: The custom name.

Return Value

The information for the specified custom name.

Example

This example uses the getCustomName method.

Javascript

activeSheet.setValue(0, 0, 1);
activeSheet.setValue(0, 1, 2);
activeSheet.setValue(0, 2, 3);
spread.addCustomName("customName1","=12", 0, 0);
activeSheet.setFormula(1, 0, "customName1");

var cname = spread.getCustomName("customName1");
    if (cname instanceof GC.Spread.Sheets.NameInfo) {
        //get CustomName
        var name = cname.getName();
        //get Expression
        var expression = cname.getExpression();
        //get Expression String
        var expStr = GC.Spread.Sheets.CalcEngine.expressionToFormula(activeSheet, expression, 0, 0);
        alert("Name:" + name + ";Expression: =" + expStr);
}

Reference

Workbook type
Creating Custom Names