Controlar a exibição dos campos de item de trabalho

Você pode controlar o nome de rótulo, posição, tamanho da caixa de texto e outros controles de exibição de texto sem formatação, inteiro, número, data e campos de item de trabalho de caminho de árvore no seu formulário de item de trabalho. Para exibir esses campos, você deve especificar o correto Control elemento Type atributo, dentre as seguintes opções:

• DateTimeControl: Usado para exibir os campos de data formatada com um tipo de campo de 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: Usado para exibir o formato rich text combinado de campos que têm um tipo de dados do campo HTML.

• WorkItemClassificationControlUsado para exibir os campos de caminho hierárquico que têm um tipo de campo de TreePath.

Para obter mais informações sobre outros Type controles, consulte os seguintes tópicos:

• Especificar controles de formulários de itens de trabalho

• Fornecer texto da ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalho

• Definir controles de link para restringir as relações de link

• Adicionar o controle Anexos

Neste tópico

• Controlar o tamanho e a exibição de campos de dados

• Campos de rótulo e adicionar campos em dois lugares no formulário

• Tornar um campo somente leitura

• Adicionar texto sem formatação e campos de número

• Adicionar campos de texto formatado

• Adicionar campos de data ou calendário

• Adicionar campos para caminhos de iteração e área

Controlar o tamanho e a exibição de campos de dados

Você pode controlar o espaçamento e o tamanho de cada campo de dados usando os atributos opcionais que são descritos na tabela a seguir.

Dica

O tamanho total de cada campo de entrada de dados é determinado por vários fatores: os atributos que são atribuídos ao campo, o tamanho do contêiner e a área alocada para outros campos no formulário.Valores padrão são atribuídos aos campos, quando você não especificar um tamanho mínimo.Entretanto, os atributos que são atribuídos a outros campos no formulário podem afetar o tamanho dos campos.O número de colunas e o tamanho horizontal alocar ao campo maior em cada coluna determina a dimensão horizontal de um formulário.O número de campos que você especifica em um grupo vertical e o tamanho vertical é alocar a cada campo de determinar o tamanho da parte superior do formulário e também o tamanho da parte inferior do formulário.

Atributo	Descrição	Exemplo de valor padrão
MinimumSize	Especifica o tamanho mínimo (largura, altura) para o controle. Quando o contêiner para o controle é menor do que esse tamanho, barras de rolagem horizontais e verticais são exibidos.	(100,100)
Margin	Especifica a quantidade de espaço em torno do controle e entre o controle e seus vizinhos (superior, inferior, esquerda, direita) em pixels.	(2,0,2,0)
Padding	Especifica, em pixels, a quantidade de espaço ao redor da borda externa do controle (superior, inferior, esquerda, direita).	(2,0,2,0)

Campos de rótulo e adicionar campos em dois lugares no formulário

Para cada controle de formulário, você pode especificar um rótulo opcional e a posição do rótulo usando o Label e LabelPosition atributos. O rótulo pode especificar um nome diferente do nome amigável atribuído pelo FIELD elemento. Se você não especificar um rótulo, o nome amigável será usado. No entanto, observe que o nome amigável sempre é usado quando um membro da equipe executa uma consulta para procurar itens de trabalho. O tamanho máximo do rótulo é 80 caracteres.

Dica

Você deve definir a posição do rótulo mesmo para todos os controles que são definidos no mesmo grupo.

Se você deseja adicionar o campo em mais de uma área do formulário, como na parte superior do formulário e em uma guia, você pode fazer isso usando o Name atributo. O Name atributo identifica apenas o controle diferentes de outro controle que é adicionado ao formulário.

Tornar um campo somente leitura

Você pode marcar um campo como somente leitura em uma das duas maneiras. O primeiro método, você adicionará o READONLY elemento como um filho para o FIELD elemento o FIELDS seção da definição de tipo. Usando o READONLY elemento, você pode especificar se determinados usuários podem modificar o campo. Conforme mostrado no exemplo a seguir, gerentes de programa só podem modificar um campo de título e subtítulo.

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

