Freigeben über


Angeben von Steuerelementen für Arbeitsaufgabenformulare

Dieses Thema enthält eine Kurzübersicht über das Element Control sowie dessen untergeordnete Elemente und Attribute. Für jedes Feld oder jedes Formularsteuerelement, das Sie in einem Arbeitsaufgabenformular anzeigen möchten, wird ein Control-Element hinzugefügt.

Ein Arbeitsaufgabenformular kann angepasst werden, um Informationen anzuzeigen, die das Team bei der richtigen Verwendung des Formulars unterstützen. Sie können Arbeitsaufgabenfelder und -steuerelemente hinzufügen, die das Eingeben und Anzeigen der Daten ermöglichen, die nachverfolgt werden sollen.

Mit dem Control-Element werden neun Werte für das Type-Attribut bereitgestellt, mit dem Sie Felder hinzufügen, oder Nur-Text oder Linktext bzw. Felder anzeigen können. Zudem können Sie spezielle Steuerelemente zum Hinzufügen von Links und Anlagen und zum Anzeigen von webbasiertem Inhalt definieren, oder ein eigenes Steuerelement erstellen, das Sie einem Arbeitsaufgabenformular hinzufügen.

Hinzufügen von Arbeitsaufgabenfeldern

Wenn Sie das Arbeitsaufgabenformular anpassen, fügen Sie in der Regel eine Teilmenge der für den Arbeitsaufgabentyp definierten Arbeitsaufgabenfelder ein, die auf dem Formular angezeigt werden sollen. Die Felddefinitionen steuern viele Aspekte davon, welche Daten angezeigt werden oder welche Daten in das Formular eingegeben werden können. Weitere Informationen finden Sie unter Ändern oder Hinzufügen eines Felds zur Unterstützung von Abfragen, Berichten und Workflow.

Jedes Arbeitsaufgabenfeld ist einem Datentyp zugeordnet. Sie können die Informationen der folgenden Tabelle verwenden, um zu bestimmen, welcher Feldtyp von welchem Type-Attribut des Control-Elements unterstützt wird. Mit dem Label-Attribut geben Sie den Text an, der neben dem Steuerelement angezeigt wird. Mit dem verknüpften LabelPosition-Attribut legen Sie fest, an welcher Position relativ zum Steuerelement die Bezeichnung angezeigt wird. Weitere Informationen finden Sie unter Steuern der Anzeige von Arbeitsaufgabenfeldern.

Hinweis

Die Werte von Systemfeldern können nicht geändert werden. Sie werden automatisch aktualisiert.Beispielsweise werden die Felder "Erstellungsdatum" und "Erstellt von" definiert, wenn eine Arbeitsaufgabe zum ersten Mal gespeichert wird.Sie können diese Felder jedoch als Suchkriterien verwenden.Eine Beschreibung des jeweiligen Systemfelds finden Sie unter Arbeitsaufgabenfeld-Verweis für Visual Studio ALM.

Feldtyp

Steuerelementtypattribut

Verwendung

DateTime

FieldControl

DateTimeControl

Stellen Sie mit FieldControl ein Textfeld für die Eingabe oder Anzeige eines DateTime-Datentypfelds bereit.

<Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" />

Stellen Sie mit DateTimeControl eine Kalenderauswahl zum Auswählen eines Datums für ein Feld bereit, wie in der folgenden Abbildung dargestellt.

Kalenderfeld
<Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />

Double

FieldControl

Verwenden Sie FieldControl, um ein Textfeld für die Eingabe oder Anzeige von Double-Feldern bereitzustellen.

<Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />

History

WorkItemLogControl

Stellen Sie mit WorkItemLogControl ein Kontrollfeld für Verlaufsfelder zur Nachverfolgung von Diskussionsthemen und anderen Versionsinformationen bereit, wie in der folgenden Abbildung dargestellt.

Registerkarte und Feld für den Verlauf in einem Arbeitsaufgabenformular

Dieses Steuerelement kann nur zur Unterstützung der Anzeige des Verlaufsfelds einer Arbeitsaufgabe, des Arbeitsaufgabenfelds "System.History", verwendet werden. Mithilfe dieses Steuerelements können Sie Details zu Verlaufsrevisionen einer Arbeitsaufgabe erweitern und reduzieren. Zudem können Sie einen Text, den Sie dem Verlaufsfeld hinzufügen, formatieren.

<Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description
and History" LabelPosition="Top" Dock="Fill" />

HTML

HTMLControl

Stellen Sie mit HTMLControl ein Kontrollfeld für HTML-Felder bereit, um die RTF-Formatierung (Rich Text Format) zu erfassen, wie in der folgenden Abbildung dargestellt.

HTML-Feld im Arbeitsaufgabenformular
<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />

Integer

FieldControl

Verwenden Sie FieldControl, um ein Kontrollfeld für ein Ganzzahlfeld bereitzustellen.

<Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />

PlainText

FieldControl

Mit FieldControl können Sie ein Kontrollfeld für ein PlainText-Feld, z. B. ein Textfeld, bereitstellen, das Beschreibungen mit mehr als 255 Zeichen enthalten kann.

<Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />

String

FieldControl

Verwenden Sie FieldControl, um ein Kontrollfeld für ein Zeichenfolgenfeld bereitzustellen. Zeichenfolgenfelder sind auf 255 Zeichen beschränkt.

<Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />

TreePath

WorkItemClassificationControl

Verwenden Sie WorkItemClassificationControl, um ein Kontrollfeld für ein TreePath-Feld bereitzustellen.

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

Optionale Steuerelementfeldattribute für alle Steuerelementtypen

Die folgenden optionalen Attribute können nur für die aufgeführten Steuerelementtypen angegeben werden.

Attribut

Beschreibung 

Field

Gibt das Steuerelement an, das dem Arbeitsaufgabenfeld zugeordnet ist.

Label

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

Hinweis

Sie können einen Link an die Bezeichnung eines Felds anfügen, das mit FieldControl zu dem Arbeitsaufgabenformular hinzugefügt wird.Dieses Steuerelement ist nützlich für das Bereitstellen eines Links, um auf Informationen über die Verwendung des Felds zuzugreifen.Weitere Informationen finden Sie unter Bereitstellen von Hilfetext, Links oder Webinhalten für ein Arbeitsaufgabenformular.

LabelPosition

Gibt die Position der Bezeichnung relativ zu den Steuerelementdaten an. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an: Top, Bottom, Left und Right.

Dock

Gibt die Ausrichtung der Bezeichnung nach der angegebenen Seite des Containers an oder streckt das Feld, damit es den Container ausfüllt. Geben Sie eine Zeichenfolge mit einem der folgenden Werte an: Fill, Top, Bottom, Left und Right.

Padding

Gibt den Platz um den inneren Rahmen des Steuerelements in Pixeln an. Vier Werte werden bereitgestellt, die oben, unten, links und rechts entsprechen. Zum Beispiel: (2,0,2,0).

Margin

Gibt den Platz um den äußeren Rahmen des Steuerelements in Pixeln an. Vier Werte werden bereitgestellt, die oben, unten, links und rechts entsprechen. Zum Beispiel: (2,0,2,0).

ReadOnly

Gibt an, dass das Feld schreibgeschützt ist. Geben Sie True oder False an.

MinimumSize

Gibt die minimale Größe in Pixel an, die das Steuerelement im Formular einnehmen sollte. Zwei Werte werden angegeben, die der Breite und der Höhe entsprechen. Zum Beispiel: (100,100).

Name

Identifiziert ein Steuerelement auf eindeutige Weise. Das Name-Attribut ist erforderlich, wenn einem Arbeitsaufgabenfeld mehr als ein Steuerelement eines Formulars zugeordnet ist.

Hinweis

Verwenden Sie das Name-Attribut, um dasselbe Feld in mehreren Formularbereichen anzuzeigen.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.

Optionale Steuerelementfeldattribute für spezifische Steuerelementtypen

Die folgenden optionalen Attribute können nur für die aufgeführten Steuerelementtypen angegeben werden.

Attribut

Steuerelementtypen

Beschreibung 

NumberFormat

FieldControl

Gibt die Zeichen an, die Sie im Feldsteuerelement eingeben können. Die folgenden Werte sind gültig: WholeNumbers, SignedWholeNumbers, DecimalNumbers und SignedDecimalNumbers.

MaxLength

FieldControl

Gibt die maximale Länge von Zeichen an, die Sie für ein Feldsteuerelement verwenden können.

Format

DateTimeControl

Gibt das Format für das Datums-/Uhrzeitfeld an, das einem Wert der DateTimePickerFormat-Enumeration entspricht. Folgende Werte sind gültig: Custom, Long, Short, Time.

