Contrôler l'affichage des champs d'éléments de travail

Article
03/04/2013

Vous pouvez contrôler le nom d'étiquette, la position, la taille de zone de texte, et d'autres contrôles d'affichage de champs de texte brut, entier, nombre, date et élément de travail de chemin d'arborescence sur votre formulaire d'élément de travail.Pour afficher ces champs, vous devez spécifier l'attribut Type approprié de l'élément Control, à partir des options suivantes :

DateTimeControl : utilisé pour afficher les champs de date mis en forme qui ont un type de champ DateTime.
FieldControl : utilisé pour afficher les champs de texte brut ou numériques et les listes de valeurs pour les champs ayant un type de champ String, Identity, Integer, Double et PlainText.
HtmlFieldControl : utilisé pour afficher le format RTF multiligne des champs qui ont un type de données de champ HTML.
WorkItemClassificationControl : utilisé pour afficher les champs de chemin d'accès hiérarchiques qui ont un type de champ TreePath.

Pour plus d'informations sur les autres contrôles Type, consultez les rubriques suivantes :

Dans cette rubrique

Contrôle de la taille et de l'affichage des champs de données
Affectation d'étiquettes aux champs et ajout de champs à deux emplacements sur le formulaire
Définir un champ en lecture seule
Ajout de champs de texte brut et numériques
Ajout de champs de texte mis en forme
Ajout de champs de date ou de calendrier
Ajout de champs pour les chemins d'accès de zone et d'itération

Contrôle de la taille et de l'affichage des champs de données

Vous pouvez contrôler l'espacement et la taille de chaque champ de données en utilisant les attributs facultatifs décrits dans le tableau suivant.

[!REMARQUE]

La taille globale de chaque champ d'entrée de données est déterminée par plusieurs facteurs : les attributs assignés au champ, la taille du conteneur, et la zone allouée aux autres champs sur le formulaire.Les valeurs par défaut sont assignées aux champs lorsque vous ne spécifiez pas de taille minimale.Toutefois, les attributs assignés aux autres champs du formulaire peuvent affecter la taille des champs.Le nombre de colonnes et la taille horizontale que vous allouez au plus grand champ de chaque colonne déterminent la dimension horizontale d'un formulaire.Le nombre de champs que vous spécifiez dans un groupe vertical et la taille verticale que vous allouez à chaque champ déterminent la taille du haut du formulaire et la taille du bas du formulaire.

Attribut	Description	Exemple de valeur de modèle
MinimumSize	Spécifie la taille minimale (Largeur, Hauteur) pour le contrôle.Lorsque le conteneur pour le contrôle est inférieur à cette taille, des barres de défilement horizontale et verticale apparaissent.	(100,100)
Margin	Spécifie, en pixels, la quantité d'espace autour du contrôle et entre le contrôle et ses voisins (gauche, haut, droite, bas).	(2,0,2,0)
Padding	Spécifie, en pixels, la quantité d'espace autour de la bordure externe du contrôle (gauche, haut, droite, bas).	(2,0,2,0)
Dock	Spécifie l'alignement de l'étiquette par rapport au côté indiqué du conteneur, ou étire le champ pour remplir le conteneur.Spécifiez une chaîne à partir de l'une des valeurs suivantes : Fill, Top, Bottom, Left et Right.	N/A

Affectation d'étiquettes aux champs et ajout de champs à deux emplacements sur le formulaire

Pour chaque contrôle de formulaire, vous pouvez spécifier une étiquette facultative et la position de l'étiquette à l'aide des attributs Label et LabelPosition.L'étiquette peut spécifier un nom différent du nom convivial assigné par l'élément FIELD.Si vous ne spécifiez pas d'étiquette, le nom convivial est utilisé.Toutefois, notez que le nom convivial est toujours utilisé lorsqu'un membre de l'équipe exécute une requête pour rechercher des éléments de travail.La taille d'étiquette maximale est de 80 caractères.

[!REMARQUE]

Vous devez définir la même position d'étiquette pour tous les contrôles définis dans le même groupe.

Si vous souhaitez ajouter le champ dans plusieurs zones du formulaire, par exemple en haut du formulaire et sous un onglet, vous pouvez le faire à l'aide de l'attribut Name.L'attribut Name identifie simplement le contrôle comme différent de l'autre contrôle ajouté au formulaire.

Définir un champ en lecture seule

Vous pouvez marquer un champ en lecture seule de l'une des deux façons suivantes.Dans la première méthode, vous ajoutez l'élément READONLY en tant qu'enfant à l'élément FIELD dans la section FIELDS de la définition de type.En utilisant l'élément READONLY, vous pouvez spécifier si certains utilisateurs peuvent modifier le champ.Comme indiqué dans l'exemple suivant, seuls les chefs de projet peuvent modifier un champ Sous-titre.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

Dans la seconde méthode, vous spécifiez l'attribut ReadOnly pour l'élément CONTROL.Dans cette méthode, aucun utilisateur n'a le droit de modifier le champ.

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

Ajout de champs de texte et numériques

