Odkaz Element jazyk XML řízení

Článek
03/04/2013

Použití Control prvku definovat položky pole práce, text, hypertextový odkaz nebo jiných ovládací prvek zobrazení ve formuláři položky práce.Příklady použití tohoto prvku, viz Určení ovládacích prvků ve formuláři pracovní položky.Další informace naleznete v tématu Návrh a přizpůsobení formuláře pracovní položky.

Hierarchii schématu

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

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" ControlFontSize="FontSize" EmptyText="TextString"
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 elementy

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

Atributy

Atribut	Description
FieldName	Nepovinný atribut Control. Určuje položku pole práce, ke kterému je ovládací prvek přidružen.Typ atributu je typelib:ReferenceFieldName.Minimální délka: 1; Maximální délka: 70. Vzorek hodnota: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [-zA-Z0-9_] +) +$ Příklad hodnoty vzorek: Company.Division.IssueType
Type	Požadovaný atribut typu Control. Určuje typ dat ovládacího prvku.Typ atributu je ValidControlsType jednoduchého typu.Zadejte řetězec z jednoho z následujících předdefinovaných typů: AttachmentControl: Slouží k zobrazení příloh pracovní položky.Tento ovládací prvek nemá přiřazené pole nebo pole typu aplikace. DateTimeControl: Slouží k zobrazení polí datum formátované pomocí polí typu DateTime. FieldControl: Slouží k zobrazení jednoduché textové nebo číselné pole a seznamy hodnot polí 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.Můžete určit pomocí dalších ovládacích prvků LabelText, Link a Text prvky.Více o tématu v LabelText a Text odkazu prvky jazyk XML a Propojení a Param referenční elementy jazyk XML. LinksControl: Pomocí ovládacího panelu odkazy zobrazit a spravovat propojení vztahů mezi pracovních položek a scénářů.Tento ovládací prvek nemá přiřazené pole nebo pole typu aplikace.Určit typy filtrů a další možnosti ovládání pomocí odkazů LinksControlOptions prvku.Viz téma LinksControlOptions prvky. WebpageControl: Slouží k zobrazení obsahu formátu HTML definované URI nebo vložené do CDATA značky.Tento ovládací prvek nemá přiřazené pole nebo pole typu aplikace..Zadejte obsah a odkazy zobrazíte pomocí WebpageControlOptions prvku.Viz téma Referenční elementy jazyk XML WebpageControlOptions. WorkItemClassificationControlSlouží k zobrazení hierarchické cesty polí s typem pole TreePath. Poznámka System.AreaPath a System.IterationPath pole jsou pouze tento datový typ pole.Nelze definovat vlastní pole tohoto typu. WorkItemLogControl: Slouží k zobrazení informací o historii pracovní položky a pole s typem pole History. Poznámka System.History Je pouze pole, která používá tento typ dat pole.Nelze definovat vlastní pole tohoto typu. Další informace naleznete v tématu Určení ovládacích prvků ve formuláři pracovní položky. Poznámka Můžete použít vlastní ovládací prvek nastavením Type vlastní hodnotu atributu.Žádné řízení, jehož Type hodnota neodpovídá názvu předdefinovaný typ považován za vlastní ovládací prvek.Další informace naleznete na webu společnosti Microsoft: Pracovní položky sledování vlastní ovládací prvky.
ControlFontSize	Nepovinný atribut Control. Určuje velikost písma popisek nebo název pole formuláře.Valid values of FontSize: small, normal, large, xlarge, and xxlarge.
EmptyText	Nepovinný atribut Control. Určuje textový řetězec mezi 1 a 255 znaků, který se zobrazí, pokud je pole prázdné.
Label	Nepovinný atribut Control. Určuje viditelný text na formuláři, který identifikuje ovládací prvek.Zadejte řetězec delší než 80 znaků.
LabelFontSize	Určuje velikost písma popisku ve formuláři.Valid values for FontSize: small, normal, large, xlarge, and xxlarge.
LabelPosition	Nepovinný atribut Control. 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 data ovládacího prvku popisek. Bottom: Umístí popisek pod dat ovládacího prvku. Left: Umístění popisku dat ovládacího prvku doleva. Right: Umístění popisku dat ovládacího prvku doprava.
Dock	Nepovinný atribut Control. Zarovná pole společně se zadanou strany kontejneru nebo roztáhne pole vyplnit 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 orientace Splitter prvku. Top: Zarovná pole spolu s horní nádobě.Tato hodnota není podporována orientace Splitter prvku. Bottom: Zarovná pole spolu s dna nádoby.Tato hodnota není podporována orientace Splitter prvku. Left: Zarovná pole a levé straně kontejneru. Right: Zarovná pole a pravé straně kontejneru.Tato hodnota není podporována orientace Splitter prvku.
Padding	Nepovinný atribut Control. Určuje velikost místa 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. Vzorek hodnota: ^ $\d+\,\d+\,\d+\,\d+$$ Příklad hodnoty vzorek: (2,0,2,0)
Margin	Nepovinný atribut Control. Určuje velikost místa 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. Vzorek hodnota: ^ $\d+\,\d+\,\d+\,\d+$$ Příklad hodnoty vzorek: (2,0,2,0)
ReadOnly	Nepovinný atribut Control. 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 data ovládacího prvku není jen pro čtení.
MinimumSize	Nepovinný atribut Control. 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. Vzorek hodnota: ^ $\d+\,\d+$$ Příklad hodnoty vzorek: (100,100) Poznámka Pokud není dostatek místa pro svislé, posuvníku se jeho minimální velikost.Bez tohoto atributu ovládací prvky jsou vybírány se jejich výchozí velikosti, pokud ovládací prvky v jiných kartách přijmout více místa.Celková velikost jednoho prvku závisí na velikosti největšího oblast formuláře nebo kartu.
Name	Nepovinný atribut Control. Jednoznačně identifikuje ovládací prvek.Name Je důležité, pokud více než jeden ovládací prvek na formuláři přidružen stejné položky pole práce.Typ atributu je xs:string. Poznámka Použití Name atributu, když chcete mít stejné pole zobrazené v 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ádací prvek do různých umístění v závislosti na kontextu karty.
NumberFormat	Volitelný Control 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 jsou povoleny celá čísla. 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ý Control 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ý Control atribut, který je platný pouze pokud je použita s DateTimeControl. Určuje formát pro pole Datum čas 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í" hodnota atributu formátu a nastavením jiného atributu s názvem CustomFormat s vlastní řetězec formátu.Příklad: Formát = "Vlastní" CustomFormat = "Dd. MMM rrrr"roku"" Další informace naleznete na webu společnosti Microsoft: DateTimePicker.CustomFormat vlastnost. Long: Zobrazí hodnotu, datum a čas v poli Formát dlouhého data nastavit uživatele operačního systému. Short: Zobrazí hodnoty data a času v krátkém formátu nastavit uživatele operačního systému. Time: Zobrazí hodnoty data a času v operačním systému uživatele nastavit formát času. Další informace naleznete na webu společnosti Microsoft: DateTimePickerFormat výčtu.
CustomFormat	Volitelný Control atribut, který je platný pouze pokud je použita s DateTimeControl a Format atributu. Určuje vlastní formát pro odpovídající syntaxe definovaných pro vlastnost DateTimePicker.CustomFormat pole data a času.Další informace naleznete na webu společnosti Microsoft: DateTimePicker.CustomFormat vlastnost.

