Control – referenční dokumentace elementu XML

Článek
09/11/2015

Můžete použítControlelementu, 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 částiSpecify work item form controlsaDesign the work item form.

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ýControlatributu. Určuje pole pracovní položky, ke které je přidruženo ovládacího prvku. Typ atributu jetypelib: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éControlatributu. Určuje datový typ ovládacího prvku. Typ atributu jeValidControlsTypejednoduché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 poleDateTime. FieldControl: Slouží k zobrazení prostý textové nebo číselné pole a seznamy hodnot pro pole s typem poleStringIdentityIntegerDoubleaPlainText. HtmlFieldControl: Slouží k zobrazení více řádků, text ve formátu RTF Formát polí s typem poleHTML. 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íLabelTextLinkaTextelementů. Podívejte se na témaReferenční dokumentace XML elementů LabelText a TextaReferenč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íLinksControlOptionselementu. Podívejte se na témaLinksControlOptions – elementy. WebpageControl: Slouží k zobrazení 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íWebpageControlOptionselementu. Podívejte se na témaReferenční dokumentace XML elementů WebpageControlOptions. WorkItemClassificationControlSlouží k zobrazení hierarchické cesty polí s typem poleTreePath. Poznámka System.AreaPathaSystem.IterationPathpole 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 poleHistory. Poznámka System.HistoryPole je pouze pole, které používá tento datový typ.Vlastní pole, které používá tento datový typ nelze definovat. Další informace naleznete v tématuSpecify work item form controls. Poznámka Můžete použít vlastní ovládací prvek nastavenímTypevlastní hodnotu atributu.Libovolný řídicí, jehožTypehodnota 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ýControlatributu. Určuje velikost písma v názvu pole nebo popisek ve formuláři. Platné hodnotyFontSize:smallnormallargexlargeaxxlarge.
EmptyText	VolitelnýControlatributu. Určuje textový řetězec mezi 1 až 255 znaky v délku, která se zobrazí, pokud je pole je prázdný.
Label	VolitelnýControlatributu. 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. Platné hodnoty proFontSize:smallnormallargexlargeaxxlarge.
LabelPosition	VolitelnýControlatributu. 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ýControlatributu. 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 jeSizeType. Hodnota vzorku: ^ $\d+\,\d+\,\d+\,\d+$$ Příklad hodnoty vzor: (2,0,2,0)
Margin	VolitelnýControlatributu. 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 jeSizeType. Hodnota vzorku: ^ $\d+\,\d+\,\d+\,\d+$$ Příklad hodnoty vzor: (2,0,2,0)
ReadOnly	VolitelnýControlatributu. Určuje, že je pole jen pro čtení. Typ atributu jeReadOnlyType. 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ýControlatributu. 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 jeSizeType. 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ýControlatributu. Jednoznačně identifikuje ovládací prvek. NameJe důležité, pokud je více než jeden prvek ve formuláři přidružený stejné pole pracovní položky. Typ atributu jexs:string. Poznámka Můžete použítNameatributů, když chcete mít stejné pole, které jsou zobrazené na více než jednom místě ve formuláři.Zadejte jedinečnou hodnotu proNameatribut pro obě položky ovládacího prvku tak, aby systém jednoznačně identifikuje 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ýControlatribut, který je platný, pouze pokud je použit sFieldControl. 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ýControlatribut, který je platný, pouze pokud je použit sFieldControl. Určuje maximální délku povolených znaků pro ovládací prvek pole. Typ atributu jexs:integer.
Format	VolitelnýControlatribut, který je platný, pouze pokud je použit sDateTimeControl. 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ýControlatribut, který je platný, pouze pokud je použit sDateTimeControlaFormatatributu. 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řiTypeatributu je zadána jakoFieldControlneboLabelControl. 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ématuReferenční dokumentace XML elementů LabelText a TextaProvide help text, hyperlinks, or web content on a work item form.
Odkaz	Volitelný element. Můžete zadat Tento element přiTypeatributu je zadána jakoFieldControlneboLabelControl. Definuje hypertextový odkaz na pole nebo popisek. Další informace naleznete v tématuReferenční dokumentace XML elementů odkazů a parametrůaProvide help text, hyperlinks, or web content on a work item form.
LinksControlOptions	Volitelný element. Můžete zadat Tento element přiTypeatributu je zadána jakoLinksControl. Definuje připojení filtrů a rozložení sloupce polí zobrazíte seznam odkazů. Další informace naleznete v tématuDefinice řízení propojení s cílem omezit vztahy určené propojeními.
WebpageControlOptions	Volitelný element. Můžete zadat Tento element přiTypeje atributWebpageControl. 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ématuReferenční dokumentace XML elementů WebpageControlOptionsaProvide help text, hyperlinks, or web content on a work item form.
anyAttribute	Volitelný element. Volitelné. Controlje rozšiřitelný prostřednictvím použitíanyAttributeelementu.

Nadřazené elementy

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

Poznámky

Controlje volitelný podřízený prvekLayoutColumnaTab.

LayoutaColumnukazatele:

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 proTypeatributu. 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ématuSpecify work item form controls.

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

Viz také

Koncepty

All FORM XML elements reference

Specify work item form controls

Další zdroje

Návrh a přizpůsobení formuláře pracovní položky

Sdílet prostřednictvím