Vous utilisez le type FieldControl pour ajouter des champs de texte brut et numériques à un formulaire.Cet attribut est également utilisé pour ajouter des listes de choix ; des champs utilisés pour afficher des noms de personnes, tels que les champs Assigné à ou Propriétaire ; et des nombres entiers et réels.Le contrôle de champ doit renvoyer à un champ de par son nom de référence.L'étiquette de champ peut être du texte brut ou un lien hypertexte.Pour plus d'informations, consultez Fournir un texte d'aide, un guide de processus, un contenu Web et des liens vers les pages Web sur un formulaire d'élément de travail.

Champs Texte, Entier et Liste de choix

Groupe de plusieurs champs

Vous pouvez contrôler le format des champs numériques et la longueur maximale des caractères qui peuvent être entrés dans un champ textuel ou numérique à l'aide des attributs facultatifs décrits dans le tableau suivant.

Attribut	Description
NumberFormat	Spécifie les caractères que vous pouvez entrer dans le contrôle de champ.Les valeurs valides sont les suivantes : WholeNumbers, SignedWholeNumbers, DecimalNumbers et SignedDecimalNumbers.
MaxLength	Spécifie la longueur maximale des caractères que vous pouvez utiliser pour un contrôle de champ.

Le code suivant répertorie la syntaxe utilisée pour créer le groupe de champs illustré précédemment.

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

Ajout de champs de texte mis en forme

Vous utilisez le type HTMLFieldControl afin d'ajouter des champs dont le type de données est HTML.Ce contrôle prend en charge l'affichage du texte mis en forme sur plusieurs lignes.

Champ HTML

Champ HTML affiché dans le formulaire d'élément de travail

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" Dock="Left" MinimumSize="100,500" />

Conseil
Lorsque vous ajoutez plusieurs éléments HTMLFieldControl sur un formulaire qui sera empilé verticalement, vous devez spécifier l'attribut MinimumSize pour chaque contrôle de champ.Ainsi, vous pouvez donner la même taille à toutes les zones de texte.Sinon, le dernier élément de contrôle HTML est dimensionné pour remplir le formulaire, et les éléments précédents s'affichent avec des zones de texte plus petites.

Lorsque vous ajoutez plusieurs éléments HTMLFieldControl sur un formulaire qui sera empilé verticalement, vous devez spécifier l'attribut MinimumSize pour chaque contrôle de champ.Ainsi, vous pouvez donner la même taille à toutes les zones de texte.Sinon, le dernier élément de contrôle HTML est dimensionné pour remplir le formulaire, et les éléments précédents s'affichent avec des zones de texte plus petites.

Ajout de champs de date ou de calendrier

Vous utilisez le type DateTimeControl pour fournir aux utilisateurs un sélecteur de calendrier afin de sélectionner une date pour un champ DateTime.À l'aide de ce contrôle, vous pouvez sélectionner rapidement une date et une heure pour le champ.

Champ de calendrier avec Format="Short"

Champ Calendrier

Par exemple, vous pouvez spécifier une date de début par défaut ou une date de révision ultérieure.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Dock="Fill" Format="Time" />

Vous pouvez contrôler le format du champ DateTime à l'aide des attributs facultatifs décrits dans le tableau suivant.

Attribut	Description
Format	Spécifie le format du champ date-heure qui correspond à une valeur de l'enum DateTimePickerFormat.Les valeurs valides sont les suivantes : Custom, Long, Short et Time. Lorsque vous spécifiez Custom, vous devez également spécifier l'attribut CustomFormat.
CustomFormat	Spécifie le format personnalisé du champ date-heure qui correspond à la syntaxe définie pour la propriété DateTimePicker.CustomFormat.Par exemple : Format="Custom" CustomFormat = « dd MMM, 'de l'année' yyyy » Pour plus d'informations, consultez le site Web Microsoft : DateTimePicker.CustomFormat, propriété.

Format

Spécifie le format du champ date-heure qui correspond à une valeur de l'enum DateTimePickerFormat.Les valeurs valides sont les suivantes : Custom, Long, Short et Time.

Lorsque vous spécifiez Custom, vous devez également spécifier l'attribut CustomFormat.

CustomFormat

Spécifie le format personnalisé du champ date-heure qui correspond à la syntaxe définie pour la propriété DateTimePicker.CustomFormat.Par exemple :

Format="Custom"

CustomFormat = « dd MMM, 'de l'année' yyyy »

Pour plus d'informations, consultez le site Web Microsoft : DateTimePicker.CustomFormat, propriété.

Ajout de champs pour les chemins d'accès de zone et d'itération

Vous utilisez le type WorkItemClassificationControl afin d'ajouter des champs dont le type de données est TreePath.Ce contrôle prend en charge l'affichage des champs du chemin d'accès de zone et des champs du chemin d'accès d'itération dans un format d'arborescence imbriquée hiérarchique.L'arborescence affiche des nœuds hiérarchiques que vous pouvez développer et réduire.

<Control Type="WorkItemClassificationControl" FieldName="System.AreaPath" Label="Area"LabelPosition="Left" />

[!REMARQUE]

Vous pouvez utiliser le WorkItemClassificationControl pour afficher les champs System.AreaPath et System.IterationPath.Vous ne pouvez afficher aucun autre type de champ ou champ personnalisé à l'aide de ce contrôle.

Pour plus d'informations, consultez Créer et modifier des zones et des itérations.