Sdílet prostřednictvím


Odkaz Element XML řízení

Použití Control prvku definovat pole položky práce, text, hypertextový odkaz nebo jiné řídicí prvek zobrazíte položky formuláře do práce. Příklady použití tohoto prvku, viz Určení pracovní položky ovládací prvky. Další informace naleznete v tématu Navrhování a přizpůsobení formuláře pracovní položky.

Hierarchii schématu

WITD

   WORKITEMTYPE

       FORMULÁŘ

           Rozložení

               Skupina

               Sloupec

               Karta

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<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" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

Atributy a prvky

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

v případě vícehodnotových atributů

Atribut

Popis

FieldName

Volitelný ControlType atributu.

Určuje, ke kterému je přidružen ovládací prvek pole položky práce. Typ atributu je typelib:ReferenceFieldName. Minimální délka: 1; Maximální délka: 70.

Hodnota vzorek: ^[a-za-Z_][a-za-z0-9_]* (\. [-zA-Z0-9_] +) +$

Vzorek Příklad hodnoty: Company.Division.IssueType

Type

Požadované ControlType atributu.

Určuje typ dat ovládacího prvku. Typ atributu je ValidControlsType jednoduchého typu. Zadejte řetězec z předdefinovaných typů:

  • AttachmentControl: Slouží k zobrazení příloh pracovní položky. Tento ovládací prvek nemá přiřazené pole nebo typ pole.

  • DateTimeControl: Slouží k zobrazení polí datum formátované pomocí polí typu DateTime.

  • FieldControl: Slouží k zobrazení jednoduché textové nebo číselné pole a seznamy hodnot pole s typem pole String, Identity, Integer, Double, a PlainText.

  • HtmlFieldControl: Slouží k zobrazení více řádků, RTF Formát polí s typem pole HTML.

  • LabelControl: Slouží k zobrazení textu, který není spojený s polem. Text může být jednoduché nebo s hypertextovými odkazy.

  • LinksControl: Slouží k zobrazení odkazů pracovní položky. Tento ovládací prvek nemá přiřazené pole nebo typ pole.

  • WebpageControl: Slouží k zobrazení obsahu HTML definované URI nebo vložené značky CDATA. Tento ovládací prvek nemá přiřazené pole nebo typ pole.

  • WorkItemClassificationControlSlouží k zobrazení polí hierarchické cesty s typem pole TreePath.

    PoznámkaPoznámka
    System.AreaPath a System.IterationPath pole jsou pouze pole používající tento typ dat.Nelze definovat vlastní pole pomocí tohoto typu.
  • WorkItemLogControl: Slouží k zobrazení informace o historii pracovní položky a pole s typem pole History.

    PoznámkaPoznámka
    System.History Pole je pouze pole, která používá tento typ dat.Nelze definovat vlastní pole pomocí tohoto typu.

Další informace naleznete v tématu Určení pracovní položky ovládací prvky.

PoznámkaPoznámka
Nastavením můžete použít vlastní ovládací prvek Type atribut vlastní hodnotu.Žádné řízení, jehož Type hodnota neodpovídá názvu integrovaný typ považován vlastní ovládací prvek.Další informace naleznete na webu společnosti Microsoft: Práce vlastní ovládací prvky sledování zboží.

Label

Volitelný ControlType atributu.

Určuje text viditelný na formuláři, který identifikuje ovládací prvek. Zadejte řetězec delší než 80 znaků.

LabelPosition

Volitelný ControlType atributu.

Určuje umístění popisu vzhledem k dat ovládacího prvku. Zadejte řetězec z jednoho z následujících hodnot:

  • Top: Umístí nad daty ovládací prvek popisek.

  • Bottom: Umístění popisku pod kontrolu data.

  • Left: Umístění popisku dat ovládacího prvku doleva.

  • Right: Umístění popisku dat ovládacího prvku doprava.

Dock

Volitelný ControlType atributu.

Zarovná pole společně se zadanou strany kontejneru nebo roztáhne na pole Výplň kontejneru. Typ atributu je DockType. Zadejte řetězec z jednoho z následujících hodnot:

  • Fill: Zarovná pole tak, že vyplní kontejneru. Tato hodnota není podporována orientaci Splitter prvku.

  • Top: Zarovná pole spolu s horní kontejneru. Tato hodnota není podporována orientaci Splitter prvku.

  • Bottom: Zarovná pole spolu s dna nádoby. Tato hodnota není podporována orientaci Splitter prvku.

  • Left: Zarovná pole a levé straně kontejneru.

  • Right: Zarovná pole a pravé straně kontejneru. Tato hodnota není podporována orientaci Splitter prvku.

Padding

Volitelný ControlType atributu.

Určuje velikost mezery v obrazových bodů kolem vnitřní okraj ovládacího prvku, který odpovídá horní, dolní, levý a pravý mezery. Typ atributu je SizeType.

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

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

Margin

Volitelný ControlType atributu.

Určuje velikost mezery v obrazových bodů kolem vnějšího okraje ovládacího prvku, která odpovídá horní, dolní, levý a pravý mezery. Typ atributu je SizeType.

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

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

ReadOnly

Volitelný ControlType atributu.

Určuje, že pole je jen pro čtení. Typ atributu je ReadOnlyType. Zadejte řetězec z jednoho z následujících hodnot:

  • True: Určuje, že data ovládacího prvku jen pro čtení.

  • False: Určuje ovládací prvek dat není jen pro čtení.

MinimumSize

Volitelný ControlType atributu.

Určuje minimální velikost v obrazových bodech, které by měly zaujímat ovládacího prvku ve formuláři. Syntaxe je určena v (width,height). Typ atributu je SizeType.

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

Vzorek Příklad hodnoty: (100,100)

PoznámkaPoznámka
Pokud máte dostatek místa na svislé, posuvník se zachovat minimální velikost.Bez tohoto atributu ovládací prvky jsou vybírány se výchozí velikosti, pokud řídí ostatní záložky přijmout více místa.Celková velikost jednoho prvku závisí na velikosti největšího oblast formuláře nebo kartu.

Name

Volitelný ControlType atributu.

Jednoznačně identifikuje ovládací prvek. Name Je důležité, pokud je více než jeden ovládací prvek ve formuláři přidružen pole stejnou položku práce. Typ atributu je xs:string.

PoznámkaPoznámka
Použití Name atributu, když chcete mít stejné pole zobrazeno více umístění ve formuláři.Zadat jedinečnou hodnotu Name atributu pro obě položky řízení tak, aby systém jednoznačně identifikuje každý ovládací prvek.Je vhodné zobrazit stejné ovládání na různých místech na základě kontextu karty.

NumberFormat

Volitelný ControlType atribut, který je platný pouze pokud je použita s FieldControl.

Určuje znaky zadané do ovládacího prvku pole. Platné hodnoty, které lze použít, jsou následující:

  • WholeNumbers: Určuje, že celá čísla jsou povolena.

  • SignedWholeNumbers: Určuje, že jsou povoleny podepsané celá čísla.

  • DecimalNumbers: Určuje, že jsou povoleny desetinná čísla.

  • SignedDecimalNumbers: Určuje, že jsou povoleny podepsané desetinná čísla.

MaxLength

Volitelný ControlType atribut, který je platný pouze pokud je použita s FieldControl.

Určuje maximální délku povolené znaky pro ovládací prvek. Typ atributu je xs:integer.

Format

Volitelný ControlType atribut, který je platný pouze pokud je použita s DateTimeControl.

Určuje formát pole data a času odpovídající hodnoty výčtu DateTimePickerFormat. Platné hodnoty, které lze použít, jsou následující:

  • Custom: Zobrazí hodnoty data a času ve vlastním formátu. Vlastní formát můžete nastavit zadáním "Vlastní" jako hodnotu pro formát atributu a nastavení jiného atributu s názvem CustomFormat s vlastní řetězec formátu. Příklad:

    Formát = "Vlastní"

    CustomFormat = "Dd. MMM"roku" rrrr"

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

  • Long: Zobrazí hodnotu, datum a čas v poli Formát dlouhého data nastavení operačního systému uživatele.

  • Short: Zobrazí datum nebo čas ve formátu krátkého nastavit uživatele operačního systému.

  • Time: Zobrazí datum nebo čas ve formátu času nastavení operačního systému uživatele.

