Range.ApplyNames Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Applies names to the cells in the specified range.
public object ApplyNames (object Names, object IgnoreRelativeAbsolute, object UseRowColumnNames, object OmitColumn, object OmitRow, Microsoft.Office.Interop.Excel.XlApplyNamesOrder Order = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, object AppendLast);
Public Function ApplyNames (Optional Names As Object, Optional IgnoreRelativeAbsolute As Object, Optional UseRowColumnNames As Object, Optional OmitColumn As Object, Optional OmitRow As Object, Optional Order As XlApplyNamesOrder = Microsoft.Office.Interop.Excel.XlApplyNamesOrder.xlRowThenColumn, Optional AppendLast As Object) As Object
Parameters
- Names
- Object
Optional Object. An array of the names to be applied. If this argument is omitted, all names on the sheet are applied to the range.
- IgnoreRelativeAbsolute
- Object
Optional Object. 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
- Object
Optional Object. 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
- Object
Optional Object. 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
- Object
Optional Object. 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.
- Order
- XlApplyNamesOrder
Optional XlApplyNamesOrder. Determines which range name is listed first when a cell reference is replaced by a row-oriented and column-oriented range name. Can be one of these XlApplyNamesOrder constants:xlColumnThenRowxlRowThenColumn default
- AppendLast
- Object
Optional Object. 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.
Returns
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.