O segundo método, você deve especificar o ReadOnly atributo para o CONTROL elemento. Nesse método, todos os usuários são impedidos de modificar o campo.

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

Adicionar texto e campos de número

Você usa o FieldControl digite para adicionar texto sem formatação e campos de número para um formulário. Esse atributo também é usado para adicionar listas de opções; campos que são usados para exibir nomes de pessoas, como os campos atribuído a ou proprietário; e inteiro e números reais. O controle de campo deve se referir a um campo por seu nome de referência. O rótulo do campo pode ser um texto sem formatação ou o estilo como um hiperlink. Para obter mais informações, consulte Fornecer texto da ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalho.

Texto, inteiro e campos da lista de opções

Você pode controlar o formato dos campos de número e o tamanho máximo de caracteres que podem ser inseridos em um texto ou um campo de número usando os atributos opcionais que são descritos na tabela a seguir.

Atributo	Descrição
NumberFormat	Especifica os caracteres que você pode inserir no controle de campo. Os valores válidos são da seguinte maneira: WholeNumbers, SignedWholeNumbers, DecimalNumbers, e SignedDecimalNumbers.
MaxLength	Especifica o número máximo de caracteres que você pode usar para um controle de campo.

O código a seguir lista a sintaxe usada para criar o grupo de campos que aparece na ilustração anterior.

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

Adicionar campos de texto formatado

Você usa o HTMLFieldControl tipo para adicionar campos cujo tipo de dados é HTML. Esse controle oferece suporte para exibir texto formatado em várias linhas.

Campo HTML

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

Dica

Quando você adiciona várias HTMLFieldControl elementos em um formulário que serão empilhados verticalmente, você deve especificar o MinimumSize atributo para cada controle de campo.Dessa forma, você pode fazer um tamanho semelhante as todas as caixas de texto.Caso contrário, o último elemento de controle HTML é dimensionado para preencher o formulário e os elementos anteriores aparecem com caixas de texto menores.

Adicionar campos de data ou calendário

Você usa o DateTimeControl tipo para fornecer aos usuários um seletor de calendário para selecionar uma data para um DateTime campo. Usando esse controle, você pode selecionar rapidamente uma data e hora para o campo.

Campo com o formato de calendário = "Pequena"

Por exemplo, você pode especificar uma data de início preferencial ou uma data de revisão está no futuro.

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

Você pode controlar o formato do DateTime campo usando os atributos opcionais que são descritos na tabela a seguir.

Atributo	Descrição
Format	Especifica o formato do campo de data e hora que corresponde a um valor do enum DateTimePickerFormat. Os valores válidos são da seguinte maneira: Custom, Long, Short, Time. Quando você especifica Custom, você também deve definir o CustomFormat atributo.
CustomFormat	Especifica o formato personalizado que é usado para o campo de data e hora que corresponde à sintaxe definida para a propriedade DateTimePicker.CustomFormat. Por exemplo: Formato = "Custom" CustomFormat = "MMM dd, yyyy 'do ano'" Para obter mais informações, consulte o site da Microsoft: propriedade CustomFormat.

Adicionar campos para caminhos de iteração e área

Você usa o WorkItemClassificationControl tipo para adicionar campos cujo tipo de dados é TreePath. Esse controle oferece suporte para exibir campos de caminho de área e iteração caminho em formato de árvore hierárquica, aninhado. A árvore mostra nós hierárquicos que você pode expandir e recolher.

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

Dica

Você pode usar o WorkItemClassificationControl para exibir o System.AreaPath e System.IterationPath campos.Você não pode exibir qualquer outro tipo de campo ou campos personalizados usando esse controle.

Para obter mais informações, consulte Adicionar e modificar área e caminhos de iteração.

Consulte também

Conceitos

Adicionar ou modificar campos de itens de trabalho para oferecer suporte a relatórios

Adicionar o controle Anexos

Definir controles de link para restringir as relações de link

Outros recursos

Fornecer texto da ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalho