Aracılığıyla paylaş

Tüm form XML öğeleri başvurusu

  • Makale

Bu konudaki bilgileri bir iş öğesi türü için formu denetleyen tüm öğelere ve temel özniteliklere hızlı başvuru olarak kullanabilirsiniz. FORM öğesi kapsayıcısındaki, iş öğesi türünün tanımının üçüncü ve son büyük bölümünde bu öğeleri belirtin. Birçok öğe diğer öğelerle iç içe geçerek bir iş öğesi şeklinde grup, bölüm veya sekmeler oluşturur. Bu öğeleri gruplara ayırma hakkında daha fazla bilgi için bkz. Çalışma Öğesi Formunun Düzenini Tasarlama.

Bu konuda

  • FORM Örneği

  • FORM Öğeleri için Sözdizimi

  • FORM Öğelerinin Belirttiği Öznitelikler

  • Bağımsız Etiketleri, Köprüleri, Web Sayfalarını veya HTML İçeriğini Belirten Öğeler

  • Bağlantı İlişkilerini Filtreleyen ve Gösteren Öğeler

FORM Örneği

Aşağıdaki örnek FORM öğesinin genel yapısını gösterir. Layout öğesini kullanarak formun düzenini belirtin. Farklı istemcileri hedef alan farklı düzenler belirleyebilirsiniz. Örneğin, Windows istemcileri için bir düzen ve Ekip Web Erişimi için farklı bir düzen belirleyebilirsiniz. Bir düzen, genellikle formun üst kısmından ve sonrasında bir sekme grubundan oluşur. Düzen dahilinde içinde öğeleri tanımladığınız dize form üzerinde öğelerin görüntüleneceği dizeyi belirler.

Öğeleri sütunların içinde görünecek şekilde gruplandırmak için Group ve Column öğelerini kullanın. Formda görünmesini alanları tanımlamak için bir Control öğesi kullanın. Alan gruplarının farklı işlevsel alanlarını desteklemek için Tab öğesini kullanın.

<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>

Form öğeleri

Aşağıdaki tabloda açıklanan öğeleri kullanarak bir iş öğesi formunda bilgi ve iş öğesi alanlarının nasıl gruplandırıldığını belirtebilirsiniz.

Not

En iyi sonuçlar için, Control öğelerini bir Group üzerinde iç içe geçirmeniz gereklidir ve sütun formun tam genişliğine yayılsa bile, Group öğelerini Column üzerinde iç içe geçirmeniz gereklidir.Ayrıca, grubun görünür bir etiket ya da sınırı olmasa bile, her Column bölümünü bir Group içine yerleştirebilirsiniz.

Öge

Description

Gerekli midir?

Column

Formun bölgelerini sütunlara ayırır.

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

Önerilen

Control

İş öğesi formunda görünecek bir alan, metin, köprü veya diğer bir denetim öğesi tanımlar.

<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" />

Daha fazla bilgi için bkz. Denetim XML Öğesi Başvurusu.

Zorunlu

FORM

Üst düzey form öğesini tanımlar.

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

Zorunlu

Group

Windows GroupBox ile benzer bir şekilde öğelerin görsel olarak gruplandırılmasını sağlar.

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

Önerilen

Layout

İş öğesi formunun düzenini tanımlar.

<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>

Zorunlu

Splitter

İki eşdüzey form öğesinin düzenini desteklemek için formu iki alana ayırır.

Splitter Dock="Left" />

İsteğe bağlıdır

Tab

Sekme grubu içerisindeki tek bir sekmenin düzenini tanımlar.

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

İsteğe bağlıdır

TabGroup

Formu için bir veya daha fazla sekme tanımlar.

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

İsteğe bağlıdır

Başa dön

FORM Öğelerini Biçimlendirmek İçin Kullanılan Öznitelikler

Aşağıdaki tabloda açıklanan öznitelikleri belirterek, bir çalışma öğesi formundaki birçok öğenin aralık ve boyutunu denetleyebilirsiniz. Daha fazla bilgi için bkz. Çalışma Öğesi Formunun Düzenini Tasarlama.

Öznitelik

Description

Uygulanabilir Öğeler

ControlSpacing

İsteğe Bağlı. Denetimlerin dikey uzaklığını belirtir. Tamsayı.

Layout

Dock

İsteğe Bağlı. Bölmenin kalanını doldurmak için alan denetimi veya ışın bölücüyü gerdirir. Geçerli alan sabitleme değerleri aşağıdaki gibidir: Üst, Alt, Solu, Doldur ve Sağ.

  • Fill: Kapsayıcıyı doldurması için alanı hizalar.

  • Top: Alanı kapsayıcının üst tarafı ile hizalar.

  • Bottom: Alanı kapsayıcının alt tarafı ile hizalar.

  • Left: Alanı veya ayırıcıyı kapsayıcının sol tarafı ile hizalar. Bu değer SPLITTER öğesi için desteklenen bir hizalamadır.

  • Right: Alanı veya ayırıcıyı kapsayıcının sağ tarafı ile hizalar.