Další informace naleznete na webu společnosti Microsoft: Výčet DateTimePickerFormat.

CustomFormat

Volitelný ControlType atribut, který je platný pouze pokud je použita s DateTimeControl a Format atributu.

Určuje formát vlastní pole data a času odpovídající syntaxe definovaná vlastnost DateTimePicker.CustomFormat. Další informace naleznete na webu společnosti Microsoft: Vlastnost DateTimePicker.CustomFormat.

Podřízené prvky

Prvek

Popis

LabelText

Volitelný prvek. Můžete zadat tento prvek při ControlType je určena jako FieldControl nebo LabelControl.

Prvek kontejneru pro zadání textu, hypertextový odkaz a umístění pole nebo popisek, jehož text je částečně spojena s hypertextovým odkazem.

Další informace naleznete v tématu LabelText a Text odkazu prvky XML a Poskytování Text nápovědy, proces pokyny webový obsah a odkazy na webové stránky ve formuláři položky práce.

Odkaz

Volitelný prvek. Můžete zadat tento prvek při ControlType je určena jako FieldControl nebo LabelControl.

Určuje hypertextový odkaz pro pole nebo popisek.

Další informace naleznete v tématu Propojení a referenční elementy Param XML a Poskytování Text nápovědy, proces pokyny webový obsah a odkazy na webové stránky ve formuláři položky práce.

LinksControlOptions

Volitelný prvek. Můžete zadat tento prvek při ControlType je LinksControl.

Definuje odkaz filtry a rozložení sloupců polí zobrazíte seznam odkazů.

Další informace naleznete v tématu Definování propojení prvků omezit propojení vztahů.

WebpageControlOptions

Volitelný prvek. Můžete zadat tento prvek při ControlType je WebpageControl.

Určuje ovládací prvky, které řídí načítání cílové webové stránky ve formuláři práce.

Další informace naleznete v tématu Referenční elementy WebpageControlOptions XML a Poskytování Text nápovědy, proces pokyny webový obsah a odkazy na webové stránky ve formuláři položky práce.

anyAttribute

Volitelný prvek.

Nepovinné. ControlTypeje rozšiřitelné pomocí anyAttribute prvku. Hodnota vlastnosti ProcessContents: přeskočte.

Nadřazené prvky

Prvek

Popis

Rozložení

Povinné. Určuje způsob zobrazení prvků ve formuláři položky práce.

Sloupec Element

Povinné. Určuje sloupce pro formulář.

Karta Element

Povinné. Definuje kartu pro formulář.

Poznámky

Controlje volitelné podřízený prvek Layout, Column, a Tab.

Layouta Column ukazatelů:

parametr minOccurs = "0"

maxOccurs = "1"

Tabindikátory:

parametr minOccurs = "0"

maxOccurs = "neomezeně"

Chcete-li implementovat vlastní ovládací prvek je třeba zadat název ovládacího prvku Type atributu. Další informace naleznete na webu společnosti Microsoft: Práce vlastní ovládací prvky sledování zboží.

Příklad každý typ ovládacího prvku, viz Určení pracovní položky ovládací prvky.

Příklad

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

Informace prvku

Obor názvů

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef

Název schématu

Zadejte definici pracovní položky

Ověřovací soubor

WorkItemTypeDefinition.xsd

Typ prvku

ControlType komplexní typ

Může být prázdný.

Nelze použít

Viz také

Koncepty

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

Všechny odkazy na prvky XML formuláře

Určení pracovní položky ovládací prvky

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Byly přidány podřízené prvky syntaxi, odstraněny nebo nahrazeny odkazy na témata, které byly odebrány.

Rozšíření informace