Référence des éléments XML Control

Article
03/04/2013

Vous utilisez l'élément Control pour définir un champ, un texte, un lien hypertexte ou tout autre élément de contrôle à afficher dans un formulaire d'élément de travail.Pour obtenir des exemples d'utilisation de cet élément, consultez Spécifier des contrôles de formulaire d'élément de travail.Pour plus d'informations, consultez Concevoir et personnaliser un formulaire d'élément de travail.

Hiérarchie de schéma

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" ControlFontSize="FontSize" EmptyText="TextString"
Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(width,height)" 
Name="InstanceName" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
FieldName	Attribut Control facultatif. Spécifie le champ d'élément de travail auquel le contrôle est associé.Le type de l'attribut est typelib:ReferenceFieldName.Longueur minimale : 1 ; longueur maximale : 70. Valeur de modèle : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Exemple de valeur de modèle : Company.Division.IssueType
Type	Attribut Control requis. Spécifie le type de données du contrôle.Le type d'attribut est le type simple ValidControlsType.Spécifiez une chaîne de l'un des types intégrés suivants : AttachmentControl: Utilisez pour afficher des pièces jointes d'élément de travail.Ce contrôle n'a pas de champ ou type de champ associé. DateTimeControl: Utilisez pour afficher des champs Date mis en forme avec un type de champ de DateTime. FieldControl: Utilisez pour afficher les champs numériques ou textuels ordinaires et les listes de valeurs pour les champs avec les types String, Identity, Integer, Double et PlainText. HtmlFieldControl: Utilisez pour afficher le format de texte riche de champs, multiligne avec un type de champ HTML. LabelControl: Utilisez pour afficher le texte qui n'est pas associé à un champ.Le texte peut être brut ou hypertexte.Vous pouvez spécifier des contrôles supplémentaires à l'aide de la LabelText, Link et Text éléments.Consultez Référence des éléments XML LabelText et Text et Référence des éléments XML Link et Param. LinksControl: Permet d'afficher la barre d'outils de contrôle des liens et gérer les relations de liaison entre les éléments de travail et les tables de montage séquentiel.Ce contrôle n'a pas de champ ou type de champ associé.Vous spécifiez les types de liens de filtre et d'autres options de contrôle à l'aide de la LinksControlOptions élément.Consultez Éléments LinksControlOptions. WebpageControl: Utilisez pour afficher le contenu HTML défini par un URI ou incorporé dans une balise CDATA.Ce contrôle n'a pas de champ ou type de champ associé..Vous spécifiez le contenu et les liens à afficher à l'aide de la WebpageControlOptions élément.Consultez Référence des éléments XML WebpageControlOptions. Utilisation de WorkItemClassificationControl pour afficher les champs de chemin d'accès hiérarchiques avec un type de champ TreePath. Remarque Les champs System.AreaPath et System.IterationPath sont les seuls champs qui utilisent ce type de données.Vous ne pouvez pas définir de champ personnalisé à l'aide de ce type de données. WorkItemLogControl: Utilisez pour afficher des informations d'historique d'élément de travail et des champs avec un type de champ de History. Remarque Le champ System.History est le seul champ qui utilise ce type de données.Vous ne pouvez pas définir de champ personnalisé à l'aide de ce type de données. Pour plus d'informations, consultez Spécifier des contrôles de formulaire d'élément de travail. Remarque Vous pouvez utiliser un contrôle personnalisé en attribuant à l'attribut Type une valeur personnalisée.Tout contrôle dont la valeur Type ne correspond pas au nom d'un type intégré est considéré comme un contrôle personnalisé.Pour plus d'informations, consultez le site Web Microsoft : Contrôles personnalisés de suivi d'élément de travail (éventuellement en anglais).
ControlFontSize	Attribut Control facultatif. Spécifie la taille de police du nom du champ ou de l'étiquette sur le formulaire.Valid values of FontSize: small, normal, large, xlarge, and xxlarge.
EmptyText	Attribut Control facultatif. Spécifie une chaîne de texte entre 1 et 255 caractères qui s'affiche lorsqu'un champ est vide.
Label	Attribut Control facultatif. Spécifie le texte visible sur le formulaire qui identifie le contrôle.Spécifiez une chaîne de moins de 80 caractères.
LabelFontSize	Spécifie la taille de police de l'étiquette sur le formulaire.Valid values for FontSize: small, normal, large, xlarge, and xxlarge.
LabelPosition	Attribut Control facultatif. Spécifie la position de l'étiquette par rapport aux données du contrôle.Spécifiez une chaîne de l'une des valeurs suivantes : Top : place l'étiquette au-dessus de données de contrôle. Bottom : place l'étiquette au-dessous des données de contrôle. Left : place l'étiquette à gauche des données de contrôle. Right : place l'étiquette à droite des données de contrôle.
Dock	Attribut Control facultatif. Aligne le champ sur le côté spécifié du conteneur ou étire le champ pour remplir le conteneur.Le type de l'attribut est DockType.Spécifiez une chaîne de l'une des valeurs suivantes : Fill : Aligne le champ de sorte qu'il remplisse le conteneur.Cette valeur n'est pas une orientation prise en charge pour l'élément Splitter. Top: Aligne le champ avec le haut du conteneur.Cette valeur n'est pas une orientation prise en charge pour l'élément Splitter. Bottom: Aligne le champ avec le fond du conteneur.Cette valeur n'est pas une orientation prise en charge pour l'élément Splitter. Left: Aligne le champ avec le côté gauche du conteneur. Right: Aligne le champ avec le côté droit du conteneur.Cette valeur n'est pas une orientation prise en charge pour l'élément Splitter.
Padding	Attribut Control facultatif. Spécifie la quantité d'espace en pixels autour de la bordure intérieure du contrôle qui correspond aux espaces supérieur, inférieur, gauche et droite.Le type de l'attribut est SizeType. Valeur de modèle : ^$\d+\,\d+\,\d+\,\d+$$ Exemple de valeur de modèle : (2,0,2,0)
Margin	Attribut Control facultatif. Spécifie la quantité d'espace en pixels autour de la bordure extérieure du contrôle qui correspond aux espaces supérieur, inférieur, gauche et droite.Le type de l'attribut est SizeType. Valeur de modèle : ^$\d+\,\d+\,\d+\,\d+$$ Exemple de valeur de modèle : (2,0,2,0)
ReadOnly	Attribut Control facultatif. Spécifie que le champ est en lecture seule.Le type de l'attribut est ReadOnlyType.Spécifiez une chaîne de l'une des valeurs suivantes : True : spécifie que les données du contrôle sont en lecture seule. False : spécifie que les données de contrôle ne sont pas en lecture seule.
MinimumSize	Attribut Control facultatif. Spécifie la taille minimale en pixels que le contrôle doit occuper dans le formulaire.La syntaxe est spécifiée dans (width,height).Le type de l'attribut est SizeType. Valeur de modèle : ^$\d+\,\d+$$ Exemple de valeur de modèle : (100,100) Remarque Si vous n'avez pas un espace vertical suffisant, une barre de défilement semble garder sa taille minimale.Sans cet attribut, les contrôles sont dessinés avec leur taille par défaut, à moins que des contrôles d'autres onglets n'occupent un espace plus important.La taille générale d'un contrôle de formulaire dépend de la taille de la zone ou de l'onglet du formulaire le plus grand.
Name	Attribut Control facultatif. Identifie un contrôle de manière unique.L'attribut Name est important si plusieurs contrôles du formulaire sont associés au même champ d'élément de travail.Le type de l'attribut est xs:string. Remarque Vous utilisez l'attribut Name lorsque vous souhaitez que le même champ s'affiche dans plusieurs emplacements sur le formulaire.Vous spécifiez une valeur unique pour l'attribut Name des deux entrées de contrôle afin que le système identifie chaque contrôle de manière unique.Il est utile d'afficher le même contrôle à différents emplacements en fonction du contexte des onglets.
NumberFormat	Attribut Control facultatif qui est valide uniquement lorsqu'il est utilisé avec FieldControl. Spécifie les caractères que vous pouvez entrer dans le contrôle de champ.Les valeurs valides que vous pouvez utiliser sont les suivantes : WholeNumbers: Spécifie que les nombres entiers sont autorisés. SignedWholeNumbers: Spécifie que les nombres entiers signés sont autorisés. DecimalNumbers: Spécifie que les nombres décimaux sont autorisés. SignedDecimalNumbers: Spécifie que les nombres décimaux signés sont autorisés.
MaxLength	Attribut Control facultatif qui est valide uniquement lorsqu'il est utilisé avec FieldControl. Spécifie la longueur maximale de caractères autorisés pour un contrôle Field.Le type de l'attribut est xs:integer.
Format	Attribut Control facultatif qui est valide uniquement lorsqu'il est utilisé avec DateTimeControl. Spécifie le format du champ date-heure correspondant à l'une des valeurs de l'enum DateTimePickerFormat.Les valeurs valides que vous pouvez utiliser sont les suivantes : Custom: Affiche la valeur de date/d'heure dans un format personnalisé.Le format Personnalisé peut être défini en spécifiant « Personnalisé » comme valeur pour l'attribut de formatage et en définissant un autre attribut nommé CustomFormat avec une chaîne de format personnalisée.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é. Long : affiche la valeur de date/heure dans le format de date longue défini par le système d'exploitation de l'utilisateur. Short : affiche la valeur de date/heure dans le format de date courte défini par le système d'exploitation de l'utilisateur. Time : affiche la valeur de date/heure dans le format d'heure défini par le système d'exploitation de l'utilisateur. Pour plus d'informations, consultez le site Web de Microsoft : DateTimePickerFormat, énumération.
CustomFormat	Attribut Control facultatif qui est valide uniquement lorsqu'il est utilisé avec l'attribut DateTimeControl et Format. Spécifie le format personnalisé du champ date-heure correspondant à la syntaxe définie pour la propriété DateTimePicker.CustomFormat.Pour plus d'informations, consultez le site Web Microsoft : DateTimePicker.CustomFormat, propriété.

