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

Artigo
02/25/2013

Você pode controlar o nome da rótulo , posição, tamanho da caixa de textoe 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 trabalho itemformulário. Para exibir esses campos, você deve especificar o correto Control elemento Type atributo, entre 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 várias linhas, rich-text formato dos campos que têm um campotipo de dados 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 os campos de número
Adicionando campos de texto de formatado
Adicionando campos de calendário ou 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 cadacampo de entradade dados é determinado por vários fatores: os atributos que são atribuídos ao campo, o tamanho do contêinere a área alocada para outros campos no formulário. Valores padrão são atribuídos aos campos quando você não especifica 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 de vertical e o tamanho vertical que você 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 cadacampo de entradade dados é determinado por vários fatores: os atributos que são atribuídos ao campo, o tamanho do contêinere a área alocada para outros campos no formulário. Valores padrão são atribuídos aos campos quando você não especifica 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 de vertical e o tamanho vertical que você 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 for menor 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 contêinerou estica o campo para preencher o contêiner.Especificar 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 de 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 por itens de trabalho.O tamanho máximo de 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 atributo apenas identifica o controle 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 de definição de tipo.Usando o READONLY elemento, você pode especificar se a determinados usuários podem modificar o campo.Conforme mostrado no exemplo a seguir, somente os gerentes de programa podem modificar um campodo 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 campos texto sem formatação e número a um formulário.Esse atributo também é usado para adicionar listas de opções; campos que são usados para exibir os 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.Orótulo do campopode ser texto sem formatação ou o estilo como um hiperlink. Para mais informações, consulte Fornecer texto da Ajuda, diretrizes de processo, conteúdo da Web e links para páginas da Web em um formulário de item de trabalho.

Texto, número 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 campo controle.Valid values are as follows: 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 é usado 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.

HTML Campo

Campo HTML exibido no formulário de item de trabalho

<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árioe os elementos anteriores aparecem junto com as caixas de texto menores.

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árioe os elementos anteriores aparecem junto com as caixas de texto menores.

Adicionando campos de calendário ou data

Você pode usar o DateTimeControl tipo para fornecer 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"

Campo do calendário

Por exemplo, você pode especificar uma data de início preferencial ou uma data de revisão que 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 da DateTime campo usando os atributos opcionais que estã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.Valid values are as follows: 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 propriedadedo DateTimePicker.CustomFormat.Por exemplo: Formato = "Personalizado" CustomFormat = "Dd MMM, aaaa 'do ano'" Para obter mais informações, consulte o site da Microsoft Web : DateTimePicker.CustomFormat propriedade.

Format

Especifica o formato do campo de data e hora que corresponde a um valor de enum DateTimePickerFormat.Valid values are as follows: 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 propriedadedo DateTimePicker.CustomFormat.Por exemplo:

Formato = "Personalizado"

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

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

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 formato de árvore de hierárquicas e 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 campo de personalizado usando esse controle.

Para mais informações, consulte Criar e modificar áreas e iterações.