Controlar a exibição de campos de Item de trabalho

Artigo
08/01/2011

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 em seu formulário de item de trabalho. Para exibir esses campos, você deve especificar o correto CONTROL elemento Type atributo, as seguintes opções:

DateTimeControl: Usado para exibir campos de data formatada que têm um tipo de campo de DateTime.
FieldControl: Usado para exibir campos de textuais ou numéricos simples e listas de valores para campos que têm um tipo de campo de String, Identity, Integer, Double, e PlainText.
HtmlFieldControl: Usado para exibir o formato rich text, de várias linhas dos campos que têm um tipo de dados do campo de 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 outras Type controles, consulte os seguintes tópicos:

Neste tópico

Controlar o tamanho e a exibição de campos de dados
Rotular campos e adicionar campos em dois lugares no formulário
Tornando um campo somente leitura
A adição de texto sem formatação e o números de campos
Adicionando campos de texto de formatado
Adicionando campos de calendário ou de data
Adicionando campos para a área e os caminhos de iteração

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 estão descritos na tabela a seguir.

Observação
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. No entanto, 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 que você alocar para o campo maior em cada coluna determina a dimensão horizontal de um formulário. O número de campos que você especificar em um grupo vertical e o tamanho vertical, você pode alocar a cada campo determina o tamanho da parte superior do formulário e também o tamanho da parte inferior do formulário.

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. No entanto, 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 que você alocar para o campo maior em cada coluna determina a dimensão horizontal de um formulário. O número de campos que você especificar em um grupo vertical e o tamanho vertical, você pode alocar a cada campo determina 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, aparecem as barras de rolagem horizontais e verticais.	(100,100)
Margin	Especifica, em pixels, a quantidade de espaço ao redor do controle e entre o controle e seus vizinhos (esquerda, superior, direita, inferior).	(2,0,2,0)
Padding	Especifica, em pixels, a quantidade de espaço ao redor da borda externa do controle (esquerda, direita, de cima, de baixo).	(2,0,2,0)
Dock	Especifica o alinhamento do rótulo com o lado especificado do recipiente ou estica o campo para preencher o recipiente. Especifique uma seqüência de caracteres de um dos seguintes valores: Fill, Top, , Bottom, Left, e Right.	N/A

Rotular campos e adicionar campos em dois lugares no formulário

Para cada controle no formulário, você pode especificar um rótulo opcional e a posição do rótulo usando a Label e LabelPosition atributos. O rótulo pode especificar um nome diferente do nome amigável que é atribuído pelo FIELD elemento. Se você não especificar um rótulo, o nome amigável é usado. Entretanto, 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.

Observação
Você deve definir a mesma posição do rótulo 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 apenas o atributo identifica o controle como diferentes de outro controle que é adicionado ao formulário.

Tornando um campo somente leitura

Você pode marcar um campo como somente leitura em uma das duas maneiras. O primeiro método, você adiciona o READONLY elemento como um filho para o FIELD elemento a 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, os gerentes do programa podem modificar um campo de 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ê 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" />

Adicionando campos texto e número

Você pode usar o FieldControl Digite para adicionar texto sem formatação e os campos de número para um formulário. Este atributo também é usado para adicionar listas de opções; campos que são usados para exibir os nomes de pessoa, como, por exemplo, os campos atribuído a ou proprietário; e inteiro e os 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 texto sem formatação ou o estilo como um hiperlink. Para obter mais informações, consulte Fornecendo o texto de Ajuda, orientação do processo, conteúdo da Web e Links para páginas da Web em um formulário de Item de trabalho.

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

Grupo de vários campos

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

Atributo	Descrição
NumberFormat	Especifica os caracteres que podem ser inseridas no controle de campo. Os valores válidos são: WholeNumbers, SignedWholeNumbers, DecimalNumbers, and SignedDecimalNumbers.
MaxLength	Especifica o comprimento máximo de caracteres que você pode usar para um controle de campo.

O código a seguir lista a sintaxe que é 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>

Adicionando campos de texto de formatado

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

Campo de HTML

<>>HTML<>mostrado no trabalho de campo de> <>item><>>formulário

<Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.ReproSteps" Label="Repro Steps"
LabelPosition="Top" Dock="Left" 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 maneira, você pode fazer um tamanho semelhante as todas as caixas de texto. Caso contrário, o último elemento do controle HTML é dimensionado para preencher o formulário e os elementos anteriores aparecem junto com as caixas de texto menores.

Adicionando campos de calendário ou de data

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

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

Calendário <>campo>

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" Dock="Fill" Format="Short" />
<Control Type="DateTimeControl" FieldName="MyCompany.EnvironmentCR.PreferredStartTime"
Label="Preferred Start Time:" LabelPosition="Left" Dock="Fill" 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 de enum DateTimePickerFormat. Os valores válidos são: Custom, Long, Short, Time. Quando você especificar 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 = "Personalizado" CustomFormat = "MMM dd, 'do ano' aaaa" Para obter mais informações, consulte o site da Microsoft: A propriedade de DateTimePicker.CustomFormat.

Format

Especifica o formato do campo de data e hora que corresponde a um valor de enum DateTimePickerFormat. Os valores válidos são: Custom, Long, Short, Time.

Quando você especificar 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 = "Personalizado"

CustomFormat = "MMM dd, 'do ano' aaaa"

Para obter mais informações, consulte o site da Microsoft: A propriedade de DateTimePicker.CustomFormat.

Adicionando campos para a área e os caminhos de iteração

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

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

Observação
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 Criar e modificar áreas e iterações.