Control – referenční dokumentace elementu XML

Článek
06/09/2015

Můžete použít Control elementu, který chcete definovat svoji pracovní položky pole, text, hypertextový odkaz nebo jiného elementu ovládacího prvku, chcete-li zobrazit ve formě pracovní položku.Příklady toho, jak používat tento element, naleznete v části 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 [přesměrováno].

Schéma hierarchie

<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"  Padding="(top, bottom, left, right)"  Margin="(top, bottom, left, right)" 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 nadřazené prvky.

Atributy

Atribut	Popis
FieldName	Volitelný atribut typu Control. Určuje pole pracovní položky, ke které je přidruženo ovládacího prvku.Typ atributu je typelib:ReferenceFieldName.Minimální délka: 1; Maximální délka: 70. Hodnota vzorku: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [-zA-Z0-9_] +) + $ Příklad hodnoty vzor: Company.Division.IssueType
Type	Požadovaný atribut typu Control. Určuje datový typ ovládacího prvku.Typ atributu je ValidControlsType jednoduchého typu.Zadejte řetězec z jednoho z následujících vestavěné typy: AttachmentControl: Slouží k zobrazení příloh pracovní položky.Tento ovládací prvek nemá s přidruženým polem nebo typ pole. DateTimeControl: Slouží k zobrazení formátovaná datum polí s typem pole DateTime. FieldControl: Slouží k zobrazení prostý textové nebo číselné pole a seznamy hodnot pro pole s typem pole String, Identity, Integer, Double, a PlainText. HtmlFieldControl: Slouží k zobrazení více řádků, text ve formátu RTF Formát polí s typem pole HTML. LabelControl: Slouží k zobrazení textu, který není spojen s polem.Text může být prostý nebo s hypertextovým odkazem.Můžete zadat další ovládací prvky pomocí LabelText, Link a Text elementy.Viz Referenční dokumentace XML elementů LabelText a Text a Referenční dokumentace XML elementů odkazů a parametrů. LinksControl: Slouží k zobrazení ovládací panel odkazy a spravovat relace propojení mezi pracovními položkami a scénáře.Tento ovládací prvek nemá s přidruženým polem nebo typ pole.Zadejte typy odkazů na filtru a další možnosti ovládání pomocí LinksControlOptions elementu.Další informace naleznete v tématu LinksControlOptions – elementy. WebpageControl: Pomocí můžete zobrazit obsah ve formátu HTML určené identifikátoru URI nebo vložené v rámci CDATA značky.Tento ovládací prvek nemá s přidruženým polem nebo typ pole..Zadejte obsah a odkazy na zobrazení pomocí WebpageControlOptions elementu.Další informace naleznete v tématu Referenční dokumentace XML elementů WebpageControlOptions. WorkItemClassificationControlSlouží k zobrazení hierarchické cesty polí s typem pole TreePath. [!POZNÁMKA] System.AreaPath a System.IterationPath pole jsou pouze pole, které používají tento datový typ.Vlastní pole, které používá tento datový typ nelze definovat. WorkItemLogControl: Slouží k zobrazení informací historie pracovní položky a pole s typem pole History. [!POZNÁMKA] System.History Pole je pouze pole, které používá tento datový typ.Vlastní pole, které používá tento datový typ nelze definovat. 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.Libovolný řídicí, jehož Type hodnota neodpovídá názvu integrovaný typ je považován za vlastní ovládací prvek.Další informace naleznete na webu společnosti Microsoft: pracovní položka sledování vlastní ovládací prvky.
ControlFontSize	Volitelný atribut typu Control. Určuje velikost písma v názvu pole nebo popisek ve formuláři.Valid values of FontSize: small, normal, large, xlarge, and xxlarge.
EmptyText	Volitelný atribut typu Control. Určuje textový řetězec mezi 1 až 255 znaky v délku, která se zobrazí, pokud je pole je prázdný.
Label	Volitelný atribut typu Control. Určuje viditelný text ve formuláři, který identifikuje ovládací prvek.Určuje řetězec s maximálně 80 znaky.
LabelFontSize	Určuje velikost písma popisku ve formuláři.Valid values for FontSize: small, normal, large, xlarge, and xxlarge.
LabelPosition	Volitelný atribut typu Control. Určuje umístění popisku vzhledem k datům ovládacího prvku.Zadejte řetězec z jednoho z následujících hodnot: Top: Umístí popisek nad dat ovládacího prvku. Bottom: Umístí popisek pod dat ovládacího prvku. Left: Umístí popisek nalevo od dat ovládacího prvku. Right: Umístí popisek k pravému okraji dat ovládacího prvku.
Padding	Volitelný atribut typu Control. Určuje velikost místa v pixelech kolem uvnitř ohraničení ovládacího prvku, který odpovídá horní, dolní, levý a pravý mezery.Typ atributu je SizeType. Hodnota vzorku: ^ $\d+\,\d+\,\d+\,\d+$$ Příklad hodnoty vzor: (2,0,2,0)
Margin	Volitelný atribut typu Control. Určuje velikost místa v pixelech kolem vnějšího okraje ovládacího prvku, který odpovídá horní, dolní, levý a pravý mezery.Typ atributu je SizeType. Hodnota vzorku: ^ $\d+\,\d+\,\d+\,\d+$$ Příklad hodnoty vzor: (2,0,2,0)
ReadOnly	Volitelný atribut typu Control. Určuje, že je pole jen pro čtení.Typ atributu je ReadOnlyType.Zadejte řetězec z jednoho z následujících hodnot: True: Určuje, zda ovládací prvek dat je jen pro čtení. False: Určuje, že dat ovládacího prvku není jen pro čtení.
MinimumSize	Volitelný atribut typu Control. Určuje minimální velikost v pixelech, které by měl zabírají ovládací prvek ve formuláři.Syntaxe je definováno v (width,height).Typ atributu je SizeType. Hodnota vzorku: ^ $\d+\,\d+$$ Příklad hodnoty vzor: (100,100) [!POZNÁMKA] Pokud nemáte dostatečná svislé mezery, se zobrazí, aby jeho minimální velikost posuvníku.Bez tohoto atributu se vykresluje ovládací prvky s jejich výchozí velikosti, není-li ovládací prvky v jiných kartách provést další místo.Celková velikost libovolného ovládacího prvku jeden formulář závisí na velikost největší oblast formuláře nebo kartu.
Name	Volitelný atribut typu Control. Jednoznačně identifikuje ovládací prvek.Name Je důležité, pokud je více než jeden prvek ve formuláři přidružený stejné pole pracovní položky.Typ atributu je xs:string. [!POZNÁMKA] Můžete použít Name atributů, když chcete mít stejné pole, které jsou zobrazené na více než jednom místě 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.
NumberFormat	Volitelný Control atribut, který je platný, pouze pokud je použit s FieldControl. Určuje znaky, které lze zadat do ovládacího prvku pole.Platné hodnoty, které můžete použít jsou následující: WholeNumbers: Určuje, zda jsou povoleny celá čísla. SignedWholeNumbers: Určuje, zda jsou povoleny podepsaný celá čísla. DecimalNumbers: Určuje, zda jsou povoleny desetinná čísla. SignedDecimalNumbers: Určuje, zda jsou povoleny podepsaný desetinná čísla.
MaxLength	Volitelný Control atribut, který je platný, pouze pokud je použit s FieldControl. Určuje maximální délku povolených znaků pro ovládací prvek pole.Typ atributu je xs:integer.
Format	Volitelný Control atribut, který je platný, pouze pokud je použit s DateTimeControl. Určuje formát pro pole Datum a čas odpovídající jedné z hodnot výčtu DateTimePickerFormat.Platné hodnoty, které můžete použít jsou následující: Custom: Zobrazí hodnotu data a času ve vlastním formátu.Vlastní formát lze nastavit určením 'Vlastní' jako hodnotu pro atribut formátu a nastavení jiný atribut s názvem CustomFormat s vlastní řetězec formátu.Příklad: Formát = "Vlastní" CustomFormat = "Dd. mm yyyy 'roku'" Další informace naleznete na webu společnosti Microsoft: DateTimePicker.CustomFormat vlastnost. Long: Zobrazí hodnotu Datum a čas ve formátu datum (dlouhé) nastavte uživatele operačním systému. Short: Zobrazí hodnotu Datum a čas ve formátu datum (krátké) nastavte uživatele operačním systému. Time: Zobrazí hodnotu Datum a čas ve formátu času, nastavení uživatele operačním systému. Další informace naleznete na webu společnosti Microsoft: DateTimePickerFormat výčet.
CustomFormat	Volitelný Control atribut, který je platný, pouze pokud je použit s DateTimeControl a Format atributu. Určuje vlastní formát pro pole Datum a čas odpovídá syntaxi, definovanou pro vlastnost DateTimePicker.CustomFormat.Další informace naleznete na webu společnosti Microsoft: DateTimePicker.CustomFormat vlastnost.