Éléments enfants

Élément	Description
LabelText	Élément facultatif.Vous pouvez spécifier cet élément lors de la Type attribut est spécifié en tant que FieldControl ou LabelControl. Élément conteneur permettant de spécifier le texte, le lien hypertexte et la position d'un champ ou d'une étiquette dont le texte est associé en partie à un lien hypertexte. Pour plus d'informations, consultez Référence des éléments XML LabelText et Text et 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.
Link	Élément facultatif.Vous pouvez spécifier cet élément lors de la Type attribut est spécifié en tant que FieldControl ou LabelControl. Définit le lien hypertexte pour un champ ou une étiquette. Pour plus d'informations, consultez Référence des éléments XML Link et Param et 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.
LinksControlOptions	Élément facultatif.Vous pouvez spécifier cet élément lors de la Type attribut est spécifié en tant que LinksControl. Définit les filtres de liens et la disposition des champs de colonne de façon à afficher la liste des liens. Pour plus d'informations, consultez Définir des contrôles de liens pour restreindre les relations de liens.
WebpageControlOptions	Élément facultatif.Vous pouvez spécifier cet élément lors de la Type l'attribut est WebpageControl. Spécifie les contrôles qui déterminent le chargement de la page Web cible dans le formulaire d'élément de travail. Pour plus d'informations, consultez Référence des éléments XML WebpageControlOptions et 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.
anyAttribute	Élément facultatif. Facultatif.Control est extensible via l'utilisation de l'élément anyAttribute.

Éléments parents

Élément	Description
Disposition	Obligatoire.Définit comment afficher les éléments sur le formulaire d'élément de travail.
Élément Column	Obligatoire.Définit les colonnes du formulaire.
Élément Tab	Obligatoire.Définit un onglet du formulaire.

Notes

Control est un élément enfant facultatif de Layout, Column et Tab.

Indicateurs Layout et Column :

minOccurs = "0"

maxOccurs = "1"

Indicateurs Tab :

minOccurs = "0"

maxOccurs = "unbounded"

Pour implémenter un contrôle personnalisé, vous devez spécifier le nom du contrôle pour l'attribut Type.Pour plus d'informations, consultez le site Web Microsoft : Contrôles personnalisés de suivi d'élément de travail (éventuellement en anglais).

Pour obtenir un exemple de chaque type de contrôle, consultez Spécifier des contrôles de formulaire d'élément de travail.

Exemple

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

Informations sur les éléments

Espace de noms	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nom du schéma	Définition du type d'élément de travail
Fichier de validation	WorkItemTypeDefinition.xsd
Type d'élément	Type complexe ControlType
Peut être vide	Non applicable