Compartir a través de

Método Names.Add (Excel)

  • Artículo

Define un nombre nuevo para un rango de celdas.

Sintaxis

expresión. Add (Name, RefersTo, Visible, MacroType, ShortcutKey, Category, NameLocal, RefersToLocal, CategoryLocal, RefersToR1C1, RefersToR1C1Local)

Expresión Variable que representa un objeto Names .

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
Name Opcional Variant Especifica el texto, en inglés, que se usará como nombre si no se especifica el parámetro NameLocal . Los nombres no pueden incluir espacios y no se pueden tener formato de referencias de celda.
RefersTo Opcional Variant Describe a qué hace referencia el nombre, en inglés, mediante la notación de estilo A1, si no se especifican los parámetros RefersToLocal, RefersToR1C1 y RefersToR1C1Local .

NOTA: No se devuelve nada si la referencia no existe.
Visible Opcional Variant True especifica que el nombre está definido como visible. False especifica que el nombre está definido como oculto. Un nombre oculto no aparece en el cuadro de diálogo Definir nombre, Pegar nombre o Goto . El valor predeterminado es True.
MacroType Opcional Variant Tipo de macro, determinado por uno de los valores siguientes:

  • 1: función definida por el usuario (procedimiento Function)

  • 2: macro (procedimiento Sub)

  • 3 o sin especificar: ninguno (es decir, el nombre no se refiere a una función definida por el usuario o una macro)
ShortcutKey Opcional Variant Especifica la tecla de método abreviado de la macro. Debe ser una sola letra, como "z" o "Z". Se aplica solo a macros de comando.
Category Opcional Variant Categoría de la macro o función si el argumento MacroType es igual a 1 o 2. La categoría se utiliza en el Asistente para funciones. Se puede hacer referencia a las categorías existentes por número, empezando por 1, o por nombre, en inglés. Excel crea una nueva categoría si la categoría especificada no existe.
NameLocal Opcional Variant Especifica el texto localizado que se usará como nombre si no se especifica el parámetro Name . Los nombres no pueden incluir espacios y no se pueden tener formato de referencias de celda.
RefersToLocal Opcional Variant Describe a qué hace referencia el nombre, en texto localizado mediante notación de estilo A1, si no se especifican los parámetros RefersTo, RefersToR1C1 y RefersToR1C1Local .
CategoryLocal Opcional Variant Especifica el texto localizado que identifica la categoría de una función personalizada si no se especifica el parámetro Category .
RefersToR1C1 Opcional Variant Describe a qué hace referencia el nombre, en inglés mediante la notación de estilo R1C1, si no se especifican los parámetros RefersTo, RefersToLocal y RefersToR1C1Local .
RefersToR1C1Local Opcional Variant Describe a qué hace referencia el nombre, en texto localizado mediante notación de estilo R1C1, si no se especifican los parámetros RefersTo, RefersToLocal y RefersToR1C1 .

Valor devuelto

Objeto Name que representa el nuevo nombre.

Ejemplo:

En este ejemplo se define un nombre nuevo para el rango A1:D3 de Sheet1 del libro activo.

Nota:

Se devuelve Nothing si Sheet1 no existe.

Sub MakeRange() 
 
    ActiveWorkbook.Names.Add _ 
        Name:="tempRange", _ 
        RefersTo:="=Sheet1!$A$1:$D$3" 
 
End Sub

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.