Dokumentacja elementu Layout kodu XML

Artykuł
09/13/2015

Można użyć Layout elementu, aby zdefiniować sposób wyświetlania elementów na formularzu elementu pracy. Można określić więcej niż jeden układ do obsługi różnych klientów, takich jak Windows client for Visual Studio lub klienta sieci web dla Team Web Access.

Aby dodać elementy do formularza, możesz modyfikować definicję typu elementu roboczego. Zobacz Modyfikowanie lub dodawanie dostosowanego typu elementu pracy.

Layout Element jest wymagany element podrzędny elementu FORM elementu. Aby uzyskać więcej informacji dotyczących sposobu używania Layout elementu, zobacz Projektowanie formularza elementu roboczego.

Schemat hierarchii

WITD

WORKITEMTYPE

FORMULARZ

Layout

<Layout Target="ClientName" MinimumSize="(width,height)" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ControlSpacing="distance" LabelSpacing="distance" HideControlBorders="True | False"
HideReadOnlyEmptyFields="True | False">
    <Group> . . . </Group>
    <Control> . . . </Control>
    <TabGroup> . . . </TabGroup>
    <Splitter> . . . </Splitter>
</Layout >

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
Target	Opcjonalny Layout atrybutu. Określa nazwę klienta, którego dotyczy układu. Typ jest xs:string. Określ jeden z następujących ciągów: WinForms: Dotyczy formularza, aby Team Explorer i Team Explorer Everywhere. Web: Dotyczy formularza, aby Team Web Access.
MinimumSize	Opcjonalny Layout atrybutu. Określa minimalny rozmiar w pikselach formularza. Składnia jest określone w (szerokość, wysokość). Typ atrybutu SizeType. Wartość do wzorca: ^ $\d+\,\d+$$ Przykład wartość wzorzec: (100,100)
Padding	Opcjonalny Layout atrybutu. Określa ilość miejsca w pikselach wokół wewnątrz obramowania formularza. Typ atrybutu SizeType. Wartość do wzorca: ^ $\d+\,\d+\,\d+\,\d+$$ Przykład wartość wzorzec: (2,0,2,0)
Margin	Opcjonalny Layout atrybutu. Określa ilość miejsca w pikselach wokół zewnętrznego obramowania formularza. Typ atrybutu SizeType. Wartość do wzorca: ^ $\d+\,\d+\,\d+\,\d+$$ Przykład wartość wzorzec: (2,0,2,0)
ControlSpacing	Opcjonalny Layout atrybutu. Określa przesunięcie w pionie kontrolek zdefiniowanych w formularzu.
LabelSpacing	Opcjonalny Layout atrybutu. Określa liczbę pikseli pomiędzy etykiety i obszar edycji formantu.
HideControlBorders	Opcjonalny Layout atrybutu. Określ wartość True można ukryć obramowania formantu i False do wyświetlenia obramowania formantu.
HideReadOnlyEmptyFields	Opcjonalny Layout atrybutu. Określ wartość True Aby ukryć pola tylko do odczytu lub jest pusty, a False Aby wyświetlić te pola.

Elementy podrzędne

Element	Opis
Grupa	Parametr opcjonalny. Definiuje grupę elementów, które mają być wyświetlane razem na formularzu.
Formant	Parametr opcjonalny. Definiuje pola elementów roboczych, tekst, hiperłącze lub innego elementu sterowania do wyświetlenia w postaci elementów roboczych.
TabGroup	Parametr opcjonalny. Zawiera co najmniej jeden Tab elementów.
Rozdzielacz	Parametr opcjonalny. Definiuje podziału i jego orientację na formularzu między elementami formularzy równorzędny.

Elementy nadrzędne

Element	Opis
FORMULARZ	Parametr wymagany. Zawiera Layout element, który definiuje sposób wyświetlania elementów w formularzu typu elementu roboczego.

Uwagi

Layout Element jest wymagany element podrzędny elementu FORM. Layout Element Określa wybór, a musi być zdefiniowany co najmniej jeden z elementów podrzędnych: Group, Control, TabGroup, lub Splitter. Można określić więcej niż jeden element podrzędny.

minOccurs = "1"

maxOccurs = "niepowiązanego"

Przykład

<FORM>
   <Layout>
      <Group>
          <Column PercentWidth="36">
            <Group>
            <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
            <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area" LabelPosition="Left" />
            <Control FieldName="Microsoft.VSTS.Common.ProductUnit" Type="FieldControl" Label="Product Unit" LabelPosition="Left" />
            <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="Business Unit" LabelPosition="Left" />
            </Group>
          </Column>
          <Column PercentWidth="33">
            <Group>
            <Control FieldName="Microsoft.DevDiv.SubTitle" Type="FieldControl" Label="Sub Title" LabelPosition="Left" />
            <Control FieldName="System.IterationPath" Type="WorkItemClassificationControl" Label="Iteration" LabelPosition="Left" />
            <Control FieldName="Microsoft.DevDiv.Other" Type="FieldControl" Label="Other" LabelPosition="Left" />
            </Group>
          </Column>
          <Column PercentWidth="31">
            <Group>
            <Control FieldName="Microsoft.DevDiv.Type" Type="FieldControl" Label="Type" LabelPosition="Left" />
            <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assigned To" LabelPosition="Left" />
            <Control FieldName="System.State" Type="FieldControl" Label="State" LabelPosition="Left" />
            </Group>
          </Column>
      </Group>
. . .
   </Layout>
</FORM>

Informacje o elementach

Przestrzeń nazw	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/TypeDef
Nazwa schematu	Definicja typu elementu roboczego
Sprawdzanie poprawności plików	WorkItemTypeDefinition.xsd
Typ elementu	Typu złożonego LayoutType
Może być pusta.	Nie