Sdílet prostřednictvím

Všechny odkazy na prvky XML formuláře

  • Článek

Informace v tomto tématu můžete použít jako rychlý odkaz na všechny prvky a atributy hlavní formulář pro typ pracovní položky řízení. Určit tyto prvky FORM prvek kontejner, třetí a poslední hlavní části definice typu pracovní položky. Mnoho prvků jsou vnořeny do jiné skupiny, oddíly nebo karty ve formulářích položky práce. Další informace o seskupení těchto prvků naleznete Navrhování rozložení formulář pracovní položky.

V tomto tématu

  • FORM příklad

  • Syntaxe pro prvky formuláře

  • Atributy, které určují prvky formuláře

  • Určit samostatné popisky, hypertextové odkazy, webové stránky nebo obsahu HTML prvky

  • Prvky, které filtrovat a zobrazit vztahy propojení

FORM příklad

Následující příklad ukazuje celkovou strukturu FORM prvku. Určit rozložení formuláře pomocí Layout prvku. Můžete zadat různá rozložení, které jsou různé klienty. Například můžete zadat jedno rozložení pro klienty Windows a různé rozložení Team Web Access. Rozložení se obvykle skládá z horní části formuláře a potom skupinu záložek. Pořadí, ve kterém definovat prvky rozložení určuje pořadí, ve kterém se zobrazí prvky ve formuláři.

Seskupení prvků pomocí zobrazit ve sloupcích Group a Column prvky. Slouží Control prvku definovat každé pole, které chcete zobrazit na formuláři. Použití Tab prvku podpory různých funkčních oblastech pole skupiny.

<FORM>
      <Layout>
        <Group>
          <Column PercentWidth="70">
            <Group>
              <Column PercentWidth="100">
                <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
                <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />
                <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="&amp;Iteration Path:" LabelPosition="Left" />
                <Group>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="PU (Use Area Path)" LabelPosition="Left" />
                  </Column>
                  <Column PercentWidth="50">
                    <Control FieldName="Microsoft.VSTS.Common.Priority" Type="FieldControl" Label="Priority" LabelPosition="Left" />
                  </Column>
                </Group>
              </Column>
            </Group>
          </Column>
          <Column PercentWidth="30">
            <Group Label="Status">
              <Column PercentWidth="100">
                <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
                <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
                <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
              </Column>
            </Group>
          </Column>
        </Group>

. . .
</Layout>
</FORM>

Prvky formuláře

Můžete určit způsob seskupení položek pole práce a informace a zobrazit ve formuláři položky práce pomocí prvků, které jsou popsány v následující tabulce.

Poznámka

Nejlepších výsledků by vnořit Control prvky Group, a měli vnořit Group prvky Column, i když sloupec pokrývá celou šířku formuláře. Měla také vnořit každé Column sekce v Group, i když skupina nemá žádný viditelný štítek nebo hranice.

Prvek

Popis

Požadovaný:

Column

Rozdělí oblastí formuláře do sloupců.

<Column PercentWidth="WidthPerceOfContainingElement" FixedWidth="WidthInPixels">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</Column >

Doporučeno

Control

Definuje pole, text, hypertextový odkaz nebo jiný prvek ovládací prvek na formuláři práce.

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(Width,Height)" 
Name="InstanceName" />

Další informace naleznete v tématu Odkaz Element XML řízení.

Požadováno

FORM

Definuje prvek formuláře nejvyšší úrovně.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Požadováno

Group

Poskytuje vizuální seskupení prvků podobné skupině systému Windows.

<Group Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Column> . . . </Column>
</Group >

Doporučeno

Layout

Definuje rozložení formulář pracovní položky.

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ControlSpacing="Distance" LabelSpacing="Distance">
   <Group> . . . </Group>
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</LAYOUT>

Požadováno

Splitter

Formulář se rozdělí na dvě oblasti podpory rozložení dva sourozenecké elementy formuláře.

Splitter Dock="Left" />

Volitelné

Tab

Definuje skupina na kartě rozložení jednu kartu.

<TAB Label="LabelText" Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Group> . . . </Group
   <Control> . . . </Control>
   <TabGroup> . . . </TabGroup>
   <Splitter> . . . </Splitter>
</TAB>

Volitelné

TabGroup

Definuje jedna nebo více karet pro formulář.

<TabGroup Padding="(left, top, right, bottom)" Margin="(left, top, right, bottom)">
   <Tab> . . . </Tab>
</TabGroup>

Volitelné

Zpět na začátek

Atributy, které slouží k formátování prvků formuláře

Mezery a velikost mnoho prvků ve formuláři položky práce můžete řídit určením atributy, které jsou popsány v následující tabulce. Další informace naleznete v tématu Navrhování rozložení formulář pracovní položky.

Atribut

Popis

Použitelné prvky

ControlSpacing

Nepovinné. Určuje svislé odsazení prvků. Celé číslo

Layout

Dock

