Especificar controles de formulários de itens de trabalho

Este tópico fornece uma referência rápida para oControlelemento, seus elementos filho e atributos. Para cada controle de campo ou de formulário que você deseja exibir em um formulário de item de trabalho, adicione um elemento Control.

Você pode personalizar um formulário de item de trabalho para exibir informações e ajudar sua equipe a usar corretamente o formulário. Você pode adicionar campos e controles de item de trabalho que permitem inserir e exibir os dados que você deseja acompanhar.

O elemento Control fornece nove valores para o atributo Type que você pode usar para adicionar campos ou exibir textos ou campos simples ou com hiperlinks. Além disso, você pode definir controles especiais para adicionar links e anexos, exibir conteúdo baseado na Web ou criar seu próprio controle e adicioná-lo a um formulário de item de trabalho.

Adicionar campos de item de trabalho

Quando você personaliza o formulário de item de trabalho, normalmente adiciona um subconjunto dos campos de item de trabalho que são definidos para o tipo de item de trabalho que deseja que apareça no formulário. As definições de campo controlam muitos aspectos de quais dados devem ser exibidos ou de quais dados você pode inserir no formulário. Para obter mais informações, consulteModificar ou adicionar um campo para dar suporte a consultas, relatórios e fluxos de trabalho.

Cada campo de item de trabalho é associado a um tipo de dados. Você pode usar as informações na tabela a seguir para determinar que tipo de campo é aceito por qual atributo Type do elemento Control. Use o atributo Label para especificar o texto que aparece ao lado do controle. Use o atributo LabelPosition relacionado para especificar onde o rótulo aparece em relação ao controle. Para obter mais informações, consulteControlar a exibição dos campos de item de trabalho.

Dica

Você não pode alterar os valores dos campos do sistema, que são atualizados automaticamente.Por exemplo, os campos Data da Criação e Criado por são definidos quando um item de trabalho é salvo pela primeira vez.No entanto, você pode usar esses campos em critérios de pesquisa.Para obter uma descrição de cada campo do sistema, consulteReferência de campo de item de trabalho do Visual Studio ALM.

Tipo de campo	Atributo Type do elemento Control	Uso
DateTime	FieldControl DateTimeControl	Use FieldControl para fornecer um campo de texto para a entrada ou a exibição de um campo de tipo de dados DateTime. <Control FieldName=" MyCompany.Group1.StartDate " Type="FieldControl" Label="Start Date" LabelPosition="Left" /> Use DateTimeControl para fornecer um seletor de calendário para selecionar uma data para um campo, conforme mostrado na ilustração a seguir. <Control Type="DateTimeControl" FieldName="MyCompany.Group.ScheduleStart" Label="Scheduling Start Date:" LabelPosition="Left" Dock="Fill" Format="Short" />
Double	FieldControl	Use FieldControl para fornecer um campo de texto para a entrada ou a exibição de campos Double. <Control FieldName="ABC_Company.Statistics.Analysis" Type="FieldControl" Label="Analysis %" LabelPosition="Left" />
History	WorkItemLogControl	Você usa WorkItemLogControl para fornecer um campo de controle para os campos de histórico que acompanham threads de discussão e outras informações históricas, conforme mostrado na ilustração a seguir. Você pode usar esse controle para oferecer suporte somente à exibição do campo histórico de um item de trabalho, o campo de item de trabalho System.History. Usando esse controle, você pode expandir e recolher detalhes sobre revisões históricas de um item de trabalho. Você também pode formatar o texto adicionado ao campo de histórico. <Control Type="WorkItemLogControl" FieldName="System.History" Label="Detailed Description and History" LabelPosition="Top" Dock="Fill" />
HTML	HTMLControl	Use HTMLControl para fornecer um campo de controle que permita que campos HTML capturem a formatação RTF, conforme mostrado na ilustração a seguir. <Control Type="HtmlFieldControl" FieldName="Microsoft.VSTS.Notes" Label="Notes" Dock="Fill" />
Integer	FieldControl	Use FieldControl para fornecer um campo de controle para um campo Integer. <Control FieldName="System.Id" Type="FieldControl" Label="Id" LabelPosition="Left" />
PlainText	FieldControl	Use FieldControl para fornecer um campo de controle para um campo PlainText, como uma caixa de texto que contém descrições que podem conter mais de 255 caracteres. <Control FieldName="Microsoft.VSTS.DocName" Type="FieldControl" Label="Vision Doc Location" LabelPosition="Left" />
String	FieldControl	Use FieldControl para fornecer um campo de controle para um campo String. Os campos String são limitados a 255 caracteres. <Control FieldName="System.Title" Type="FieldControl" Label="Title" LabelPosition="Left" />
TreePath	WorkItemClassificationControl	Use WorkItemClassificationControl para fornecer um campo de controle para um campo TreePath. <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area Path" LabelPosition="Left" />