Podřízené elementy

Element	Description
LabelText	Volitelný prvek.Tento prvek lze určit při Type je atribut zadán 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 jazyk XML a Poskytnutí textu nápovědy, dohledu nad procesem, webového obsahu a odkazů na webové stránky ve formuláři pracovní položky.
Odkaz	Volitelný prvek.Tento prvek lze určit při Type je atribut zadán jako FieldControl nebo LabelControl. Určuje hypertextový odkaz pro pole nebo popisek. Další informace naleznete v tématu Propojení a Param referenční elementy jazyk XML a Poskytnutí textu nápovědy, dohledu nad procesem, webového obsahu a odkazů na webové stránky ve formuláři pracovní položky.
LinksControlOptions	Volitelný prvek.Tento prvek lze určit při Type je atribut zadán jako LinksControl. Definuje odkaz filtry a rozložení sloupců polí zobrazíte seznam odkazů. Další informace naleznete v tématu Definice řízení propojení s cílem omezit vztahy určené propojeními.
WebpageControlOptions	Volitelný prvek.Tento prvek lze určit při Type je atribut 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 jazyk XML WebpageControlOptions a Poskytnutí textu nápovědy, dohledu nad procesem, webového obsahu a odkazů na webové stránky ve formuláři pracovní položky.
anyAttribute	Volitelný prvek. Nepovinné.Controlrozšířit pomocí anyAttribute prvku.

Nadřazené elementy

Element	Description
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 nutné zadat název ovládacího prvku pro Type atributu.Další informace naleznete na webu společnosti Microsoft: Pracovní položky sledování vlastní ovládací prvky.

Příklad pro každý typ ovládacího prvku, viz Určení ovládacích prvků ve formuláři pracovní položky.

Příklad

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

Informace o elementu

Obor názvů	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef
Název schématu	Definice položky typu práce
Ověřovací soubor	WorkItemTypeDefinition.xsd
Typ elementu	ControlType komplexní typ
Může být prázdný.	Nelze použít