Nepovinné. Roztáhne rozdělovač vyplní zbývající kontejneru nebo ovládací prvek. Dokovací hodnoty platné pole jsou následující: Výplň, nahoru, dolů, vlevo, a vpravo.

  • Fill: Zarovná pole tak, že vyplní kontejneru.

  • Top: Zarovná pole nahoře kontejneru.

  • Bottom: Zarovná pole s dna nádoby.

  • Left: Zarovná levé kontejneru s rozdělováním nebo pole. Tato hodnota je jedinou podporovanou orientaci SPLITTER prvku.

  • Right: Zarovná pravé straně kontejneru s rozdělováním nebo pole.

Control

Splitter

FixedWidth

Nepovinné. Šířka sloupce v pixelech. PercentWidtha FixedWidth jsou vzájemně exkluzivní.

Column

Label

Nepovinné. Textu pro ovládací prvek nebo skupinu. Popisek je určen, potlačí všechny spojené s pole metadat pro ovládací prvek popisek.

Pro TAB prvku. Zobrazit na kartě text.

LabelText je textový řetězec obsahující 1 až 80 znaků.

Control

Group

Tab

LabelPosition

Nepovinné. Umístění popisků vzhledem k datové pole. Možné hodnoty jsou nahoře, dole, vlevo a vpravo.

Control

LabelSpacing

Nepovinné. Určuje počet pixelů mezi popiskem a úpravy oblasti ovládacího prvku.

Layout

Margin

Nepovinné. Řetězec formulář (doleva, nahoru, doprava, dolů), který určuje velikost mezery kolem ovládacího a mezi ovládacího prvku a jeho okolí v pixelech. Můžete měnit velikost místa na každé straně.

Hodnota vzorek: ^\(\d+\,\d+\,\d+\,\d+\)$

Vzorek Příklad hodnoty: (2,0,2,0)

Control

Group

Layout

Tab

TabGroup

MinimumSize

Nepovinné. Řetězec formuláře (šířky, Výška). Tato hodnota určuje minimální velikost pro samotný formulář. Když kontejner řídit menší velikosti, vodorovné a svislé posuvníky.

Control

Layout

Name

Nepovinné. Název ovládacího prvku. Pokud tento parametr nezadáte, název je shodný FieldName.

Control

Padding

Nepovinné. Řetězec formulář (doleva, nahoru, doprava, dolů), který určuje v pixelech, velikost místnosti kolem vnějšího okraje ovládacího prvku a vnitřního okraje. Můžete měnit velikost místa na každé straně.

Control

Group

Layout

Tab

TabGroup

PercentWidth

Nepovinné. Šířka sloupce v procentech šířky obsahující prvek. PercentWidtha FixedWidth jsou vzájemně exkluzivní.

Column

ReadOnly

Nepovinné. Pole určené jen pro čtení lze zobrazit v ovládacím prvku. Ovládací prvky odpovědět na tento atribut několika různými způsoby.

Control

Target

Nepovinné. Řetězec určující klientovi, který se vztahuje toto rozložení. Visual Studiov tomto rozvržení zobrazí položka tohoto typu práce, pokud Target atribut vynechán nebo nastaven na model Windows Forms. Externí klienti mohou určit další rozložení pomocí vlastní Target atributů Visual Studio ignoruje.

Platné jsou následující hodnoty:

  • WinForms: Formulář se použije Průzkumník týmu a Team Explorer Everywhere.

  • Web: Formulář se použije Team Web Access.

Layout

Type

Povinné. Typ ovládacího prvku. Další informace naleznete v tématu Odkaz Element XML řízení.

Control

Zpět na začátek

Určit samostatné popisky, hypertextové odkazy, webové stránky nebo obsahu HTML prvky

WebpageControlOptions Prvku a jeho podřízené prvky mají následující strukturu syntaxe:

<WebpageControlOptions AllowScript="true | false" ReloadOnParamChange="true | false" >
   <Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
      <Param index="IndexValue" value="ParamValue" type ="Original | Current"/>
   </Link>
   <Content>
      <![CDATA[Contents of HTML]]>
   </Content>
</WebpageControlOptions>

Použijte prvky, které jsou popsány v následující tabulce definovat jako prostý text nebo štítky s hypertextovými odkazy, do pole přidat hypertextové odkazy nebo zobrazit obsah webové stránky ve formuláři položky práce. Další informace naleznete v tématu Poskytování Text nápovědy, proces pokyny webový obsah a odkazy na webové stránky ve formuláři položky práce.

Prvek

Požadovaný:

Popis

Content

Volitelný WebpageControlOptions prvku.

Určuje obsah CDATA HTML založené ve formuláři položky práce.

<Content>
   <![CDATA[Contents of HTML]]>
</Content>

Další informace naleznete v tématu Referenční elementy WebpageControlOptions XML.

LabelText

Volitelný Control prvek při type="LabelControl".

Definuje buď popisek obyčejný nebo s hypertextovými odkazy.

Další informace naleznete v tématu LabelText a Text odkazu prvky XML.

