Partilhar via

Método DocumentProperties.Add (Office)

  • Artigo

Cria uma nova propriedade de documento personalizado. Você pode adicionar uma nova propriedade do documento somente para a coleção personalizada DocumentProperties.

Sintaxe

expressão. Adicione (nome, LinkToContent, tipo, valor, LinkSource)

expression é obrigatório. Uma variável que representa um objeto DocumentProperties. O objeto personalizado DocumentProperties.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Name Obrigatório CadeiaDeCaracteres A cadeia de caracteres donome da propriedade.
LinkToContent Obrigatório Boolean Especifica se a propriedade LinkToContent está vinculada ao conteúdo do documento contêiner. Se esse argumento for True, o argumentoLinkSource é necessário; se for falso, o argumentovalor é necessário.
Type Opcional Variant O tipo de dados da propriedadetipo. Pode ser um destes procedimentos MsoDocProperties constantes: msoPropertyTypeBoolean, msoPropertyTypeDate, msoPropertyTypeFloat, msoPropertyTypeNumber, ou msoPropertyTypeString.
Valor Opcional Variant O valor de dados da propriedadeValor, se não estiver vinculado ao conteúdo do documento contêiner. O valor é convertido para corresponder ao tipo de dados especificado pelo argumento Type e, se não puder ser convertido, ocorrerá um erro. Se LinkToContent for Verdadeiro, o argumento será ignorado e a propriedade do novo documento receberá um valor padrão até que os valores da propriedade vinculados sejam atualizados pelo aplicativo de contêiner (geralmente, quando o documento é salvo).
LinkSource Opcional Variant Ignorados se LinkToContent for falso. A origem da propriedade LinkSource. O aplicativo contêiner determina quais tipos de fonte de vinculação você pode usar. Por exemplo, os vínculos DDE usam a sintaxe "Servidor|Documento!Item".

Comentários

Se você adicionar uma propriedade personalizada de documento à coleção DocumentProperties que é vinculada a um determinado valor em um documento do Office, precisará salvar o documento para ver a alteração no objeto DocumentProperty.

Exemplo

Este exemplo, criado para ser executado em Word, adiciona três propriedades de documento personalizadas à coleção 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

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.