Určení ovládacích prvků ve formuláři pracovní položky

Toto téma obsahuje rychlý odkaz Control element, jeho podřízených elementů a atributů.Pro každé pole nebo ovládací prvek formuláře, který chcete zobrazit ve formuláři pracovní položky, přidejte prvek Control.

Formulář pracovní položky můžete přizpůsobit tak, aby zobrazoval informace, které pomohou vašemu týmu správně používat formulář.Můžete přidat pole pracovních položek a ovládací prvky, které umožňují zadat a zobrazit data, jež chcete sledovat.

Prvek Control poskytuje devět hodnot pro atribut Type, který můžete použít pro přidání polí nebo zobrazení prostého textu, textu s hypertextovými odkazy nebo polí.Kromě toho můžete definovat zvláštní ovládací prvky pro přidání odkazů a příloh, zobrazení webového obsahu nebo tvorbu vlastního ovládacího prvku a jeho přidání do formuláře pracovní položky.

Přidání polí pracovních položek

Při vlastním nastavení formuláře pracovní položky obvykle přidáte dílčí sadu polí pracovní položky, jež jsou definována pro typ pracovní položky, který chcete zobrazit ve formuláři.Definice polí řídí mnoho aspektů týkajících se toho, jaká data se zobrazí nebo jaká data můžete zadat do formuláře.Další informace naleznete v tématu Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů.

Každému poli pracovní položky je přiřazen typ dat.Informace v následující tabulce můžete použít k určení, který typ pole je podporován kterým atributem Type prvku Control.Použijte atribut Label k určení textu, který se zobrazí u ovládacího prvku.Použijte související atribut LabelPosition k určení, kde se popisek zobrazí vzhledem k ovládacímu prvku.Další informace naleznete v tématu Řízení zobrazení polí pracovních položek.

[!POZNÁMKA]

Nelze změnit hodnoty systémových polí, která jsou aktualizována automaticky.Například pole Datum vytvoření a Vytvořil jsou definována při prvním uložení pracovní položky.Tato pole však můžete použít v kritériích hledání.Popis každého systémového pole naleznete v tématu Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

Typ pole	Atribut typu ovládacího prvku	Použití
DateTime	FieldControl DateTimeControl	Pomocí atributu FieldControl můžete poskytnout textové pole pro zadání nebo zobrazení datového pole typu Datum a čas. <Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" /> Pomocí atributu DateTimeControl můžete poskytnout ovládací prvek výběru kalendáře pro volbu data pole, jak je znázorněno na následujícím obrázku. <Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
Double	FieldControl	Pomocí atributu FieldControl můžete poskytnout textové pole pro zadání nebo zobrazení dvojitých polí. <Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />
History	WorkItemLogControl	Pomocí atributu WorkItemLogControl můžete poskytnout pole ovládacího prvku pro pole Historie, která sledují diskusní vlákna a další historické informace, jak je znázorněno na následujícím obrázku. Tento ovládací prvek slouží pouze pro podporu zobrazení pole historie pracovní položky, pole pracovní položky System.History.Pomocí tohoto ovládacího prvku můžete rozbalit nebo sbalit podrobnosti o historii revizí pro pracovní položku.Také lze naformátovat text, který jste přidali do pole historie. <Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />
HTML	HTMLControl	Pomocí atributu HTMLControl můžete poskytnout pole ovládacího prvku, které povolí polím HTML zachycení formátování textu RTF, jak je znázorněno na následujícím obrázku. <Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />
Integer	FieldControl	Pomocí atributu FieldControl můžete poskytnout pole ovládacího prvku pro pole Integer. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	Pomocí atributu FieldControl můžete poskytnout pole ovládacího prvku pro pole Prostý text, jako je textové pole, které obsahuje popisy, jež mohou být delší než 255 znaků. <Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />
String	FieldControl	Pomocí atributu FieldControl můžete poskytnout pole ovládacího prvku pro pole Řetězec.Pole s řetězci jsou omezena na 255 znaků. <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
TreePath	WorkItemClassificationControl	Pomocí atributu WorkItemClassificationControl můžete poskytnout pole ovládacího prvku pro pole TreePath. <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Volitelné atributy polí ovládacích prvků pro všechny typy ovládacích prvků

Následující volitelné atributy lze určit pouze pro typy ovládacích prvků, které jsou uvedeny.

