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. Stellen Sie mit DateTimeControl eine Kalenderauswahl zum Auswählen eines Datums für ein Feld bereit, wie in der folgenden Abbildung dargestellt. .png "Kalenderfeld")
|
Double |
FieldControl |
Verwenden Sie FieldControl, um ein Textfeld für die Eingabe oder Anzeige von Double-Feldern bereitzustellen. |
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. .png "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. |
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. .png "HTML-Feld im Arbeitsaufgabenformular")
|
Integer |
FieldControl |
Verwenden Sie FieldControl, um ein Kontrollfeld für ein Ganzzahlfeld bereitzustellen. |
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. |
String |
FieldControl |
Verwenden Sie FieldControl, um ein Kontrollfeld für ein Zeichenfolgenfeld bereitzustellen. Zeichenfolgenfelder sind auf 255 Zeichen beschränkt. |
TreePath |
WorkItemClassificationControl |
Verwenden Sie WorkItemClassificationControl, um ein Kontrollfeld für ein TreePath-Feld bereitzustellen. |
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 .png "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. .png "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. .png "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