Określanie sterowania formularzem elementu pracy

Ten temat zawiera krótkie odwołanie do Control element, jego elementy podrzędne i atrybuty.Do każdego pola lub formantu formularza, który ma być wyświetlany w formularzu elementu roboczego, dodaj element Control.

Można dostosować formularz elementu roboczego, aby wyświetlać informacje pomagające zespołowi w poprawnym korzystaniu z formularza.Możesz dodać pola elementów roboczych i formantów umożliwiających wprowadzanie i wyświetlanie danych, które mają być śledzone.

Element Control zapewnia dziewięć wartości dla atrybutu Type, który służy do dodawania pól lub wyświetlania tekstu zwykłego lub hiperłącza tekstu lub pola.Ponadto można zdefiniować specjalne formanty do dodawania łączy i załączników, wyświetlać zawartość sieci Web lub utworzyć własny formant i dodać go do formularza elementu roboczego.

Dodaj pola elementów roboczych

Podczas dostosowywania formularza elementu roboczego zazwyczaj dodajesz podzbiór pól elementu roboczego, zdefiniowane dla typu elementu roboczego, który ma być wyświetlany w formularzu.Definicje pól kontrolują wiele aspektów danych, które są wyświetlane, lub danych, które można wprowadzić w formularzu.Aby uzyskać więcej informacji, zobacz Modyfikowanie lub dodawanie pola do obsługi zapytań, raportów i przepływu pracy.

Każde pole elementu roboczego jest skojarzone z typem danych.Możesz użyć informacji z poniższej tabeli, aby określić, który typ pola jest obsługiwany przez który atrybut Type elementu Control.Użyj atrybutu Label, aby określić tekst wyświetlany obok formantu.Użyj atrybutu LabelPosition, aby określić, gdzie etykieta jest wyświetlana względem kontroli.Aby uzyskać więcej informacji, zobacz Kontrola wyświetlania pól elementów pracy.

[!UWAGA]

Nie można zmienić wartości pól systemowych, które są automatycznie aktualizowane.Na przykład pola Data utworzenia i Utworzono przez są definiowane przy pierwszym zapisaniu elementu roboczego.Jednak można użyć tych pól w kryteriach wyszukiwania.Opis każdego systemu, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

Typ pola	Atrybut typu elementu sterowania	Użycie
DateTime	FieldControl DateTimeControl	Użyj FieldControl, aby zapewnić pole tekstowe dla danych wejściowych lub wyświetlanie pola dane DateTime. <Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" /> Użyj DateTimeControl, aby zapewnić próbnik kalendarza, aby wybrać datę dla pola, jak pokazano na poniższej ilustracji. <Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
Double	FieldControl	Użyj FieldControl, aby zapewnić pole tekstowe dla danych wejściowych lub wyświetlanie pól Double. <Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />
History	WorkItemLogControl	Używasz WorkItemLogControl, aby zapewnić pole formantu dla pól historii, które śledzą wątki dyskusji i inne informacje historyczne, jak pokazano na poniższej ilustracji. Możesz użyć tego formantu tylko do obsługi wyświetlania pola historii elementu roboczego, pole elementu roboczego System.History.Za pomocą tego formantu można rozwijać i zwijać szczegóły dotyczące historycznych poprawek elementu pracy.Możesz również sformatować tekst dodawany do pola historii. <Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />
HTML	HTMLControl	Użyj HTMLControl, aby zapewnić pole formantu, który umożliwia polom HTML przechwytywanie formatu rich-text, jak pokazano na poniższej ilustracji. <Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />
Integer	FieldControl	Użyj FieldControl, aby zapewnić pole formantu dla pola Liczba całkowita. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	Użyj FieldControl, aby zapewnić pole formantu dla pola PlainText, takiego jak pole tekstowe, które zawiera opisy, które mogą być większe niż 255 znaków. <Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />
String	FieldControl	Użyj FieldControl, aby zapewnić pole formantu dla pola Ciągu.Pola ciągów są ograniczone do 255 znaków. <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
TreePath	WorkItemClassificationControl	Użyj WorkItemClassificationControl, aby zapewnić pole formantu dla pola TreePath. <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Opcjonalne atrybuty pól elementów formantów dla wszystkich typów formantów

Następujące atrybuty opcjonalne można określić tylko dla tych typów kontroli, które są wymienione.

