Control the display of work item fields

Článek
09/11/2015

Ve formuláři pracovní položky můžete řídit název popisku, umístění, velikost textového pole a jiných ovládacích prvků zobrazované ve formátu prostého textu, celé číslo, číslo, datum a pole stromu cesta pracovních položek. Chcete-li zobrazit tato pole, je třeba zadat správnouControlelementTypeatribut z následujících možností:

DateTimeControl: Slouží k zobrazení formátovaná kalendářních dat, která mají typ poleDateTime.
FieldControl: Slouží k zobrazení prostý textové nebo číselné pole a seznamy hodnot pro pole, které mají typ poleStringIdentityIntegerDoubleaPlainText.
HtmlFieldControl: Slouží k zobrazení víceřádkové, text ve formátu RTF Formát pole, které mají datový typ poleHTML.
WorkItemClassificationControlSlouží k zobrazení hierarchické cesty pole, která mají pole typuTreePath.

Další informace o dalšíchTypeovládací prvky, naleznete v následujících tématech:

V tomto tématu

Řídí velikost a zobrazení datových polí
Popisek pole a přidat pole na dvou místech ve formuláři
Proveďte pole jen pro čtení
Přidat prostý text nebo číslo pole
Přidat pole formátovaný text
Přidat pole datum nebo kalendáře
Přidat pole pro oblasti a iterace cesty

Řídí velikost a zobrazení datových polí

Mezery a velikost každé datové pole, můžete ovládat pomocí volitelných atributů, které jsou popsány v následující tabulce.

Poznámka

Celková velikost každé datové pole, položka je dáno několika různými faktory: atributy, které jsou přiřazeny k poli, velikost kontejneru a oblasti, který je přiřazen k jiné pole ve formuláři.Výchozí hodnoty jsou přiřazeny k polím, pokud nezadáte minimální velikost.Atributy, které jsou přiřazeny k jiné pole ve formuláři však může ovlivnit velikost polí.Počet sloupců a vodorovné velikost přidělte největší pole v každém sloupci určit vodorovné dimenze formuláře.Počet polí, která zadáte v svislá skupina a výška přidělte každé pole určit velikost horní části formuláře a také velikost dolní části formuláře.

Atribut	Popis	Příklad hodnoty vzor
MinimumSize	Určuje minimální velikost (Šířkavýšku)pro ovládací prvek. Pokud je menší než velikost tohoto kontejneru pro ovládací prvek, se zobrazí posuvníky vodorovně a svisle.	(100,100)
Margin	Určuje v pixelech velikost místa kolem ovládacího prvku a mezi ovládacího prvku a jeho okolí (nejvyšší, dolů, doleva, doprava).	(2,0,2,0)
Padding	Určuje velikost místa kolem vnějšího okraje ovládacího prvku (nejvyšší, dolů, doleva, doprava) v pixelech.	(2,0,2,0)

Popisek pole a přidat pole na dvou místech ve formuláři

Pro každý ovládací prvek formuláře můžete zadat volitelný popis a pozici popisku pomocíLabelaLabelPositionatributy. Popisek můžete zadat jiný název než popisný název, který bude přiřazen podleFIELDelementu. Pokud nezadáte popisek, je použit popisný název. Všimněte si však, že popisný název je použit při člen týmu spustí dotaz pro hledání pro pracovní položky. Popisek maximální velikost je 80 znaků.

Poznámka

Pro všechny ovládací prvky, které jsou definovány do stejné skupiny, je nutné definovat stejné relativní pozici popisku.

Pokud chcete přidat pole ve více než jednu oblast formuláře, například horní části formuláře a na kartě, lze provést pomocíNameatributu. NameAtribut pouze identifikuje rozdíl od jiných ovládací prvek, který je přidán do formuláře ovládacího prvku.

Vytvořit pole jen pro čtení

Můžete označit pole jen pro čtení jedním ze dvou způsobů. V první metoda, přidejteREADONLYjako podřízený elementFIELDelement vFIELDSčást definice typu. S použitímREADONLYelementu, můžete určit zda někteří uživatelé mohou změnit pole. Jak je znázorněno v následujícím příkladu, pouze správci programu můžete upravit podnadpis pole.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

V druhé metodě, můžete zadatReadOnlyatributuCONTROLelementu. V této metodě všichni uživatelé mají zakázáno úprav pole.

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

Přidat textové pole a čísla

