Partager via

Méthode DocumentProperties.Add (Office)

Crée une nouvelle propriété de document personnalisé. Vous pouvez ajouter une nouvelle propriété de document uniquement à la collection personnalisée DocumentProperties.

Syntaxe

expression.Add (Name, LinkToContent, Type, Value, LinkSource)

expression obligatoire. Variable qui représente un objet DocumentProperties. Objet personnaliséDocumentProperties.

Paramètres

Nom Requis/Facultatif Type de données Description
Name Obligatoire String Chaîne de la propriété Name.
LinkToContent Obligatoire Boolean Spécifie si la propriétéLinkToContent est liée au contenu du document conteneur. Si cet argument est True, l’argument LinkSource est requis ; s’il est False, l’argument valeur est requis.
Type Facultatif Variant Type de données de la propriétéType. Peut être l’une des opérations suivantes MsoDocProperties constantes : msoPropertyTypeBoolean, msoPropertyTypeDate, msoPropertyTypeFloat, msoPropertyTypeNumber, ou msoPropertyTypeString.
Value Facultatif Variant La valeur de données de la propriétéValue, si elle n’est pas liée au contenu du document conteneur. La valeur est convertie pour correspondre au type de données spécifié par le Type, et si elle ne peut pas être convertie, une erreur se produit. Si LinkToContent est True, l’argument est ignoré et une valeur par défaut est affectée à la nouvelle propriété de document, jusqu'à ce que les valeurs de propriété liées soient mises à jour par l’application conteneur (généralement lorsque le document est enregistré).
LinkSource Facultatif Variant Ignoré si LinkToContent est False. La source de la propriétéLinkSource. L’application conteneur détermine quels types de source de liaison vous pouvez utiliser. Par exemple, les liaisons DDE utilisent la syntaxe « Server|Document!Item ».

Remarques

Si vous ajoutez une propriété de document personnalisée à la collection DocumentProperties qui est liée à une valeur donnée dans un document Microsoft Office, vous devez enregistrer le document pour voir la modification effectuée dans l'objet DocumentProperty.

Exemple

Cet exemple, conçu pour s'exécuter dans Microsoft Word, montre comment ajouter trois propriétés de document personnalisées à la collection 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

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

  • Last updated on