Kontrola wyświetlania pól elementów pracy

Artykuł
06/10/2015

W formularzu elementu pracy można kontrolować nazwę etykiety, położenie, rozmiar pola tekstowego i innych formantów 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ć prawidłowego Control elementu Type atrybutu z następujących opcji:

DateTimeControl: Używany do wyświetlania pól daty sformatowane, których typ pola DateTime.
FieldControl: Used to display plain textual or numeric fields and lists of values for fields that have a field type of String, Identity, Integer, Double, and PlainText.
HtmlFieldControl: Używany do wyświetlania wielowierszowym, tekstu sformatowanego format pola, które mają typ danych pola HTML.
WorkItemClassificationControlUżywany do wyświetlania pól hierarchicznego ścieżki, które mają typ pola TreePath.

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

W tym temacie:

Kontroluje rozmiar i wyświetlania pól danych
Etykieta pola i dodawanie pól w dwóch miejscach na formularzu
Pole było tylko do odczytu
Dodaj jako zwykły tekst i numer pola
Dodaj pola tekstu sformatowanego
Dodaj pola daty lub kalendarza
Dodaj pola ścieżek obszaru i iterację

Kontroluje rozmiar i wyświetlania pól danych

Możesz kontrolować rozdzielenia i rozmiar każdego pola danych przy użyciu opcjonalne atrybuty, które są opisane w poniższej tabeli.

[!UWAGA]

Całkowity rozmiar każdego pola danych wpisu zależy od kilku czynników: atrybuty, które są przypisane do pola, rozmiar kontenera i obszaru przydzielonej dla innych pól formularza.Wartości domyślne są przypisane do pola, gdy nie określono minimalnej wielkości.Jednakże atrybuty, które są przypisane do innych pól formularza może mieć wpływ na rozmiar pól.Liczba kolumn i poziomy rozmiar przydzielić do największego pola w każdej kolumnie, należy określić poziomy wymiar formularza.Numer pola określone w pionie grupy i pionowy rozmiar przydzielić do każdego pola należy określić rozmiar górnej części formularza, a także rozmiar dołu formularza.

Atrybut	Opis	Przykład wartość wzorzec
MinimumSize	Określa minimalny rozmiar (szerokość, wysokość) kontrolki.Gdy kontener kontrolki jest mniejszy niż ta, są wyświetlane paski przewijania poziomie i w pionie.	(100,100)
Margin	Określa w pikselach ilość miejsca wokół formantu oraz między kontrolki 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 dodawanie pól w dwóch miejscach na formularzu

Dla każdego formantu formularza, można określić opcjonalną etykietę i położenie etykiety przy użyciu Label i LabelPosition atrybutów.Etykieta 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żywane przy członka zespołu uruchamia kwerendę do wyszukiwania elementów roboczych.Rozmiar maksymalny etykiety jest 80 znaków.

[!UWAGA]

Należy zdefiniować tego samego położenia etykiety do wszystkich formantów, które są zdefiniowane w tej samej grupy.

Jeśli chcesz dodać pola w więcej niż jedno pole formularza, takich jak połączenia 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 w jeden z dwóch sposobów.W pierwszym metody, należy dodać READONLY element jako element podrzędny FIELD element FIELDS sekcji definicji typu.Przy użyciu READONLY element, można określić czy niektórych użytkowników można zmodyfikować pola.Jak pokazano w następującym przykładzie, tylko menedżerowie program można zmodyfikować pole podrzędne tytuł.

<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

Przy użyciu FieldControl wpisz numer pola i zwykłego tekstu do formularza.Ten atrybut służy również do dodania listami wyboru; pola, które są używane do wyświetlania nazwy osoby, takie jak pola przypisany do lub właściciela i liczba całkowita i liczb rzeczywistych.Kontrolka pole muszą 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 pola listy pobrania

Grupa kilku pól

Możesz kontrolować format numeru i maksymalna długość znaków, które można wprowadzić w polu tekstu lub liczb przy użyciu opcjonalne atrybuty, 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 jest używany do tworzenia grupy pól, który pojawi się na 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

Przy użyciu HTMLFieldControl typ, aby dodać pola, którego typ danych jest HTML.Formant ten zapewnia obsługę do wyświetlenia sformatowany tekst w kilku wierszach.

Pola HTML

Pola HTML wyświetlane na formularzu elementu pracy

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

Porada
Po dodaniu kilku HTMLFieldControl elementów w formularzu, który będzie skumulowany w pionie, należy określić MinimumSize atrybut dla każdego formantu pola.W ten sposób możesz upewnić podobne rozmiar wszystkich pól tekstowych.W przeciwnym razie ostatniego elementu kontrolki HTML jest tak zaprojektowany, aby wypełnić formularz i poprzednie elementy są wyświetlane wraz z mniejszych pól tekstowych.

Po dodaniu kilku HTMLFieldControl elementów w formularzu, który będzie skumulowany w pionie, należy określić MinimumSize atrybut dla każdego formantu pola.W ten sposób możesz upewnić podobne rozmiar wszystkich pól tekstowych.W przeciwnym razie ostatniego elementu kontrolki HTML jest tak zaprojektowany, aby wypełnić formularz i poprzednie elementy są wyświetlane wraz z mniejszych pól tekstowych.

Dodaj pola daty lub kalendarza

Przy użyciu DateTimeControl typ, aby umożliwić użytkownikom wybór kalendarza umożliwia wybranie daty dla DateTime pola.Za pomocą tego formantu, można szybko wybrać datę i godzinę dla pola.

Pole z formatem kalendarza = "Krótką"

Pole kalendarza

Na przykład można określić preferowaną datę lub daty przeglądu, która jest 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żesz kontrolować format DateTime pola przy użyciu opcjonalne atrybuty, 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 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 = "MMM dd, rrrr"roku"" Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: właściwości DateTimePicker.CustomFormat.

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 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 = "MMM dd, rrrr"roku""

Aby uzyskać więcej informacji, zobacz witrynę sieci Web firmy Microsoft: właściwości DateTimePicker.CustomFormat.

Dodaj pola dla obszaru i iterację ścieżki

Przy użyciu WorkItemClassificationControl typ, aby dodać pola, którego typ danych jest TreePath.Ten formant umożliwia obsługę wyświetlania pól ścieżkę obszaru i ścieżki iteracji w formacie hierarchicznym, zagnieżdżone drzewa.W drzewie wyświetlana hierarchiczna węzły czy można rozwinąć lub 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ć inny typ pola lub pole niestandardowe za pomocą tego formantu.

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