Freigeben über

Steuern des XML-Elementverweises

  • Artikel

Mit dem Control-Element werden ein Text, ein Link, ein Arbeitsaufgabenfeld oder ein anderes Steuerelement definiert, der bzw. das in einem Arbeitsaufgabenformular angezeigt werden soll. Beispiele für die Verwendung dieses Elements finden Sie unter Specify work item form controls und Design the work item form.

Schemahierarchie

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppieren

               Spalte

               TAB

<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" 
Padding="(top, bottom, left, right)" 
Margin="(top, bottom, left, right)" ReadOnly="True | False" MinimumSize="(width,height)" 
Name="InstanceName" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut

Beschreibung

FieldName

Optionales Control-Attribut.

Gibt das Arbeitsaufgabenfeld an, dem das Steuerelement zugeordnet wird. Der Attributtyp ist typelib:ReferenceFieldName. Mindestlänge: 1; maximale Länge: 70.

Musterwert: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

Musterwertbeispiel: Company.Division.IssueType

Type

Erforderliches Control-Attribut.

Gibt den Datentyp des Steuerelements an. Der Attributtyp ist ValidControlsType (einfacher Typ). Geben Sie eine Zeichenfolge von einem der folgenden integrierten Typen an:

  • AttachmentControl: Verwenden Sie diesen Typ, um Arbeitsaufgabenanlagen anzuzeigen. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp.

  • DateTimeControl: Verwenden Sie diesen Typ, um die formatierten Datenfelder mit dem Feldtyp DateTime anzuzeigen.

  • FieldControl: Verwenden Sie diesen Typ, um Nur-Text- oder numerische Felder und Listen mit Werten für Felder mit dem Feldtyp String, Identity, Integer, Double und PlainText anzuzeigen.

  • HtmlFieldControl: Verwenden Sie diesen Typ, um mehrzeiliges Rich-Text-Format von Feldern mit dem Feldtyp HTML anzuzeigen.

  • LabelControl: Verwenden Sie diesen Typ, um Text anzuzeigen, der keinem Feld zugeordnet ist. Der Text kann das Nur-Text- oder Linkformat besitzen. Sie können zusätzliche Steuerelemente mit den Elementen LabelText, Link und Text angeben. Weitere Informationen finden Sie unter XML-Elementreferenz für LabelText und Text und XML-Elementreferenz für Link und Param.

  • LinksControl: Verwenden Sie diesen Typ, um die Symbolleiste für Linksteuerelemente anzuzeigen und Linkbeziehungen zwischen Arbeitsaufgaben und Storyboards zu verwalten. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp. Mit dem Element LinksControlOptions geben Sie die zu filternden Linktypen und andere Steuerelementoptionen an. Weitere Informationen finden Sie unter LinksControlOptions-Elemente.

  • WebpageControl: Verwenden Sie diesen Typ, um HTML-basierten Inhalt anzuzeigen, der von einem URI definiert wird oder in einen CDATA-Tag eingebettet ist. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp. . Sie geben den Inhalt und die Links an, die mithilfe des WebpageControlOptions-Elements angezeigt werden. Weitere Informationen finden Sie unter XML-Elementreferenz für WebpageControlOptions.

  • WorkItemClassificationControl: Verwenden Sie diesen Typ, um die hierarchischen Pfadfelder mit dem Feldtyp TreePath anzuzeigen.

    Hinweis

    Das System.AreaPath-Feld und das System.IterationPath-Feld sind die einzigen Felder, die diesen Datentyp verwenden.Sie können kein benutzerdefiniertes Feld mithilfe dieses Datentyps definieren.

  • WorkItemLogControl: Verwenden Sie diesen Typ, um Informationen zum Arbeitsaufgabenverlauf und Felder mit dem Feldtyp History anzuzeigen.

    Hinweis

    Das System.History-Feld ist das einzige Feld, das diesen Datentyp verwendet.Sie können kein benutzerdefiniertes Feld mithilfe dieses Datentyps definieren.

Weitere Informationen finden Sie unter Specify work item form controls.

Hinweis

Sie können ein benutzerdefiniertes Steuerelement verwenden, indem Sie das Type-Attribut auf einen benutzerdefinierten Wert festlegen.Steuerelemente, deren Type-Wert nicht dem Namen eines integrierten Typs entspricht, werden wie benutzerdefinierte Steuerelemente behandelt.Weitere Informationen finden Sie auf der Microsoft-Website: Benutzerdefinierte Steuerelemente zum Nachverfolgen von Arbeitsaufgaben.

ControlFontSize

Optionales Control-Attribut.

Gibt den Schriftgrad des Feldnamens oder der Bezeichnung auf dem Formular an. Gültige Werte von FontSize: small, normal, large, xlarge und xxlarge.

EmptyText

Optionales Control-Attribut.