Podřízené elementy

Prvek	Popis
LabelText	Volitelný element.Můžete zadat tento element při Type atributu je zadána jako FieldControl nebo LabelControl. Kontejner prvku pro zadávání textu, hypertextový odkaz a pozici pole nebo popisek, jejíž text je částečně přidružený hypertextový odkaz. Další informace naleznete v tématu Referenční dokumentace XML elementů LabelText a Text a Poskytnutí textu nápovědy, hypertextových odkazů nebo webového obsahu ve formuláři pracovní položky.
Odkaz	Volitelný element.Můžete zadat tento element při Type atributu je zadána jako FieldControl nebo LabelControl. Definuje hypertextový odkaz na pole nebo popisek. Další informace naleznete v tématu Referenční dokumentace XML elementů odkazů a parametrů a Poskytnutí textu nápovědy, hypertextových odkazů nebo webového obsahu ve formuláři pracovní položky.
LinksControlOptions	Volitelný element.Můžete zadat tento element při Type atributu je zadána jako LinksControl. Definuje připojení filtrů a rozložení sloupce 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ý element.Můžete zadat tento element při Type atribut je WebpageControl. Určuje ovládací prvky, kterými se řídí načítání webové stránky cíl ve formuláři pracovní položky. Další informace naleznete v tématu Referenční dokumentace XML elementů WebpageControlOptions a Poskytnutí textu nápovědy, hypertextových odkazů nebo webového obsahu ve formuláři pracovní položky.
anyAttribute	Volitelný element. Volitelné.Controlje rozšiřitelný prostřednictvím použití anyAttribute elementu.

Nadřazené elementy

Prvek	Popis
Rozložení	Požadováno.Určuje, jak se zobrazí prvky ve formuláři pracovní položky.
Sloupec Element	Požadováno.Definuje sloupce pro daný formulář.
Karta Element	Požadováno.Definuje kartu pro daný formulář.

Poznámky

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

Layouta Column ukazatele:

minOccurs = "0"

maxOccurs = "1"

Tabukazatele:

minOccurs = "0"

maxOccurs = "bez vazby"

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

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

Příklad

<Control Type=" WorkItemClassificationControl " FieldName="System.AreaPath"
  Label="Area" LabelPosition="Left" Padding="(2,0,2,0)" Margin="(2,2,2,2)" />

Informace o elementu

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