Atributos opcionais de campo do elemento de controle para qualquer tipo de controle

Os seguintes atributos opcionais podem ser especificados somente para os tipos de controle que são listados.

Atributo	Descrição
Field	Especifica o controle associado ao campo do item de trabalho.
Label	Especifica o texto visível no formulário que identifica o controle. Especifique uma cadeia de caracteres de no máximo 80 caracteres. Dica Você pode anexar um hiperlink ao rótulo de um campo que é adicionado ao formulário de item de trabalho usando FieldControl.Esse controle é útil para fornecer um link para informações sobre como o campo é usado.Para obter mais informações, consulteFornecer texto da ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalho.
LabelPosition	Especifica a posição do rótulo em relação aos dados de controle. Especifique uma cadeia de caracteres de um dos seguintes valores: Top, Bottom, Left e Right.
Dock	Especifica o alinhamento do rótulo com o lado especificado do contêiner ou alonga o campo para preencher o contêiner. Especifique uma cadeia de caracteres de um dos seguintes valores: Fill, Top, Bottom, Left e Right.
Padding	Especifica a quantidade de espaço, em pixels, ao redor da borda interna do controle. Quatro valores são fornecidos e correspondem às partes superior, inferior, esquerda e direita. Por exemplo: (2,0,2,0).
Margin	Especifica a quantidade de espaço, em pixels, ao redor da borda externa do controle. Quatro valores são fornecidos e correspondem às partes superior, inferior, esquerda e direita. Por exemplo: (2,0,2,0).
ReadOnly	Especifica que o campo é somente leitura. Especifique True ou False.
MinimumSize	Especifica o tamanho mínimo, em pixels, que o controle deve ocupar no formulário. Dois valores que correspondem à largura e altura são especificados. Por exemplo: (100,100).
Name	Identifica um controle exclusivamente. O atributo Name é necessário quando mais de um controle no formulário é associado ao mesmo campo de item de trabalho. Dica Você usa o atributo Name para exibir o mesmo campo em mais de uma área no formulário.Você especifica um valor exclusivo para o atributo Name para ambas as entradas de controle para que o sistema identifique exclusivamente cada controle.É útil mostrar o mesmo controle em vários locais com base no contexto das guias.

Atributos opcionais de campo do elemento de controle para tipos de controle específicos

Os seguintes atributos opcionais podem ser especificados somente para os tipos de controle que são listados.

Atributo	Tipos de controle	Descrição
NumberFormat	FieldControl	Especifica os caracteres que você pode inserir no controle de campo. Os seguintes valores são válidos: WholeNumbers, SignedWholeNumbers, DecimalNumbers e SignedDecimalNumbers.
MaxLength	FieldControl	Especifica o número máximo de caracteres que você pode usar para um controle de campo.
Format	DateTimeControl	Especifica o formato do campo de data e hora que corresponde a um valor do enum DateTimePickerFormat. Os seguintes valores são válidos: Custom, Long, Short, Time.
CustomFormat	DateTimeControl	Especifica o formato personalizado que é usado para o campo de data e hora que corresponde à sintaxe definida para a propriedade DateTimePicker.CustomFormat.

