Kontrola wyświetlania pól elementów pracy

W formularzu elementów roboczych można kontrolować nazwę etykiety, położenie, rozmiar pola tekstowego i innych kontrolek wyświetlana jako zwykły tekst, liczba całkowita, liczba, Data i pola elementów roboczych ścieżka drzewa. Aby wyświetlić te pola, należy określić poprawną Control elementu Type atrybutu z następujących czynności:

• DateTimeControl: Używany do wyświetlania daty sformatowane pola, które zawierają pola typu DateTime.

• FieldControl: Służy do wyświetlania zwykły pól tekstowych czy liczbowych i wyświetla wartości pola, które zawierają pola typu String, Identity, Integer, Double, i PlainText.

• HtmlFieldControl: Umożliwia wyświetlenie wielowierszowym, tekstu sformatowanego format pola, które zawierają typem danych pola HTML.

• WorkItemClassificationControl Umożliwia wyświetlenie pola hierarchiczne ścieżki, które zawierają pola typu TreePath.

Aby uzyskać więcej informacji na temat innych Type formanty, zobacz następujące tematy:

• Określanie sterowania formularzem elementu pracy

• Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy

• Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi

• Dodawanie funkcji kontroli załączników

W tym temacie:

• Kontroluje rozmiar i wyświetlanie pola danych

• Etykieta pola i dodać pola w dwóch miejscach w formularzu

• Wybierz pole tylko do odczytu

• Dodaj jako zwykły tekst i numer pola

• Dodaj pola tekstu sformatowanego

• Dodaj pola daty lub kalendarza

• Dodaj pola do obszaru i iterację ścieżki

Kontroluje rozmiar i wyświetlanie pola danych

Za pomocą opcjonalnych atrybutów, które są opisane w poniższej tabeli można kontrolować odstępy, a rozmiar każdego pola danych.

Uwaga

Całkowity rozmiar każdego pola Zapis danych zależy od kilku czynników: atrybuty, które są przypisane do pola, rozmiar kontenera i obszar, który jest przydzielony do innych pól formularza.Wartości domyślne są przypisane do pola, jeśli nie zostanie określony minimalny rozmiar.Atrybuty, które są przypisane do innych pól w formularzu można jednak wpływa na rozmiar pola.Liczba kolumn i poziomie rozmiar, który można przydzielić do największego pola w każdej kolumnie należy określić poziomy wymiar formularza.Liczba pól, które zostaną określone w pionie grupy i rozmiar pionowy, który można przydzielić do każdego pola należy określić rozmiar górnej części formularza, a także rozmiar dolnej części formularza.

Atrybut	Opis	Przykład wartość wzorzec
MinimumSize	Określa minimalny rozmiar (szerokość, wysokość) dla formantu. Gdy kontener dla formantu jest mniejsza niż rozmiar, są wyświetlane paski przewijania poziomie i w pionie.	(100,100)
Margin	Określa w pikselach ilość miejsca wokół formantu i między formantem i wokół (góra, dół lewej, do prawej).	(2,0,2,0)
Padding	Określa wyrażoną w pikselach ilość wolnego miejsca zewnętrznego obramowania formantu (góra, dół lewej, do prawej).	(2,0,2,0)

Etykieta pola i dodać pola w dwóch miejscach w formularzu

Dla każdej kontrolki formularza, można określić pozycję etykiety i opcjonalną etykietę przy użyciu Label i LabelPosition atrybutów. Etykiety można określić nazwę inną niż przyjazną nazwę, która jest przypisany przez FIELD elementu. Jeśli nie określisz etykietę, przyjazna nazwa jest używana. Jednak pamiętać, że przyjazna nazwa jest zawsze używany członka zespołu uruchamia kwerendę do wyszukiwania elementów roboczych. Rozmiar maksymalny etykiety jest 80 znaków.

Uwaga

Należy zdefiniować to samo położenie etykiety do wszystkich formantów zdefiniowanych w tej samej grupie.

Jeśli chcesz dodać pola w więcej niż jedno pole formularza, takich jak u góry formularza i na karcie, możesz to zrobić przy użyciu Name atrybutu. Name Atrybut tylko identyfikuje formant w odróżnieniu od formant, który zostanie dodany do formularza.

W polu tylko do odczytu

Można zaznaczyć pole jako tylko do odczytu na dwa sposoby. W pierwszej metodzie, możesz dodać READONLY element jako element podrzędny FIELD elementu w FIELDS części definicji typu. Przy użyciu READONLY elementu, można określić czy niektórych użytkowników można zmodyfikować pola. Jak pokazano w następującym przykładzie, nazwę pomocniczą pola można modyfikować tylko program menedżerów.

<FIELD name="Sub-Title" refname="ACME.ACE.SubTitle" type="String" >
<READONLY for="[Global]\Team Foundation Valid Users" not="Program Managers"/>
</FIELD>

W drugiej metody, należy określić ReadOnly atrybutu dla CONTROL elementu. W tej metody wszyscy użytkownicy są ograniczeń modyfikowania pola.

Control FieldName=" ACME.ACE.SubTitle" Type="FieldControl" Label="Sub-Title" LabelPosition="Left" ReadOnly="True" />

Dodaj tekst i numer pola