Gibt eine Textzeichenfolge mit einer Länge zwischen 1 und 255 Buchstaben an, die angezeigt wird, wenn ein Feld leer ist.

Label

Optionales Control-Attribut.

Gibt den sichtbaren Text auf dem Formular an, mit dem das Steuerelement identifiziert wird. Geben Sie eine Zeichenfolge mit höchstens 80 Zeichen an.

LabelFontSize

Gibt den Schriftgrad der Bezeichnung auf dem Formular an. Gültige Werte für FontSize: small, normal, large, xlarge und xxlarge.

LabelPosition

Optionales Control-Attribut.

Gibt die Position der Bezeichnung relativ zu den Steuerelementdaten an. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an:

  • Top: Platziert die Bezeichnung über den Steuerelementdaten.

  • Bottom: Platziert die Bezeichnung unter den Steuerelementdaten.

  • Left: Platziert die Bezeichnung links von den Steuerelementdaten.

  • Right: Platziert die Bezeichnung rechts von den Steuerelementdaten.

Padding

Optionales Control-Attribut.

Gibt den Raum in Pixel um den inneren Rahmen des Steuerelements an, der den Räumen oben, unten, links und rechts entspricht. Der Attributtyp ist SizeType.

Musterwert: ^\(\d+\,\d+\,\d+\,\d+\)$

Musterwertbeispiel: (2,0,2,0)

Margin

Optionales Control-Attribut.

Gibt den Raum in Pixel um den äußeren Rahmen des Steuerelements an, der den Räumen oben, unten, links und rechts entspricht. Der Attributtyp ist SizeType.

Musterwert: ^\(\d+\,\d+\,\d+\,\d+\)$

Musterwertbeispiel: (2,0,2,0)

ReadOnly

Optionales Control-Attribut.

Gibt an, dass das Feld schreibgeschützt ist. Der Attributtyp ist ReadOnlyType. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an:

  • True: Gibt an, dass die Steuerelementdaten schreibgeschützt sind.

  • False: Gibt an, dass die Steuerelementdaten nicht schreibgeschützt sind.

MinimumSize

Optionales Control-Attribut.

Gibt die minimale Größe in Pixel an, die das Steuerelement im Formular einnehmen sollte. Die Syntax wird in (width,height) angegeben. Der Attributtyp ist SizeType.

Musterwert: ^\(\d+\,\d+\)$

Musterwertbeispiel: (100,100)

Hinweis

Wenn in vertikaler Richtung nicht genügend Platz vorhanden ist, wird eine Bildlaufleiste angezeigt, um die Mindestgröße beizubehalten.Ohne dieses Attribut werden die Steuerelemente mit ihren Standardgrößen gezeichnet, außer wenn Steuerelemente in anderen Registerkarten mehr Platz benötigen.Die Gesamtgröße eines beliebigen einzelnen Formularsteuerelements hängt von der Größe des größten Formularbereichs bzw. der größten Registerkarte ab.

Name

Optionales Control-Attribut.

Identifiziert ein Steuerelement auf eindeutige Weise. Der Name ist wichtig, wenn einem Arbeitsaufgabenfeld mehr als ein Steuerelement eines Formulars zugeordnet ist. Der Attributtyp ist xs:string.

Hinweis

Sie verwenden das Name-Attribut, wenn Sie das gleiche Feld an mehr als einer Position im Formular anzeigen lassen möchten.Geben Sie für beide Steuerelementeinträge einen eindeutigen Wert für das Name-Attribut an, damit das System jedes Steuerelement eindeutig identifiziert.Es ist nützlich, dasselbe Steuerelement basierend auf dem Kontext der Registerkarten an verschiedenen Positionen anzuzeigen.

NumberFormat

Optionales Control-Attribut, das nur gültig ist, wenn es mit FieldControl verwendet wird.

Gibt die Zeichen an, die Sie im Feldsteuerelement eingeben können. Gültige Werte, die Sie verwenden können:

  • WholeNumbers: Gibt an, dass Ganzzahlen zugelassen werden.

  • SignedWholeNumbers: Gibt an, dass signierte Ganzzahlen zugelassen werden.

  • DecimalNumbers: Gibt an, dass Dezimalzahlen zugelassen werden.

  • SignedDecimalNumbers: Gibt an, dass signierte Dezimalzahlen zugelassen werden.

MaxLength

Optionales Control-Attribut, das nur gültig ist, wenn es mit FieldControl verwendet wird.

Gibt die maximale Länge zulässiger Zeichen für ein Feldsteuerelement an. Der Attributtyp ist xs:integer.

Format

Optionales Control-Attribut, das nur gültig ist, wenn es mit DateTimeControl verwendet wird.