Control

Splitter

FixedWidth

İsteğe Bağlı. Piksel cinsinden sütun genişliği. PercentWidth ve FixedWidth, birlikte kullanılamaz.

Column

Label

İsteğe Bağlı. Bir denetim ya da grup için görüntülenecek metin. Etiket belirtilirse, denetimin meta veri alanıyla ilişkili herhangi bir etiketi geçersiz kılar.

Tab öğesi için gerekir. Bir sekme için görüntülenecek metin.

LabelText 1 ila 80 karakter içeren bir metin dizesidir.

Control

Group

Tab

LabelPosition

İsteğe Bağlı. Etiketin alan verisine göre konumu. Olası değerler şunlardır: Üst, Alt, Sol ve Sağ.

Control

LabelSpacing

İsteğe Bağlı. Denetimin düzenleme bölgesiyle etiket arasındaki piksel sayısını belirtir.

Layout

Margin

İsteğe Bağlı. Denetim ve komşuları arasındaki ve denetim etrafındaki alan miktarını piksel cinsinden belirten biçim dizesi (sol, üst, sağ, alt). Her iki taraftaki alan miktarını değiştirebilirsiniz.

Desen değeri: ^\(\d+\,\d+\,\d+\,\d+\)$

Desen değeri örneği: (2,0,2,0)

Control

Group

Layout

Tab

TabGroup

MinimumSize

İsteğe Bağlı. Biçim dizesi (width, height). Bu değer formun kendisi için en az boyutu belirtir. Kapsayıcı denetimi bu boyuttan küçük olduğunda, yatay ve dikey kaydırma çubukları belirir.

Control

Layout

Name

İsteğe Bağlı. Denetim adı. Belirtilmezse, adı FieldName öğesi ile aynıdır.

Control

Padding

İsteğe Bağlı. Denetime ait dış sınır veya iç sınır etrafındaki alan miktarını piksek cinsinden belirten biçim dizesi (sol, üst, sağ, alt). Her iki taraftaki alan miktarını değiştirebilirsiniz.

Control

Group

Layout

Tab

TabGroup

PercentWidth

İsteğe Bağlı. Kapsayan öğe genişliğinin bir yüzdesi olarak sütun genişliği. PercentWidth ve FixedWidth, birlikte kullanılamaz.

Column

ReadOnly

İsteğe Bağlı. Bir denetimde bir salt okunur alanını görüntüleyebilirsiniz. Farklı denetimler bu özniteliğe biraz değişik şekillerde karşılık verir.

Control

Target

İsteğe Bağlı. Bu düzenin hangi müşteri için geçerli olacağını belirten dize. Target özniteliği atlanmış veya Windows Forms'a ayarlanmışsa, Visual Studio öğesi bu düzendeki çalışma öğesi türünü görüntüler. Visual Studio yoksayan özel Target özniteliklerini kullanarak harici istemciler ilave düzenler belirleyebilir.

Aşağıdaki değerler geçerlidir:

  • WinForms: Formu Ekip Gezgini ve Ekip Gezgini Her Yerde için uygular.

  • Web: Formu Ekip Web Erişimi öğesine uygular.

Layout

Type

Gerekli. Denetimin türü. Daha fazla bilgi için bkz. Denetim XML Öğesi Başvurusu.

Control

Başa dön

Bağımsız Etiketleri, Köprüleri, Web Sayfalarını veya HTML İçeriğini Belirten Öğeler

WebpageControlOptions öğesi ve onun alt öğeleri aşağıdaki sözdizimi yapısını içerir:

<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>

Düz metin veya köprü etiketlerini tanımlamak, bir alana köprüler eklemek veya bir iş öğesi formunda Web sayfası içeriğini görüntülemek için aşağıdaki tabloda açıklanan öğeleri kullanın. Daha fazla bilgi için bkz. Çalışma Öğesi Formunda Yardım Metni, İşlem Kılavuzu, Web İçeriği ve Web Sayfalarına Bağlantılar Sağlama.

Öge

Gerekli midir?

Description

Content

İsteğe bağlı WebpageControlOptions öğesi.

Bir çalışma öğesi biçiminde görünecek CDATA HTML tabanlı içeriği belirtir.

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

Daha fazla bilgi için bkz. WebpageControlOptions XML Öğeleri Başvurusu.

LabelText

Seçime bağlı Control öğesi type="LabelControl" olduğunda.

Düz veya köprülenmiş etiketi tanımlar.

Daha fazla bilgi için bkz. LabelText ve Metin XML Öğeleri Başvurusu.

Link

Seçime bağlı Control öğesi type="FieldControl" olduğunda.

İsteğe bağlı Text öğesi.

İsteğe bağlı WebpageControl öğesi.