Adicionar controles especiais

A tabela a seguir descreve os atributos Control do elemento Type que fornecem suporte para que você possa gerenciar os anexos de arquivos, criar links, exibir conteúdo baseado na Web e exibir outros dados que não estejam associados a um campo de item de trabalho.

Atributo Type do elemento Control	Uso
AttachmentsControl	Use para anexar arquivos a um formulário de item de trabalho. Esse controle geralmente está contido em seu próprio grupo de guias, conforme mostrado na ilustração a seguir. Controle Attachments Para obter mais informações, consulteAdicionar o controle Anexos.
LabelControl	Use para exibir texto sem formatação ou com hiperlink que não esteja associado a um campo, conforme mostrado na ilustração a seguir. Você usa os elementos LabelText e Link filho e de contêiner para especificar o texto, o hiperlink e a posição de um campo ou de um rótulo cujo texto está associado parcialmente a um hiperlink. Para obter mais informações, consulteFornecer texto da ajuda, hiperlinks ou conteúdo da Web em um formulário de item de trabalhoReferência de elementos XML LabelText e TexteReferência de elementos XML Link e Param.
LinksControl	Use para criar e gerenciar links entre itens de trabalho. Esse controle geralmente está contido em seu próprio grupo de guias, conforme mostrado na ilustração a seguir. Você usa LinksControlOptions para definir os filtros de link e o layout dos campos de coluna que são usados para exibir a lista de links. Para obter mais informações, consulteDefinir controles de link para restringir as relações de linkeElementos LinksControlOptions.
StoryboardsControl	Usado para abrir o PowerPoint Storyboarding de um item de trabalho e o link para arquivos de Storyboard salvos em um compartilhamento de rede. Esse controle geralmente está contido em seu próprio grupo de guias, conforme mostrado na ilustração a seguir. Para adicionar oStoryboardsControlpara oFORMseção, adicione o seguinte trecho de código: <Tab Label="Storyboards">    <Control Name="StoryboardsControl" Type="LinksControl">       <LinksControlOptions>          <WorkItemLinkFilters FilterType="excludeAll" />          <ExternalLinkFilters FilterType="include">             <Filter LinkType="Storyboard" />          </ExternalLinkFilters>          <LinkColumns>             <LinkColumn RefName="System.Title" />             <LinkColumn LinkAttribute="System.Links.Comment" />          </LinkColumns>       </LinksControlOptions>    </Control> </Tab>
WebpageControl	Use para exibir conteúdo da Web em um formulário de item de trabalho. Esse controle geralmente está contido em seu próprio grupo de guias. Você usa os elementos WebpageControlOptions e Link filho para especificar os controles que são necessários para carregar o destino da página da Web no formulário de item de trabalho. Para obter mais informações, consulteEditar uma definição de WIT para adicionar conteúdo da Web a um formulário de item de trabalhoReferência de elementos XML WebpageControlOptionseReferência de elementos XML Link e Param.

Adicionar controles personalizados

Além dos controles internos, você pode adicionar seu próprio controle personalizado a um formulário de item de trabalho.

Por exemplo, você poderia adicionar um controle personalizado para tirar uma captura de tela da Área de Transferência. Ou você pode fornecer um controle para capturar vários valores adicionando uma caixa de seleção para os valores que são apresentados em uma lista ou em um menu.

Para implementar um controle personalizadovocê deve especificar o nome do controle para oTypeatributo.

Consulte também

Tarefas

Alterar o layout do formulário de item de trabalho

Editar uma definição de WIT para adicionar conteúdo da Web a um formulário de item de trabalho

Referência

Referência do elemento XML de controle