CustomFormat

DateTimeControl

Gibt das benutzerdefinierte Format für das Datums-/Uhrzeitfeld an, das der für die DateTimePicker.CustomFormat-Eigenschaft definierten Syntax entspricht.

Hinzufügen von speziellen Steuerelementen

In der folgenden Tabelle werden die Control-Attribute des Type-Elements beschrieben, die das Verwalten von Dateianlagen, das Erstellen von Links, das Anzeigen von webbasiertem Inhalt und das Anzeigen weiterer Daten, die keinem Arbeitsaufgabenfeld zugeordnet sind, unterstützen.

Steuerelementtypattribut

Verwendung

AttachmentsControl

Verwenden Sie dieses Attribut, um Dateien an ein Arbeitsaufgabenformular anzufügen. Dieses Steuerelement ist normalerweise in einer eigenen Gruppe von Registerkarten enthalten, wie in der folgenden Abbildung gezeigt.



Anlagen-Steuerelement

Dateien an eine Arbeitsaufgabe anfügen

Weitere Informationen finden Sie unter Hinzufügen des Anlagen-Steuerelements.

LabelControl

Verwenden Sie das Attribut, um Nur-Text oder Linktext anzuzeigen, der keinem Feld zugeordnet ist, wie in der folgenden Abbildung dargestellt.

Beispiel für zwei auf einen Text angewendete Links

Verwenden Sie die untergeordneten Elemente und Containerelemente LabelText und Link, um Text, Link und Position eines Felds oder einer Bezeichnung anzugeben, dessen bzw. deren Text teilweise einem Link zugeordnet ist. Weitere Informationen finden Sie unter Bereitstellen von Hilfetext, Links oder Webinhalten für ein Arbeitsaufgabenformular, XML-Elementreferenz für LabelText und Text und XML-Elementreferenz für Link und Param.

LinksControl

Erstellen und verwalten Sie mit dem Attribut Links zwischen Arbeitsaufgaben. Dieses Steuerelement ist normalerweise in einer eigenen Gruppe von Registerkarten enthalten, wie in der folgenden Abbildung gezeigt.

Beispiel für ein Steuerelement für Links, das einem Arbeitsaufgabenformular hinzugefügt wurde

Verwenden Sie den Typ LinksControlOptions, um die Linkfilter und das Layout von Spaltenfeldern zu definieren, die verwendet werden, um die Liste der Links anzuzeigen. Weitere Informationen finden Sie unter Definieren von Linksteuerelementen zum Einschränken der Linkbeziehungen und LinksControlOptions-Elemente.

WebpageControl

Verwenden Sie das Attribut, um Webinhalt in einem Arbeitsaufgabenformular anzuzeigen. Dieses Steuerelement ist normalerweise in einer eigenen Registerkartengruppe enthalten. Mithilfe der untergeordneten Elemente WebpageControlOptions und Link geben Sie die Steuerelemente an, die erforderlich sind, um das Webseitenziel in das Arbeitsaufgabenformular zu laden.

Weitere Informationen finden Sie unter Bearbeiten einer WIT-Definition zum Hinzufügen von Webinhalt zu einem Arbeitsaufgabenformular, XML-Elementreferenz für WebpageControlOptions und XML-Elementreferenz für Link und Param.

Hinzufügen von benutzerdefinierten Steuerelementen

Zusätzlich zu den integrierten Steuerelementen können Sie ein eigenes benutzerdefiniertes Steuerelement zu einem Arbeitsaufgabenformular hinzufügen.

Sie können z. B. ein benutzerdefiniertes Steuerelement hinzufügen, um eine Bildschirmabbildung von der Zwischenablage aufzuzeichnen. Sie können auch ein Steuerelement für die Aufzeichnung mehrerer Werte bereitstellen, indem ein Kontrollkästchen für die in einer Liste oder einem Menü aufgeführten Werte hinzugefügt wird.

Um ein benutzerdefiniertes Steuerelement zu implementieren, müssen Sie den Namen des Steuerelements für das Type-Attribut angeben.

Siehe auch

Aufgaben

Ändern des Formularlayouts von Arbeitsaufgaben

Bearbeiten einer WIT-Definition zum Hinzufügen von Webinhalt zu einem Arbeitsaufgabenformular

Referenz

Steuern des XML-Elementverweises