Określanie sterowania formularzem elementu pracy

Ten temat zawiera krótkie odwołanie doControlelement, jego elementy podrzędne i atrybuty. Dla każdego pola lub formantu formularza, które mają być wyświetlane w formularzu elementów roboczych, możesz dodaćControlelementu.

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.

ControlElement udostępnia dziewięć wartości dlaTypeatrybut, który służy do dodawania pól lub, aby wyświetlić tekst zwykły lub hiperłącze 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, zobaczModyfikowanie lub dodawanie pola do obsługi zapytań, raportów i przepływu pracy.

Każde pole elementu roboczego jest skojarzone z typem danych. Informacje w poniższej tabeli służy do ustalania, według której obsługiwany typ polaTypeatrybutuControlelementu. UżyjLabelatrybutu, aby określić tekst wyświetlany obok formantu. Użyj pokrewnyLabelPositionatrybutu, aby określić, gdzie Etykieta pojawia się względem formantu. Aby uzyskać więcej informacji, zobaczKontrola 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 pola systemu, zobaczOdwołania pola elementu pracy dla Visual Studio ALM.

Typ pola	Atrybut typu elementu sterowania	Użycie
DateTime	FieldControl DateTimeControl	UżyjFieldControlzapewnienie pola tekstowego danych wejściowych lub wyświetlania pola typu Data/Godzina danych. <Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" /> UżyjDateTimeControlzapewnienie selektora kalendarza umożliwia wybranie daty dla pola, co zostało pokazane na poniższej ilustracji. <Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
Double	FieldControl	UżyjFieldControlzapewnienie pola tekstowego danych wejściowych lub wyświetlanie podwójne pól. <Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />
History	WorkItemLogControl	Możesz użyćWorkItemLogControlzapewnienie pole sterowania pól historii śledzenia wątków dyskusji oraz inne informacje historyczne, co zostało pokazane 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żyjHTMLControlzapewnienie formantu pola, które umożliwiają HTML pola do przechwytywania formatowania tekstu, co zostało pokazane na poniższej ilustracji. <Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />
Integer	FieldControl	UżyjFieldControldostarczający pole formantu dla pola Liczba całkowita. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	UżyjFieldControlzapewnienie pole formantu pola zwykłego tekstu, takich jak pole tekstowe, który zawiera opisami, które może być większa niż 255 znaków. <Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />
String	FieldControl	UżyjFieldControldostarczający 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żyjWorkItemClassificationControldostarczający 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 Hiperłącze można dołączyć do etykiety pola, który zostanie dodany do formularza elementu pracy przy użyciuFieldControl.Ten formant jest używany w celu tworzenia łączy do informacji o sposobie używania pola.Aby uzyskać więcej informacji, zobaczDodawanie 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:TopBottomLeftiRight.
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:FillTopBottomLeftiRight.
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ślTruelubFalse.
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. NameAtrybut jest wymagany, jeśli więcej niż jeden formant na formularzu jest skojarzony z tego samego pola elementu pracy. Uwaga Możesz użyćNameatrybut do wyświetlenia tego samego pola w kilku obszarów w formularzu.Określ unikatową wartość dlaNameatrybutu dla obu wpisów kontroli tak, aby system unikatowo identyfikuje każdego formantu.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:WholeNumbersSignedWholeNumbersDecimalNumbersiSignedDecimalNumbers.
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:CustomLongShortTime.
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

W poniższej tabeli opisanoControlelementuTypeatrybuty, które zapewnia wsparcie, więc możesz zarządzać załączniki plików, tworzenie łączy, wyświetlania zawartości sieci Web i wyświetlić inne dane, które nie jest skojarzony z polem elementu pracy.

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, zobaczDodawanie 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. Możesz użyćLabelTextiLinkelementy podrzędne i kontener do określenia tekstu, hiperłącza i położenie pola lub etykiety, którego tekst znajduje się częściowo skojarzonego z hiperłączem. Aby uzyskać więcej informacji, zobaczDodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracyDokumentacja elementów LabelText i Text kodu XMLiDokumentacja elementów Link i Param kodu XML.
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. Możesz użyćLinksControlOptionsdo definiowania filtrów łącza i układ pól kolumn, które są używane do wyświetlania listy łączy. Aby uzyskać więcej informacji, zobaczZmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimiiElementy LinksControlOptions.
StoryboardsControl	Służy do otwierania Scenorysy programu PowerPoint z elementu roboczego i łącza do zapisania w sieciowym udziale plików pomocą. Ten formant jest zwykle zawarty we własnej grupie kart, jak pokazano na poniższej ilustracji. Aby dodaćStoryboardsControldoFORMsekcji, Dodaj następujący fragment kodu: <Tab Label="Storyboards">    <Control Name="StoryboardsControl" Type="LinksControl">       <LinksControlOptions>          <WorkItemLinkFilters FilterType="excludeAll" />          <ExternalLinkFilters FilterType="include">             <Filter LinkType="Storyboard" />          </ExternalLinkFilters>          <LinkColumns>             <LinkColumn RefName="System.Title" />             <LinkColumn LinkAttribute="System.Links.Comment" />          </LinkColumns>       </LinksControlOptions>    </Control> </Tab>
WebpageControl	Użyj do wyświetlania zawartości sieci Web w formie elementu roboczego. Ten formant jest zwykle zawarty w własnej grupie kart. Możesz użyćWebpageControlOptionsiLinkelementy podrzędne, aby określić, formanty, które są wymagane do załadować obiekt docelowy strony sieci Web w utwór element formularza. Aby uzyskać więcej informacji, zobaczEdytowanie definicji typu elementu roboczego w celu dodania zawartości WWW do formularza elementu pracyDokumentacja elementów XML WebpageControlOptionsiDokumentacja elementów Link i Param kodu XML.

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.

Do zaimplementowania formant niestandardowynależy określić nazwę formantu dlaTypeatrybutu.

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