XML-Elementreferenz für Control

  • Artikel

Mit dem Control-Element werden ein Arbeitsaufgabenfeld, Text, ein Link oder ein anderes Steuerelement definiert, der bzw. das in einem Arbeitsaufgabenformular angezeigt werden soll. Beispiele für die Verwendung dieses Elements finden Sie unter Angeben von Steuerelementen für Arbeitsaufgabenformulare. Weitere Informationen finden Sie unter Entwerfen und Anpassen eines Arbeitsaufgabenformulars.

Schemahierarchie

WITD

   WORKITEMTYPE

       FORM

           Layout

               Gruppe

               Spalte

               Registerkarte

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

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" 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>

Attribute und Elemente

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

Attribute

Attribute

Beschreibungen

FieldName

Optionales ControlType-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 ControlType-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, um Arbeitsaufgabenanlagen anzuzeigen. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp.

  • DateTimeControl: Verwenden, um die formatierten Datenfelder mit einem Feldtyp von DateTime anzuzeigen.

  • FieldControl: Verwenden, um textliche oder numerische Felder und Listen der Werte für Felder mit einem Feldtyp von String, Identity, Integer, Double und PlainText anzuzeigen.

  • HtmlFieldControl: Verwenden, um mehrzeiliges Rich-Text-Format von Feldern mit einem Feldtyp von HTML anzuzeigen.

  • LabelControl: Verwenden, um Text anzuzeigen, der einem Feld nicht zugeordnet ist. Der Text kann das Nur-Text- oder Linkformat besitzen.

  • LinksControl: Verwenden, um Arbeitsaufgabenlinks anzuzeigen. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp.

  • WebpageControl: Verwenden, um HTML-basierten, von einem URI definierten oder innerhalb eines CDATA-Tags eingebetteten Inhalt anzuzeigen. Dieses Steuerelement besitzt kein zugeordnetes Feld oder einen Feldtyp.

  • WorkItemClassificationControl Verwenden, um die hierarchischen Pfadfelder mit einem Feldtyp von TreePath anzuzeigen.

    HinweisHinweis
    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, um Arbeitsaufgabenverlaufsinformationen und Felder mit einem Feldtyp von History anzuzeigen.

    HinweisHinweis
    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 Angeben von Steuerelementen für Arbeitsaufgabenformulare.

HinweisHinweis
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 unter: Work Item Tracking Custom Controls.

Label

Optionales ControlType-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.

LabelPosition

Optionales ControlType-Attribut.

Gibt die Position der Bezeichnung relativ zu den Steuerelementdaten an. Geben Sie eine Zeichenfolge von 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.

Dock

Optionales ControlType-Attribut.

Richtet das Feld zusammen mit der angegebenen Seite des Containers aus oder streckt das Feld, damit es den Container ausfüllt. Der Attributtyp ist DockType. Geben Sie eine Zeichenfolge von einem der folgenden Werte an:

  • Fill: Richtet das Feld so aus, dass es den Container ausfüllt. Dieser Wert ist keine unterstützte Ausrichtung für das Splitter-Element.

  • Top: Richtet das Feld zusammen mit der Oberseite des Containers aus. Dieser Wert ist keine unterstützte Ausrichtung für das Splitter-Element.

  • Bottom: Richtet das Feld zusammen mit der Unterseite des Containers aus. Dieser Wert ist keine unterstützte Ausrichtung für das Splitter-Element.

  • Left: Richtet das Feld zusammen mit der linken Seite des Containers aus.

  • Right: Richtet das Feld zusammen mit der rechten Seite des Containers aus. Dieser Wert ist keine unterstützte Ausrichtung für das Splitter-Element.

Padding

Optionales ControlType-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 ControlType-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 ControlType-Attribut.

Gibt an, dass das Feld schreibgeschützt ist. Der Attributtyp ist ReadOnlyType. Geben Sie eine Zeichenfolge von 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 ControlType-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)

HinweisHinweis
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 ControlType-Attribut.

Bezeichnet ein Steuerelement eindeutig. Der Name ist wichtig, wenn einem Arbeitsaufgabenfeld mehr als ein Steuerelement eines Formulars zugeordnet ist. Der Attributtyp ist xs:string.

HinweisHinweis
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 ControlType-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 ControlType-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 ControlType-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. Beispiele:

    Format="Custom"

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

    Weitere Informationen dazu finden Sie auf der 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 dazu finden Sie auf der Microsoft-Website: DateTimePickerFormat Enumeration.

CustomFormat

Optionales ControlType-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 dazu finden Sie auf der Microsoft-Website: DateTimePicker.CustomFormat-Eigenschaft.

Untergeordnete Elemente

Element

Beschreibungen

LabelText

Optionales Element Sie können dieses Element angeben, wenn ControlType 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 Bereitstellen von Hilfetexten, Prozessleitfäden, Webinhalten und Links zu Webseiten auf einem Arbeitsaufgabenformular.

Link

Optionales Element Sie können dieses Element angeben, wenn ControlType 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 Bereitstellen von Hilfetexten, Prozessleitfäden, Webinhalten und Links zu Webseiten auf einem Arbeitsaufgabenformular.

LinksControlOptions

Optionales Element Sie können dieses Element angeben, wenn ControlType 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 Link-Steuerelementen zum Einschränken der Link-Beziehungen.

WebpageControlOptions

Optionales Element Sie können das Element angeben, wenn ControlType 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 Bereitstellen von Hilfetexten, Prozessleitfäden, Webinhalten und Links zu Webseiten auf einem Arbeitsaufgabenformular.

anyAttribute

Optionales Element

Optional. ControlType ist durch die Verwendung des anyAttribute-Elements erweiterbar. ProcessContents: skip.

Übergeordnete Elemente

Element

Beschreibungen

Layout

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

Column-Element

Erforderlich. Definiert Spalten für das Formular.

Registerkarten-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 unter: Work Item Tracking Custom Controls.

Ein Beispiel für jeden Steuerelementtyp finden Sie unter Angeben von Steuerelementen für Arbeitsaufgabenformulare.

Beispiel

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

Elementinformationen

Namespace

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

Schemaname

Arbeitsaufgabentypdefinition

Validierungsdatei

WorkItemTypeDefinition.xsd

Elementtyp

Komplexer ControlType-Typ

Kann leer sein

Nicht zutreffend

Siehe auch

Konzepte

Entwerfen und Anpassen eines Arbeitsaufgabenformulars

XML-Elementreferenz für FORM

Angeben von Steuerelementen für Arbeitsaufgabenformulare

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

Januar 2011

Untergeordnete Elemente zur Syntax hinzugefügt, Links zu Themen ersetzt oder entfernt, die entfernt wurden.

Informationsergänzung.