ApplyNames Method [Excel 2003 VBA Language Reference]

  • Article

Applies names to the cells in the specified range.

expression**.ApplyNames(Names**, IgnoreRelativeAbsolute, UseRowColumnNames, OmitColumn, OmitRow, Order, AppendLast)

expression Required. An expression that returns one of the objects in the Applies To list.

Names   Optional Variant. An array of the names to be applied. If this argument is omitted, all names on the sheet are applied to the range.

IgnoreRelativeAbsolute   Optional Variant. True to replace references with names, regardless of the reference types of either the names or references. False to replace absolute references only with absolute names, relative references only with relative names, and mixed references only with mixed names. The default value is True.

UseRowColumnNames   Optional Variant. True to use the names of row and column ranges that contain the specified range if names for the range cannot be found. False to ignore the OmitColumn and OmitRow arguments. The default value is True.

OmitColumn   Optional Variant. True to replace the entire reference with the row-oriented name. The column-oriented name can be omitted only if the referenced cell is in the same column as the formula and is within a row-oriented named range. The default value is True.

OmitRow   Optional Variant. True to replace the entire reference with the column-oriented name. The row-oriented name can be omitted only if the referenced cell is in the same row as the formula and is within a column-oriented named range. The default value is True.

XlApplyNamesOrder

XlApplyNamesOrder can be one of these XlApplyNamesOrder constants.
xlColumnThenRow
xlRowThenColumndefault

AppendLast   Optional Variant. True to replace the definitions of the names in Names and also replace the definitions of the last names that were defined. False to replace the definitions of the names in Names only. The default value is False.

Remarks

You can use the Array function to create the list of names for the Names argument.

If you want to apply names to the entire sheet, use Cells.ApplyNames.

You cannot "unapply" names; to delete names, use the Delete method.

Example

This example applies names to the entire sheet.

Cells.ApplyNames Names:=Array("Sales", "Profits")

Applies to | Range Collection

See Also | Add Method | Delete Method