Gibt das Format für das Datums-/Uhrzeitfeld an, das einem der Werte der DateTimePickerFormat-Enumeration entspricht. Gültige Werte, die Sie verwenden können:

  • Custom: Zeigt den Wert von Datum und Uhrzeit in einem benutzerdefinierten Format an. Das benutzerdefinierte Format kann durch Angeben von "Benutzerdefiniert" als Wert für das Formatattribut und Festlegen eines anderen Attributs mit dem Namen "CustomFormat" mit einer benutzerdefinierten Formatzeichenfolge festgelegt werden. Beispiel:

    Format="Custom"

    CustomFormat = "MMM tt, 'des Jahres' jjjj"

    Weitere Informationen finden Sie auf dieser Microsoft-Website: DateTimePicker.CustomFormat-Eigenschaft.

  • Long: Zeigt den Wert von Datum und Uhrzeit im langen Datumsformat an, das durch das Betriebssystem des Benutzers festgelegt ist.

  • Short: Zeigt den Wert von Datum und Uhrzeit im kurzen Datumsformat an, das durch das Betriebssystem des Benutzers festgelegt ist.

  • Time: Zeigt den Wert von Datum und Uhrzeit in dem Zeitformat an, das durch das Betriebssystem des Benutzers festgelegt ist.

Weitere Informationen finden Sie auf dieser Microsoft-Website: DateTimePickerFormat-Enumeration.

CustomFormat

Optionales Control-Attribut, das nur gültig ist, wenn es mit DateTimeControl und dem Format-Attribut verwendet wird.

Gibt das benutzerdefinierte Format für das Datums-/Uhrzeitfeld an, das der für die DateTimePicker.CustomFormat-Eigenschaft definierten Syntax entspricht. Weitere Informationen finden Sie auf dieser Microsoft-Website: DateTimePicker.CustomFormat-Eigenschaft.

Untergeordnete Elemente

Element

Beschreibung

LabelText

Optionales Element. Sie können dieses Element angeben, wenn das Type-Attribut als FieldControl oder LabelControl angegeben wird.

Containerelement zum Angeben von Text, Link und Position von einem Feld oder einer Bezeichnung, deren Text teilweise einem Link zugeordnet ist.

Weitere Informationen finden Sie unter XML-Elementreferenz für LabelText und Text und Provide help text, hyperlinks, or web content on a work item form.

Link

Optionales Element. Sie können dieses Element angeben, wenn das Type-Attribut als FieldControl oder LabelControl angegeben wird.

Definiert den Link für ein Feld oder eine Bezeichnung.

Weitere Informationen finden Sie unter XML-Elementreferenz für Link und Param und Provide help text, hyperlinks, or web content on a work item form.

LinksControlOptions

Optionales Element. Sie können dieses Element angeben, wenn das Type-Attribut als LinksControl angegeben wird.

Definiert die Linkfilter und das Layout von Spaltenfeldern, um die Liste der Links anzuzeigen.

Weitere Informationen finden Sie unter Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen.

WebpageControlOptions

Optionales Element. Sie können dieses Element festlegen, wenn das Type-Attribut WebpageControl ist.

Gibt die Steuerelemente an, die das Laden des Webseitenziels im Arbeitsaufgabenformular steuern.

Weitere Informationen finden Sie unter XML-Elementreferenz für WebpageControlOptions und Provide help text, hyperlinks, or web content on a work item form.

anyAttribute

Optionales Element.

Dies ist optional. Control ist durch die Verwendung des anyAttribute-Elements erweiterbar.

Übergeordnete Elemente

Element

Beschreibung

Layout

Erforderlich. Definiert, wie die Elemente auf dem Arbeitsaufgabenformular angezeigt werden.

Column-Element

Erforderlich. Definiert Spalten für das Formular.

Tab-Element

Erforderlich. Definiert eine Registerkarte für das Formular.

Hinweise

Control ist ein optionales untergeordnetes Element von Layout, Column und Tab.

Layout- und Column-Indikatoren:

minOccurs = "0"

maxOccurs = "1"

Tab-Indikatoren:

minOccurs = "0"

maxOccurs = "unbounded"

Um ein benutzerdefiniertes Steuerelement zu implementieren, muss der Name des Steuerelements für das Type-Attribut angegeben werden. Weitere Informationen finden Sie auf der Microsoft-Website: Benutzerdefinierte Steuerelemente zum Nachverfolgen von Arbeitsaufgaben.

Ein Beispiel für jeden Steuerelementtyp finden Sie unter Specify work item form controls.

Beispiel

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" Padding="(2,0,2,0)" Margin="(2,2,2,2)" />

Elementinformationen

Namespace

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Schemaname

Definition des Arbeitsaufgabentyps

Validierungsdatei

WorkItemTypeDefinition.xsd

Elementtyp

Komplexer ControlType-Typ

Kann leer sein

Nicht zutreffend

Siehe auch

Konzepte

Verweis für alle FORM-XML-Elemente

Specify work item form controls

Weitere Ressourcen

Entwerfen und Anpassen eines Arbeitsaufgabenformulars