Můžete použítFieldControltyp má být přidán do formuláře jako prostý text nebo číslo pole. Tento atribut se také používá k přidání seznamů pro výběr; pole, které se používají k zobrazení jméno osoby, jako je například polích přiřazeno nebo vlastníka. a celé číslo a reálná čísla. Ovládací prvek pole musí odkazovat na pole jeho název odkazu. Popisek může být ve formátu prostého textu nebo navržen jako hypertextový odkaz. Další informace naleznete v tématuProvide help text, hyperlinks, or web content on a work item form.

Text, celé číslo a vybere seznam polí

Group of several fields

Můžete řídit formát čísla polí a maximální délku znaků, které mohou být zadány v textovém editoru nebo pole s číslem s použitím volitelných atributů, které jsou popsány v následující tabulce.

Atribut	Popis
NumberFormat	Určuje znaky, které lze zadat do ovládacího prvku pole. Platné hodnoty jsou následující:WholeNumbersSignedWholeNumbersDecimalNumbersaSignedDecimalNumbers.
MaxLength	Určuje maximální délku znaků, které lze použít pro ovládací prvek pole.

Následující kód uvádí syntaxi, která se používá k vytvoření skupiny polí, která se zobrazí v předchozím příkladu.

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

Přidat pole formátovaný text

Můžete použítHTMLFieldControltyp, který má-li přidat pole, jehož typ dat jeHTML. Tento ovládací prvek poskytuje podporu pro zobrazit formátovaný text na více řádků.

Pole HTML

HTML field shown on work item form

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" MinimumSize="(100,500)" />

Tip

Přidáte-li několikHTMLFieldControlelementy ve formuláři, který bude skládaný ve svislém směru, je třeba zadatMinimumSizeatribut pro každý ovládací prvek pole.Tímto způsobem můžete provést podobné velikost všech textových polí.V opačném případě velikost ovládacího prvku poslední HTML je nastavena pro vyplňování formulářů a předchozí prvky, zobrazí spolu s menší textových polí.

Přidat pole datum nebo kalendáře

PoužijeteDateTimeControlTyp-li uživatelům povolit ovládací prvek Kalendář, vyberte datum pro výběrDateTimepole. Pomocí tohoto ovládacího prvku můžete rychle vyberte datum a čas pro pole.

Pole s formátem kalendáře = "Krátká"

Calendar field

Můžete například zadejte upřednostňované počáteční datum nebo kontrolní datum, které je v budoucnu.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Format="Time" />

Můžete řídit formátDateTimepole s použitím volitelných atributů, které jsou popsány v následující tabulce.

Atribut	Popis
Format	Určuje formát pro pole s datem a časem, které odpovídá jedné hodnotě ve výčtu DateTimePickerFormat. Platné hodnoty jsou následující:CustomLongShortTime. Pokud zadáteCustomje také nutné nastavitCustomFormatatributu.
CustomFormat	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říklad: Formát = "Vlastní" CustomFormat = "Dd. mm yyyy 'roku'" Další informace naleznete na webu společnosti Microsoft: DateTimePicker.CustomFormat vlastnost.

Format

Určuje formát pro pole s datem a časem, které odpovídá jedné hodnotě ve výčtu DateTimePickerFormat. Platné hodnoty jsou následující:CustomLongShortTime.

Pokud zadáteCustomje také nutné nastavitCustomFormatatributu.

CustomFormat

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říklad:

Formát = "Vlastní"

CustomFormat = "Dd. mm yyyy 'roku'"

Další informace naleznete na webu společnosti Microsoft: DateTimePicker.CustomFormat vlastnost.

Přidejte pole pro oblasti a iterace cesty

Můžete použítWorkItemClassificationControltyp, který má-li přidat pole, jehož typ dat jeTreePath. Tento ovládací prvek poskytuje podporu pro zobrazena cesta pole v oblasti a iterace cesta pole ve formátu stromové struktury hierarchické, vnořených. Strom zobrazuje hierarchickou uzly, že můžete rozbalit nebo sbalit.

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

Poznámka

Můžete použítWorkItemClassificationControlChcete-li zobrazitSystem.AreaPathaSystem.IterationPathpolí.Jakýkoli jiný typ pole nebo vlastní pole nelze zobrazit pomocí tohoto ovládacího prvku.

Další informace naleznete v tématuAdd and modify area and iteration paths.