Link

Volitelný Control prvek při type="FieldControl".

Volitelný Text prvku.

Volitelný WebpageControl prvku.

Volitelný WebpageControlOptions prvku.

Určuje hypertextový odkaz na pole, popisku nebo webového obsahu prohlížeči zobrazit formulář pracovní položky.

<Link URLRoot="URLRoot" URLPath ="URLPathWithParameters">
   <Param />
</Link>

Další informace naleznete v tématu Propojení a referenční elementy Param XML.

Param

Volitelný Link prvku.

Určuje hodnotu určit URL hypertextového odkazu při URLPath je určena pro Link prvku.

<Param index="IndexValue " value="ParamValue " type ="Original | Current"/>

Další informace naleznete v tématu Propojení a referenční elementy Param XML.

Text

Volitelný LabelText prvku.

Prvek kontejneru informace nebo popisku na formuláři práce.

<Text>
   <Link >
      <Param />
   </Link>
   LabelText
</Text>

Další informace naleznete v tématu LabelText a Text odkazu prvky XML.

WebpageControlOptions

Volitelný Control prvek při type="WebpageControl"

Prvek kontejner, který určuje možnosti pro ovládací prvek webové stránky.

Další informace naleznete v tématu Referenční elementy WebpageControlOptions XML.

Zpět na začátek

Prvky, které filtrovat a zobrazit vztahy propojení

Použití LinksControlOptions prvku definovat možnosti pro kontrolu odkazů, které lze přidat do pracovní položky a výchozí sloupce, které chcete zobrazit seznam odkazů v pracovní položky. Když přidáte odkaz formulář pracovní položky, můžete určit filtry, které omezují typy odkazů, zda uživatelé mohou vytvářet a typy pracovních položek mezi uživatelů lze vytvořit propojení. LinksControlOptions Prvku a jeho podřízené prvky mají následující strukturu:

<LinksControlOptions>
   <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
       <Filter LinkType="linkTypeRefName" FilterOn="reverseName | forwardName" />
   </WorkItemLinkFilters>
   <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll">
       <Filter LinkType="externalLinkName"/>
   </ExternalLinkFilters>
   <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" />
       <Filter WorkItemType="workItemTypeReferenceName"/>
   </WorkItemTypeFilters>
   <LinkColumns>
      <LinkColumn RefName="referenceName" | LinkAttribute="linkAttributeName"/>
   </LinkColumns>
</LinksControlOptions>

Konkrétně pomocí prvků, které jsou shrnuty v následující tabulce. Další informace o použití těchto prvků naleznete Definování propojení prvků omezit propojení vztahů a LinksControlOptions prvky.

Prvek

Požadovaný:

Popis

LinksControlOptions

Volitelný Control prvek při type="LinksControl"

Obsahuje výchozí sloupce, které chcete zobrazit seznam odkazů v pracovní položky a pracovní položky lze přidat kontejner pro prvky, které definují možnosti určující, jaké odkazy.

WorkItemLinkFilters

Volitelný LinksControlOptions element

Kontejner obsahuje jeden nebo více Filter prvky, které zadat kritéria filtru odkaz pro typy vazeb, které jsou definovány pro kolekci týmu projektu.

ExternalLinkFilters

Volitelný LinksControlOptions element

Kontejner obsahuje jeden nebo více Filter prvky, které zadat kritéria filtru pro typy vazeb, které jsou definovány v jiných projektech týmu.

WorkItemTypeFilters

Volitelný LinksControlOptions element

Kontejner obsahuje jeden nebo více Filter prvky, které zadat kritéria filtru pro práci typy položek.

Filter(typy odkazů)

Požadované WorkItemLinkFilters prvek při FilterType je atribut exclude nebo include.

Požadované ExternalLinkFilters prvek při FilterType je atribut exclude nebo include.

Určuje typy odkazů zahrnout nebo vyloučit ze sady odkazy vytvořené pro položku.

Filter(položky typy práce)

Volitelný WorkItemTypeFilters prvek při FilterType je atribut exclude nebo include.

Určuje typy pracovních položek, které chcete zahrnout nebo vyloučit ze sady typů položek práce mezi kterými můžete propojit uživatele.

LinkColumns

Volitelný LinksControlOptions element

Kontejner obsahuje jeden nebo více LinkColumn značky.

LinkColumn

Požadované LinkColumns element

Určuje atributy typu odkaz na formulář pracovní položky seznamu odkazy a položky pole práce.

Zpět na začátek

Viz také

Koncepty

Navrhování rozložení formulář pracovní položky

Navrhování a přizpůsobení formuláře pracovní položky

Další zdroje

Index prvku XML definice typů pracovních položek

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Přidán příklad a syntaxi pro všechny FORM prvky. Odebrat odkazy na témata, které byly odebrány.

Rozšíření informace

Červenec 2010

Přidány odkazy na témata, které byly přidány v předchozí aktualizaci.

Rozšíření informace