İsteğe bağlı WebpageControlOptions öğesi.

Bir alan, etiket veya Web tarayıcı içeriği için iş öğesi formunda görüntülenecek köprüyü tanımlar.

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

Daha fazla bilgi için bkz. Bağlantı ve Parametre XML Öğeleri Başvurusu.

Param

İsteğe bağlı Link öğesi.

Link öğesi için URLPath belirtildiğinde köprünün URL'sini belirlemek için bir değer belirtir.

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

Daha fazla bilgi için bkz. Bağlantı ve Parametre XML Öğeleri Başvurusu.

Text

İsteğe bağlı LabelText öğesi.

İş öğesi formunda gözükecek olan bilgi veya etiket için kapsayıcı öğe.

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

Daha fazla bilgi için bkz. LabelText ve Metin XML Öğeleri Başvurusu.

WebpageControlOptions

Seçime bağlı Control öğesi type="WebpageControl" olduğunda.

Web sayfası denetimi için seçenekleri belirten kapsayıcı öğe.

Daha fazla bilgi için bkz. WebpageControlOptions XML Öğeleri Başvurusu.

Başa dön

Bağlantı İlişkilerini Filtreleyen ve Gösteren Öğeler

LinksControlOptions öğesini, bir iş öğesine ne tür bağlantıların eklenebileceğini denetlemek için seçenekleri ve bir iş öğesinde bağlantılar listesinde görünmesini istediğiniz varsayılan sütunları belirlemek üzere kullanırsınız. Bir iş öğesi formuna bir bağlantı denetimi eklediğinizde, kullanıcıların görüntüleyebildikleri ve oluşturabildikleri bağlantı türlerini ve kullanıcıların aralarında bağlantı oluşturabildikleri çalışma öğesi türlerini sınırlayan filtreler belirtebilirsiniz. LinksControlOptions öğesi ve alt öğeleri aşağıdaki yapıya sahiptir:

<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>

Özellikle, aşağıdaki tabloda özetlenen öğeleri kullanırsınız. Bu öğeleri kullanmayla ilgili daha fazla bilgi için bkz. Bağlantı İlişkilerini Kısıtlamak için Bağlantı Denetimlerini Tanımlama ve LinksControlOptions Öğeleri.

Öge

Gerekli midir?

Description

LinksControlOptions

Seçime bağlı Control öğesi type="LinksControl" olduğunda.

İş öğesine ne tür bağlantıların eklenebileceğini denetlemek için seçenekleri ve bir iş öğesinde bağlantılar listesinde görünmesini istediğiniz varsayılan sütunları belirleyen öğeler için kapsayıcı sağlanır.

WorkItemLinkFilters

İsteğe bağlı LinksControlOptions öğesi

Bir ya da daha fazla Filter öğesi için, takım projesi koleksiyonunda tanımlanmış bağlantı türlerini kullanmak üzere bağlantı filtresi kriterlerini belirten bir kapsayıcı sağlamaktadır.

ExternalLinkFilters

İsteğe bağlı LinksControlOptions öğesi

Bir ya da daha fazla Filter öğesi için, diğer takım projelerinde tanımlanmış bağlantı türlerini kullanmak üzere filtre kriterlerini belirten bir kapsayıcı sağlamaktadır.

WorkItemTypeFilters

İsteğe bağlı LinksControlOptions öğesi

İş öğesi türlerine uygulanacak filtre kriterlerini belirten bir ya da daha fazla Filter öğesi için bir kapsayıcı sağlar.

Filter (bağlantı türleri)

FilterType özniteliği exclude veya include olduğunda WorkItemLinkFilters öğesi gerekir.

FilterType özniteliği exclude veya include olduğunda ExternalLinkFilters öğesi gerekir.

İş öğesi için oluşturulabilecek bağlantı türleri kümesinden dahil edilecek veya hariç tutulacak bağlantı türlerini belirtir.

Filter (iş öğesi türleri)

FilterType özniteliği, exclude veya include olduğu zaman, isteğe bağlı WorkItemTypeFilters öğesi.

Kullanıcıların arasında bağlantı kurabileceği çalışma öğesi türleri kümesinden dahil edilecek veya hariç tutulacak çalışma öğesi türlerini belirtir.

LinkColumns

İsteğe bağlı LinksControlOptions öğesi

Bir ya da daha fazla LinkColumn etiketi için bir kapsayıcı sağlar.

LinkColumn

Gerekli LinkColumns öğesi

Bağlantılar listesine yönelik çalışma öğesi formunda görünen iş öğesi alanlarını ve bağlantı türü özniteliklerini belirtir.

Başa dön

Ayrıca bkz.

Kavramlar

Çalışma Öğesi Formunun Düzenini Tasarlama

Çalışma Öğesi Formu Tasarlama ve Özelleştirme

Diğer Kaynaklar

Çalışma Öğesi Türleri için XML Öğe Tanımlarının Dizini