Atribut	Popis
Field	Určuje ovládací prvek, který je spojen s polem pracovní položky.
Label	Určuje viditelný text ve formuláři, který identifikuje ovládací prvek.Určuje řetězec s maximálně 80 znaky. [!POZNÁMKA] Pomocí atributu FieldControl můžete připojit hypertextový odkaz na popisek pole, který je přidán do formuláře položky práce.Tento ovládací prvek je užitečný k poskytnutí odkazu na informace o způsobu použití pole.Další informace naleznete v tématu Poskytnutí textu nápovědy, hypertextových odkazů nebo webového obsahu ve formuláři pracovní položky.
LabelPosition	Určuje umístění popisku souvisejícího s daty ovládacího prvku.Zadejte řetězec z jedné z následujících hodnot: Top, Bottom, Left a Right.
Dock	Určuje zarovnání popisku se zadanou stranou kontejneru, nebo roztáhne pole tak, aby vyplnilo kontejner.Zadejte řetězec z jedné z následujících hodnot: Fill, Top, Bottom, Left a Right.
Padding	Určuje velikost prostoru v pixelech kolem vnitřního ohraničení ovládacího prvku.K dispozici jsou čtyři hodnoty, které odpovídají horní, dolní, levé a pravé straně.Například: (2,0,2,0).
Margin	Určuje velikost prostoru v pixelech kolem vnějšího ohraničení ovládacího prvku.K dispozici jsou čtyři hodnoty, které odpovídají horní, dolní, levé a pravé straně.Například: (2,0,2,0).
ReadOnly	Určuje, že je pole jen pro čtení.Určete parametr True nebo False.
MinimumSize	Určuje minimální velikost v pixelech pro ovládací prvek ve formuláři.Jsou k dispozici dvě hodnoty, které odpovídají šířce a výšce.Například: (100,100).
Name	Jednoznačně identifikuje ovládací prvek.Atribut Name je požadován, pokud je se stejným polem pracovní položky spojen více než jeden ovládací prvek ve formuláři. [!POZNÁMKA] Atribut Name použijte k zobrazení stejného pole ve více než jedné oblasti ve formuláři.Zadejte jedinečnou hodnotu atributu Name pro obě položky ovládacího prvku tak, aby systém jednoznačně identifikoval každý ovládací prvek.Je vhodné zobrazit stejný ovládací prvek v různých umístěních v závislosti na kontextu karet.

Volitelné atributy polí ovládacích prvků pro konkrétní typy ovládacích prvků

Následující volitelné atributy lze určit pouze pro typy ovládacích prvků, které jsou uvedeny.

Atribut	Typy ovládacích prvků	Popis
NumberFormat	FieldControl	Určuje znaky, které lze zadat do ovládacího prvku pole.Platné jsou následující hodnoty: WholeNumbers, SignedWholeNumbers, DecimalNumbers a SignedDecimalNumbers.
MaxLength	FieldControl	Určuje maximální délku znaků, které lze použít pro ovládací prvek pole.
Format	DateTimeControl	Určuje formát pro pole s datem a časem, které odpovídá jedné hodnotě ve výčtu DateTimePickerFormat.Platné jsou následující hodnoty: Custom, Long, Short, Time.
CustomFormat	DateTimeControl	Určuje vlastní formát, jenž se používá pro pole s datem a časem, které odpovídá syntaxi definované pro vlastnost DateTimePicker.CustomFormat.

Přidání speciálních ovládacích prvků

V následující tabulce jsou uvedeny atributy Type prvku Control, které poskytují podporu pro správu příloh souborů, vytváření odkazů, zobrazení webového obsahu a zobrazení jiných dat, která nejsou spojena s polem pracovní položky.

Atribut typu ovládacího prvku	Použití
AttachmentsControl	Slouží k připojení souborů k formuláři pracovní položky.Tento ovládací prvek je obvykle součástí vlastní skupiny karet, jak je znázorněno na následujícím obrázku. Ovládací prvek příloh Další informace naleznete v tématu Přidání ovládacího prvku příloh.
LabelControl	Slouží k zobrazení prostého textu nebo textu s hypertextovým odkazem, který není spojený s polem, jak je znázorněno na následujícím obrázku. Podřízený prvek a prvek kontejneru LabelText a Link se používají k zadání textu, hypertextového odkazu a umístění pole nebo popisku, jejichž text je částečně spojený s hypertextovým odkazem.Další informace naleznete v tématu Poskytnutí textu nápovědy, hypertextových odkazů nebo webového obsahu ve formuláři pracovní položky, Referenční dokumentace XML elementů LabelText a Text a Referenční dokumentace XML elementů odkazů a parametrů.
LinksControl	Slouží k vytvoření a správě vztahů mezi pracovními položkami.Tento ovládací prvek je obvykle součástí vlastní skupiny karet, jak je znázorněno na následujícím obrázku. Atribut LinksControlOptions se používá k definování filtrů odkazů a rozložení sloupcových polí, která slouží k zobrazení seznamu odkazů.Další informace naleznete v tématu Definice řízení propojení s cílem omezit vztahy určené propojeními a LinksControlOptions – elementy.
WebpageControl	Slouží k zobrazení webového obsahu ve formuláři pracovní položky.Tento ovládací prvek je obvykle součástí vlastní skupiny karet.Podřízené prvky WebpageControlOptions a Link slouží k určení ovládacích prvků, které jsou nutné k načtení cíle webové stránky ve formuláři pracovní položky. Další informace naleznete v tématu Přidání webového obsahu do formuláře pracovní položky úpravou definice typu pracovní položky (WIT), Referenční dokumentace XML elementů WebpageControlOptions a Referenční dokumentace XML elementů odkazů a parametrů.

Přidání vlastních ovládacích prvků

Kromě předdefinovaných ovládacích prvků můžete přidat vlastní ovládací prvek do formuláře pracovní položky.

Například můžete přidat vlastní ovládací prvek k pořízení snímku obrazovky ze schránky.Nebo můžete vložit ovládací prvek pro zachycení více hodnot přidáním zaškrtávacího políčka u hodnot, které jsou uvedeny v seznamu nebo v nabídce.

Pro implementaci vlastního ovládacího prvku je nutné zadat název ovládacího prvku pro atribut Type.

Viz také

Úkoly

Změna rozložení formuláře pracovní položky

Přidání webového obsahu do formuláře pracovní položky úpravou definice typu pracovní položky (WIT)

Referenční dokumentace

Control – referenční dokumentace elementu XML