Método DocumentProperties.Add (Office)

Crea una nueva propiedad de documento personalizada. Sólo es posible utilizar este método con la colección personalizada DocumentProperties.

Sintaxis

expresión.Add (Name, LinkToContent, Type, Value, LinkSource)

expresión obligatoria. Una variable que representa un objeto DocumentProperties. El objeto personalizado DocumentProperties.

Parámetros

Nombre	Obligatorio/opcional	Tipo de datos	Descripción
Name	Obligatorio	String	La cadena de Name de la propiedad.
LinkToContent	Obligatorio	Boolean	Especifica si la propiedad LinkToContent está vinculada al contenido del documento contenedor. Si este argumento es True, se requiere el argumento LinkSource; si es False, se requiere el argumento Value.
Type	Opcional	Variant	El tipo de datos de la propiedad Type. Puede ser una de las siguientes constantes MsoDocProperties: msoPropertyTypeBoolean, msoPropertyTypeDate, msoPropertyTypeFloat, msoPropertyTypeNumber o msoPropertyTypeString.
Value	Opcional	Variant	El valor de datos de la propiedad Value si no está vinculada al contenido del documento contenedor. Si fuera posible, el valor se convierte para que coincida con el tipo de datos especificado por el argumento Type; en caso contrario, se produce un error. Si LinkToContent es True, se omite el argumento y la nueva propiedad de documento tiene un valor predeterminado hasta que la aplicación contenedora actualice los valores de la propiedad vinculada, normalmente al guardar el documento.
LinkSource	Opcional	Variant	Se omite si LinkToContent es False. El origen de la propiedad LinkSource. La aplicación contenedora determina los tipos de vinculación de origen que se pueden utilizar. Por ejemplo, los vínculos DDE usan la sintaxis "Servidor|Documento!Elemento".

Observaciones

Si agrega una propiedad de documento personalizada a la colección DocumentProperties que está vinculada a un valor dado en un documento de Office, debe guardar el documento para ver el cambio en el objeto DocumentProperty.

Ejemplo

En este ejemplo, diseñado para ejecutarse en Word, se agregan tres propiedades personalizadas a la colección DocumentProperties.

With ActiveDocument.CustomDocumentProperties 
    .Add Name:="LastModifiedBy", _ 
        LinkToContent:=True, _ 
        Type:=msoPropertyTypeString, _ 
        LinkSource:=Author
    .Add Name:="CustomNumber", _ 
        LinkToContent:=False, _ 
        Type:=msoPropertyTypeNumber, _ 
        Value:=1000 
    .Add Name:="CustomString", _ 
        LinkToContent:=False, _ 
        Type:=msoPropertyTypeString, _ 
        Value:="This is a custom property." 
    .Add Name:="CustomDate", _ 
        LinkToContent:=False, _ 
        Type:=msoPropertyTypeDate, _ 
        Value:=Date 
End With

Vea también

• Miembros del objeto DocumentProperties

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.