Możesz użyć FieldControl typu do dodania jako zwykły tekst i numer pola do formularza. Ten atrybut również używany do zwiększenia listami wyboru; pola, które są używane do wyświetlania nazwy osoby, takich jak pola przydzielone do lub właściciela i liczba całkowita i liczb rzeczywistych. Formant pola musi odwoływać się do pola nazwy odwołania. Etykieta pola może być zwykły tekst lub wstawiony jako hiperłącze. Aby uzyskać więcej informacji, zobacz Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy.

Tekst, liczba całkowita i pobranie listy pól

Można kontrolować format liczb pola i maksymalną długość znaków, które mogą być wprowadzane w polu tekstu lub liczb przy użyciu opcjonalnych atrybutów, które są opisane w poniższej tabeli.

Atrybut	Opis
NumberFormat	Określa znaki, które można wprowadzać w formancie pola. Prawidłowe wartości mieszczą się w następujący sposób: WholeNumbers, SignedWholeNumbers, DecimalNumbers, i SignedDecimalNumbers.
MaxLength	Określa maksymalną długość znaków, których można użyć do sterowania polem.

Poniżej przedstawiono kod składni, który służy do tworzenia grupy pól, który pojawia się w poprzedniej ilustracji.

<TABGROUP>
<TAB Label="Planning">
<Group Label="Status" Padding="(0,0,0,3)">
   <Column PercentWidth="100">
      <Control FieldName="Microsoft.DevDiv.Importance" Type="FieldControl" Label="Importance" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Commitment" Type="FieldControl" Label="Commitment / Confidence" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.VisionDoc" Type="FieldControl" Label="Vision Doc" LabelPosition="Left" />
      <Control FieldName="Microsoft.DeveloperDivision.Features.EstimatedCost" Type="FieldControl" Label="Estimated Cost" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.BusinessUnit" Type="FieldControl" Label="BU (Use Area Path)" LabelPosition="Left" />
      <Control FieldName="Microsoft.DevDiv.Website" Type="FieldControl" Label="Website" LabelPosition="Left" />
   </Column>
</Group>
   . . .
</TAB>
</TABGROUP>

Dodaj pola tekstu sformatowanego

Możesz użyć HTMLFieldControl Typ, aby dodać pola, którego typem danych jest HTML. Ten formant zapewnia obsługę do wyświetlenia sformatowanego tekstu w wielu wierszach.

Pola HTML

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" MinimumSize="(100,500)" />

Porada

Po dodaniu kilku HTMLFieldControl elementy na formularzu, który ma zostać skumulowany w pionie, należy określić MinimumSize atrybutu dla każdego pola formantu.W ten sposób możesz robić podobne rozmiar wszystkich pól tekstowych.W przeciwnym razie ostatniego elementu kontrolki HTML jest dopasowywany do wypełnienia formularza i poprzednie elementy są wyświetlane razem z mniejszych pól tekstowych.

Dodaj pola daty lub kalendarza

Możesz użyć DateTimeControl Typ, aby umożliwić użytkownikom wybór kalendarza umożliwia wybranie daty dla DateTime pola. Za pomocą tego formantu, można szybko wybierz datę i godzinę dla pola.

Pole o Format kalendarza = "Skróconą"

Na przykład można określić preferowaną datę lub daty przeglądu, która przypada w przyszłości.

<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStart"
Label="Preferred Start Date:" LabelPosition="Left" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Format="Time" />

Można kontrolować format DateTime pola przy użyciu opcjonalnych atrybutów, które są opisane w poniższej tabeli.

Atrybut	Opis
Format	Określa format dla pola data-godzina, który odpowiada jednej wartości wyliczenia DateTimePickerFormat. Prawidłowe wartości mieszczą się w następujący sposób: Custom, Long, Short, Time. Po określeniu Custom, należy także ustawić CustomFormat atrybutu.
CustomFormat	Określa format niestandardowy, wykorzystywany dla pola data-godzina, które odpowiada składni zdefiniowanej dla właściwości DateTimePicker.CustomFormat. Na przykład: Format = "Niestandardowe" CustomFormat = "Mm-dd, rrrr"roku"" Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: Właściwości DateTimePicker.CustomFormat.

Dodaj pola do obszaru i iterację ścieżki

Możesz użyć WorkItemClassificationControl Typ, aby dodać pola, którego typem danych jest TreePath. Ten formant umożliwia obsługę wyświetlania pól ścieżkę obszaru i ścieżki iteracji w formacie hierarchiczne, zagnieżdżone drzewa. W drzewie wyświetlana hierarchiczne węzły można rozwinąć i zwinąć.

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

Uwaga

Można użyć WorkItemClassificationControl do wyświetlenia System.AreaPath i System.IterationPath pól.Nie można wyświetlić innego typu pola lub pole niestandardowe za pomocą tego formantu.

Aby uzyskać więcej informacji, zobacz Dodawanie i modyfikowanie obszaru i ścieżek iteracji.

Zobacz też

Koncepcje

Dodawanie i modyfikowanie pól elementów roboczych w celu obsługi raportowania

Dodawanie funkcji kontroli załączników

Zmiana sterowania łączami w taki sposób, aby ograniczyć relacje pomiędzy nimi

Inne zasoby

Dodawanie tekstów pomocy, hiperłączy lub zawartości WWW do formularza elementów pracy