Especificar controles de formulário de item de trabalho
Você pode usar as informações que é fornecida neste tópico como uma referência rápida para o elemento de Control , a seus elementos filho, e a atributos.Para cada controle ou do campo de formulário que você deseja exibir em um formulário de item de trabalho, você adiciona um elemento de Control .Você pode personalizar um formulário de item de trabalho para exibir informações para ajudar sua equipe usar corretamente ao formulário.Você pode adicionar campos e os controles de item de trabalho que permitem que você inserir e exibir os dados que você deseja controlar.O elemento de Control nove fornece valores para o atributo de Type que você pode usar para adicionar campos ou o para exibir claramente ou texto ou campos hyperlinked.Além disso, você pode definir controles especiais para adicionar links e anexos, para exibir o conteúdo baseado na web, ou criar seu próprio controle e adicioná-los a um formulário de item de trabalho.
Neste tópico
Adicionando campos de item de trabalho a um formulário de item de trabalho
Adicionando controles especiais a um formulário de item de trabalho
Adicionar controles personalizados a um formulário de item de trabalho
Adicionando campos de item de trabalho a um formulário de item de trabalho
Quando você personaliza o formulário de item de trabalho, você normalmente adiciona um subconjunto dos campos de item de trabalho que são definidos para o tipo de item de trabalho que você deseja que apareça no formulário.As definições de campo controlam muitos aspectos de que exibe de dados ou que os dados que você pode inserir no formulário.Para obter mais informações, consulte Definir campos de item de trabalho.
Cada campo de item de trabalho é associado com um tipo de dados.Você pode usar as informações na tabela a seguir para determinar que tipo de campo é suportado por que Type atributo do elemento de Control .Use o atributo de Label para especificar o texto que aparece ao lado do controle.Use o atributo relacionado de LabelPosition para especificar onde o rótulo aparece em relação ao controle.Para obter mais informações, consulte Controlar a exibição dos campos de item de trabalho.
.gif "Observação") Observação |
|---|
Você não pode alterar os valores dos campos do sistema, que são atualizados automaticamente.Por exemplo, a data criada e criado por campos é definida quando um item de trabalho é primeiro salva.No entanto, você pode usar esses campos em critérios de pesquisa.Para obter uma descrição de cada campo do sistema, consulte Referência de campos de item de trabalho para o Visual Studio ALM. |
Tipo de campo |
Atributo de tipo de elemento de controle |
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 de DateTime. Use DateTimeControl para fornecer um selecionador de calendário para selecionar uma data para um campo, conforme mostrado na ilustração a seguir. .png "Campo do calendário")
|
Double |
FieldControl |
Use FieldControl para fornecer um campo de texto para a entrada ou a exibição de campos duplas. |
History |
WorkItemLogControl |
Você usa WorkItemLogControl para fornecer um campo de controle para os campos histórico que acompanham segmentos de notícias e outras informações históricas, conforme mostrado na ilustração a seguir. .png "Guia Histórico e o campo no formulário de item de trabalho")
Você pode usar esse controle para suporte somente a exibição do campo histórico de um item de trabalho, o campo de item de trabalho de System.History.Usando o controle, você pode expandir e recolher detalhes sobre revisões históricas a um item de trabalho.Você também pode formatar o texto que você adiciona ao campo histórico. |
HTML |
HTMLControl |
Use HTMLControl para fornecer um campo de controle que permitem campos HTML para capturar a formatação de rico- texto, conforme mostrado na ilustração a seguir. .png "Campo HTML exibido no formulário de item de trabalho")
|
Integer |
FieldControl |
Use FieldControl para fornecer um campo de controle para um campo inteiro. |
PlainText |
FieldControl |
Use FieldControl para fornecer um campo de controle para um campo de texto não criptografado, como uma caixa de texto que contém descrições que podem ser mais de 255 caracteres. |
String |
FieldControl |
Use FieldControl para fornecer um campo de controle para um campo de cadeia de caracteres.Os campos de cadeia de caracteres está limitado a 255 caracteres. |
TreePath |
WorkItemClassificationControl |
Use WorkItemClassificationControl para fornecer um campo de controle para um campo de TreePath. |
.gif "ms194985.collapse_all(pt-br,VS.110).gif")
Atributos de campo opcionais do elemento de controle para todos os tipos 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 que está associado com o campo de item de trabalho. |
Label |
Especifica o texto visível no formulário que identifica o controle.Especifique uma cadeia de caracteres de não mais de 80 caracteres. Observação
Você pode anexar um hiperlink no 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, 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.
|
LabelPosition |
Especifica a posição do rótulo que é relativo a 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 do contêiner especificado, o campo ou expande para preencher o recipiente.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, da borda ao redor de dentro do controle.Quatro valores são fornecidas que corresponder à parte superior, inferior, esquerda, e direita.Por exemplo: (2,0,2,0). |
Margin |
Especifica a quantidade de espaço, em pixels, da borda ao redor de fora do controle.Quatro valores são fornecidas que corresponder à parte superior, inferior, esquerda, e direita.Por exemplo: (2,0,2,0). |
ReadOnly |
Especifica que o campo é somente leitura.Especificar True ou False. |
MinimumSize |
Especifica o tamanho mínimo, em pixels, que o controle deve ocupar no formulário.Dois valores que são especificados correspondem à largura e altura.Por exemplo: (100.100). |
Name |
Identifica um controle.O atributo de Name é necessário se mais de um controle no formulário é associado com o mesmo campo de item de trabalho. Observação
Você usa o atributo de Name para exibir o mesmo campo em mais de uma área no formulário.Você especifica um valor exclusivo para o atributo de Name para ambas as entradas do controle para que o sistema identifica exclusivamente cada controle.É útil mostrar o mesmo controle em vários locais baseados no contexto de guias.
|
Atributos de campo opcionais do elemento de controle para tipos específicos de controle
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 ao controle do campo.Os seguintes valores são válidas: WholeNumbers, SignedWholeNumbers, DecimalNumbers, e SignedDecimalNumbers. |
MaxLength |
FieldControl |
Especifica o comprimento máximo de caracteres que você pode usar para um controle do campo. |
Format |
DateTimeControl |
Especifica o formato para o campo de data/hora que corresponde a um valor enum de DateTimePickerFormat.Os seguintes valores são válidas: Custom, Long, Short, Time. |
CustomFormat |
DateTimeControl |
Especifica o formato personalizado que é usado para o campo de data/hora que corresponde à sintaxe que é definida para a propriedade de DateTimePicker.CustomFormat. |
Adicionando controles especiais a um formulário de item de trabalho
A tabela a seguir descreve os atributos de Type do elemento de Control que fornecem suporte para que você pode gerenciar os anexos de arquivos, criar links, exibir o conteúdo baseado na web, e exibir outros dados que não estejam associados a um campo de item de trabalho.
Atributo de tipo de elemento de controle |
Uso |
|---|---|
AttachmentsControl |
O uso anexar arquivos a um item de trabalho forma.Esse controle é geralmente contido em seu próprio grupo da, conforme mostrado na ilustração a seguir.
Controle de anexos
.png "Exemplo de controle de anexos")
Para obter mais informações, consulte Adicionar o controle de anexos. |
LabelControl |
Uso exibir claramente ou texto hyperlinked que não está associado a um campo, conforme mostrado na ilustração a seguir. .png "Exemplo de dois hiperlinks aplicados ao texto")
Você usa os elementos de LabelText e filho e do contêiner de Link para especificar o texto, o hiperlink, e a posição de um campo ou de um rótulo cujo texto em parte está associado com um hiperlink.Para obter 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, Referência de elementos XML LabelText e texto, e Referência de elementos XML link e Param. |
LinksControl |
Uso criar e gerenciar links entre itens de trabalho.Esse controle é geralmente contido em seu próprio grupo da, conforme mostrado na ilustração a seguir. .png "Exemplo de controle de links adicionado a um formulário de item de trabalho")
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, consulte Definir controles de link para restringir as relações de link e Elementos de LinksControlOptions. |
WebpageControl |
Uso exibir conteúdo da web em um formulário de item de trabalho.Esse controle é geralmente contido em seu próprio grupo de tabulação.Você usa elementos filho de WebpageControlOptions e de Link 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, consulte Adicionar conteúdo da Web a um formulário de item de trabalho, Referência de elementos XML WebpageControlOptions, e Referência de elementos XML link e Param. |
Adicionar controles personalizados a um formulário de item de trabalho
Além dos controles internos, você pode adicionar seu próprio controle personalizado a um formulário de item de trabalho.
Por exemplo, você pode adicionar um controle personalizado para capturar uma tela da área de transferência.Ou você pode fornecer um controle para vários valores de captura adicionando uma caixa de seleção para valores que são apresentados em uma lista ou em um menu.
Para implementar um controle personalizado, você deve especificar o nome do controle para o atributo de Type .Para obter mais informações, consulte o site da Microsoft: Item de trabalho que acompanha controles personalizados.
Consulte também
Tarefas
Adicionar e personalizar um tipo de Item de trabalho
Alterar o layout do formulário de item de trabalho
Referência
Referência de elemento do controle XML
Conceitos
Criar e personalizar um formulário de item de trabalho
Outros recursos
Adicionar conteúdo da Web a um formulário de item de trabalho