Atrybut	Opis
Field	Określa formant, który jest skojarzony z polem elementu roboczego.
Label	Określa tekst wyświetlany w formularzu, który identyfikuje formant.Określ ciąg składający się z nie więcej niż 80 znaków. [!UWAGA] Możesz dołączyć hiperłącze do etykiety pola dodanej do formularza elementu roboczego przy użyciu FieldControl.Ten formant jest używany w celu tworzenia łączy do informacji o sposobie używania pola.Aby uzyskać więcej informacji, zobacz Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy.
LabelPosition	Określa pozycję etykiety związanej z danymi z kontroli.Określ ciąg z jednej z następujących wartości: Top, Bottom, Left, i Right.
Dock	Określa wyrównanie etykiety z określoną stroną kontenera lub rozciąga pole, aby wypełnić kontener.Określ ciąg z jednej z następujących wartości: Fill, Top, Bottom, Left i Right.
Padding	Określa ilość miejsca, w pikselach, wokół wewnętrznego obramowania formantu.Dostarczone są cztery wartości, które odnoszą się do górnej, dolnej, lewej i prawej strony.Na przykład: (2,0,2,0).
Margin	Określa ilość miejsca, w pikselach, wokół zewnętrznego obramowania formantu.Dostarczone są cztery wartości, które odnoszą się do górnej, dolnej, lewej i prawej strony.Na przykład: (2,0,2,0).
ReadOnly	Określa, że jest to pole tylko do odczytu.Określ True lub False.
MinimumSize	Określa minimalny rozmiar w pikselach, który formant powinien zajmować w formularzu.Określane są dwie wartości odpowiadające szerokości i wysokości.Na przykład: (100,100).
Name	Jednoznacznie identyfikuje formant.Atrybut Name jest wymagany, jeśli więcej niż jeden formant w formularzu jest skojarzony z tym samym polem elementu roboczego. [!UWAGA] Używasz atrybutu Name, aby wyświetlać to samo pole w kilku obszarach na formularzu.Określasz unikatową wartość dla atrybutu Name dla obu wpisów kontroli, tak aby system jednoznacznie identyfikował każdy formant.Warto pokazać ten sam formant w różnych miejscach na podstawie kontekstu kart.

Opcjonalne atrybuty pól elementów formantów dla określonych typów formantów

Następujące atrybuty opcjonalne można określić tylko dla tych typów kontroli, które są wymienione.

Atrybut	Typy formantów	Opis
NumberFormat	FieldControl	Określa znaki, które można wprowadzać w formancie pola.Następujące wartości są prawidłowe: WholeNumbers, SignedWholeNumbers, DecimalNumbers i SignedDecimalNumbers.
MaxLength	FieldControl	Określa maksymalną długość znaków, których można użyć do sterowania polem.
Format	DateTimeControl	Określa format dla pola data-godzina, który odpowiada jednej wartości wyliczenia DateTimePickerFormat.Następujące wartości są prawidłowe: Custom, Long, Short, Time.
CustomFormat	DateTimeControl	Określa format niestandardowy, wykorzystywany dla pola data-godzina, które odpowiada składni zdefiniowanej dla właściwości DateTimePicker.CustomFormat.

Dodaj specjalne formanty

Poniższa tabela opisuje atrybuty Control element Type, które zapewniają obsługę, umożliwiając zarządzanie załącznikami plików, tworzenie łączy, wyświetlanie zawartość sieci Web i wyświetlanie innych danych, które nie są związane z polem elementu roboczego.

Atrybut typu elementu sterowania	Użycie
AttachmentsControl	Użyj do dołączania plików do formularza elementu roboczego.Ten formant jest zwykle zawarty we własnej grupie kart, jak pokazano na poniższej ilustracji. Formant załączników Aby uzyskać więcej informacji, zobacz Dodawanie funkcji kontroli załączników.
LabelControl	Użyj do wyświetlania testu zwykłego lub hiperłącza tekstu, który nie jest powiązany z polem, jak pokazano na poniższej ilustracji. Używasz elementów podrzędnych i pojemnika LabelText i Link do określenia tekstu, hiperłącza i położenia pola lub etykiety, którego tekst jest częściowo skojarzony z hiperłączem.Aby uzyskać więcej informacji, zobacz Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy, LabelText i odnośniki do elementów tekstowych XML i Elementy XML Link and Param — Odwołanie.
LinksControl	Użyj do tworzenia i zarządzania łączami między elementami roboczymi.Ten formant jest zwykle zawarty we własnej grupie kart, jak pokazano na poniższej ilustracji. Używasz LinksControlOptions do definiowania filtrów łącza i układu pól kolumn, które są używane do wyświetlania listy łączy.Aby uzyskać więcej informacji, zobacz Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi i Elementy LinksControlOptions.
WebpageControl	Użyj do wyświetlania zawartości sieci Web w formie elementu roboczego.Ten formant jest zwykle zawarty w własnej grupie kart.Używasz elementów podrzędnych WebpageControlOptions i Link, aby określać formanty, które są wymagane do załadowania docelowej strony sieci Web w formularzu elementu roboczego. Aby uzyskać więcej informacji, zobacz Edytowanie definicji typu elementu roboczego w celu dodania zawartości WWW do formularza elementu pracy, WebpageControlOptions Elementy XML — Odwołanie i Elementy XML Link and Param — Odwołanie.

Dodaj formanty niestandardowe

Oprócz wbudowanych formantów można dodawać własny niestandardowy formant do formularza elementu roboczego.

Na przykład można dodać formant niestandardowy, aby przechwycić zrzut ekranu ze Schowka.Lub można zapewnić formant do przechwytywania wielu wartości przez dodanie pola wyboru dla wartości, które są przedstawione na liście lub w menu.

Aby zaimplementować formant niestandardowy, należy określić nazwę formantu dla atrybutu Type.

Zobacz też

Zadania

Zmian układu formularza elementu pracy

Edytowanie definicji typu elementu roboczego w celu dodania zawartości WWW do formularza elementu pracy

Informacje

Element formantu XML — Odwołanie