Méthode Task.SetField (Project)

  • Article

Définit la valeur du champ personnalisé de la tâche spécifiée.

Syntaxe

expression. SetField( _FieldID_, _Value_ )

Expression Variable qui représente un objet Task .

Parameters

Nom Requis/Facultatif Type de données Description
FieldID Obligatoire Long Pour un champ personnalisé local, il peut s’agir de l’une des constantes PjField pour les champs personnalisés de tâche. Pour un champ personnalisé d’entreprise, utilisez la méthode FieldNameToFieldConstant pour obtenir le FieldID.
Valeur Obligatoire String Valeur du champ.

Remarques

Les champs personnalisés du projet sont accessibles via la propriété ProjectSummaryTask.

Exemple

L’exemple suivant utilise les méthodes SetField et GetField de pair avec les méthodes FieldNameToFieldConstant et FieldConstantToFieldName.

  1. Pour utiliser l’exemple, utilisez Project Web App pour créer un champ personnalisé de texte de projet d’entreprise nommé TestEntProjText.

  2. Redémarrez Project Professionnel avec un profil Project Server, afin qu’il inclue le nouveau champ personnalisé.

  3. Créez un projet avec une valeur pour le champ TestEntProjText dans la boîte de dialogue Informations sur le projet.

  4. La macro TestEnterpriseProjectCF utilise la méthode FieldNameToFieldConstant pour rechercher le numéro de projectField, par exemple 190873618.

  5. La macro affiche le nombre et la valeur de texte dans une zone de message à l’aide de la méthode GetField.

  6. La macro obtient le nom du champ à l’aide de la méthode FieldConstantToFieldName , définit une nouvelle valeur à l’aide de la méthode SetField , puis affiche le nom du champ et la nouvelle valeur dans une autre boîte de message.

Sub TestEnterpriseProjectCF() 
    Dim projectField As Long 
    Dim projectFieldName As String 
    Dim message As String 
 
    projectField = FieldNameToFieldConstant("TestEntProjText", pjProject) 
 
    ' Show the enterprise project field number and old value. 
    message = "Enterprise project field number: " & projectField & vbCrLf 
    MsgBox message & ActiveProject.ProjectSummaryTask.GetField(projectField) 
 
    ActiveProject.ProjectSummaryTask.SetField FieldID:=projectField, Value:="This is a new value." 
 
    ' For a demonstration, get the field name from the field number, and verify the new value. 
    projectFieldName = FieldConstantToFieldName(projectField) 
    message = "New value for field: " & projectFieldName & vbCrLf 
    MsgBox message & ActiveProject.ProjectSummaryTask.GetField(projectField) 
End Sub

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.