Compartilhar via


Referência de elemento do controle XML

Você pode usar o Control elemento para definir um campo item de trabalho, texto, hiperlink ou outro elemento de controle para exibir em um formulário de item de trabalho.Para obter exemplos de como usar esse elemento, consulte Especificar controles de formulário de item de trabalho.Para mais informações, consulte Criar e personalizar um formulário de item de trabalho.

Hierarquia do esquema

WITD

   WORKITEMTYPE

       FORMULÁRIO

           Layout

               Group

               Coluna

               Tab

<xs:element name="Control" type="ControlType" minOccurs="0"/>

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" ControlFontSize="FontSize" EmptyText="TextString"
Label="LabelText" LabelPosition="Top | Bottom | Left | Right" 
Dock="Fill | Top | Bottom | Left | Right" Padding="(left, top, right, bottom)" 
Margin="(left, top, right, bottom)" ReadOnly="True | False" MinimumSize="(width,height)" 
Name="InstanceName" >
<LabelText> . . . </LabelText>
<Link> . . . </Link>
<LinksControlOptions> . . . </LinksControlOptions>
<WebpageControlOptions> . . . </WebpageControlOptions>
</Control>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo

Descrição

FieldName

Opcional Control atributo.

Especifica o campo de item de trabalho ao qual o controle está associado.O tipo de atributo é typelib:ReferenceFieldName.Comprimento mínimo: 1; comprimento máximo: 70.

Valor de padrão: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9 _] +) +$

Exemplo de valor padrão: Company.Division.IssueType

Type

Obrigatório Control atributo.

Especifica o tipo de dados do controle.O tipo de atributo é ValidControlsType tipo simples.Especifique uma seqüência de um dos seguintes tipos internos:

  • AttachmentControl: Use para exibir anexos de item de trabalho.Este controle não tem um campo associado ou tipo de campo.

  • DateTimeControl: Use para exibir os campos de data formatada com um tipo de campo de DateTime.

  • FieldControl: Use para exibir campos textuais ou numéricos simples e listas de valores para campos com um tipo de campo de String, Identity, Integer, Double, e PlainText.

  • HtmlFieldControl: Use para exibir várias linhas, rich-text format de campos com um tipo de campo de HTML.

  • LabelControl: Use para exibir o texto não está associado um campo.O texto pode ser simples ou hiperlink.Você pode especificar que controles adicionais usando o LabelText, Link e Text elementos.Consulte Referência de elementos XML LabelText e texto e Referência de elementos XML link e Param.

  • LinksControl: Use para exibir a barra de ferramentas de controle de links e gerenciar relações de vínculo entre itens de trabalho e storyboards.Este controle não tem um campo associado ou tipo de campo.Especificar os tipos de links para filtrar e outras opções de controle usando o LinksControlOptions elemento.Consulte Elementos de LinksControlOptions.

  • WebpageControl: Use para exibir conteúdo em HTML definido por um URI ou incorporado dentro de uma tag CDATA.Este controle não tem um campo associado ou tipo de campo..Especifique o conteúdo e links para exibir usando o WebpageControlOptions elemento.Consulte Referência de elementos XML WebpageControlOptions.

  • WorkItemClassificationControlUse para exibir os campos de caminho hierárquico com um tipo de campo de TreePath.

    ObservaçãoObservação
    O System.AreaPath e System.IterationPath campos são os únicos campos que usam esse tipo de dados.Não é possível definir um campo personalizado usando esse tipo de dados.
  • WorkItemLogControl: Use para exibir informações de histórico de item de trabalho e campos com um tipo de campo de History.

    ObservaçãoObservação
    O System.History campo é o único campo que usa esse tipo de dados.Não é possível definir um campo personalizado usando esse tipo de dados.

Para mais informações, consulte Especificar controles de formulário de item de trabalho.

ObservaçãoObservação
Você pode usar um controle personalizado, definindo a Type de atributo para um valor personalizado.Qualquer controle cuja Type valor não corresponde ao nome de uma interna tipo é considerado um controle personalizado.Para obter mais informações, consulte o site da Microsoft: Trabalho Item rastreamento personalizado controles.

ControlFontSize

Opcional Control atributo.

Especifica o tamanho da fonte do rótulo ou nome do campo no formulário.Valid values of FontSize: small, normal, large, xlarge, and xxlarge.

EmptyText

Opcional Control atributo.

Especifica uma seqüência de texto entre 1 e 255 caracteres de comprimento que aparece quando um campo está vazio.

Label

Opcional Control atributo.

Especifica o texto visível no formulário que identifica o controle.Especifique uma seqüência de caracteres não mais de 80.

LabelFontSize

Especifica o tamanho da fonte do rótulo no formulário.Valid values for FontSize: small, normal, large, xlarge, and xxlarge.

LabelPosition

Opcional Control atributo.

Especifica a posição do rótulo em relação aos dados de controle.Especifique uma seqüência de um dos seguintes valores:

  • Top: Coloca o rótulo acima os dados de controle.

  • Bottom: Coloca o rótulo abaixo os dados de controle.

  • Left: Coloca o rótulo à esquerda dos dados de controle.

  • Right: Coloca o rótulo à direita dos dados de controle.

Dock

Opcional Control atributo.

Alinha o campo com o lado especificado do contêiner ou estica o campo para preencher o contêiner.O tipo de atributo é DockType.Especifique uma seqüência de um dos seguintes valores:

  • Fill: Alinha o campo para que ele preenche o recipiente.Este valor não é uma orientação com suporte para o Splitter elemento.

  • Top: Alinha o campo junto com a parte superior do recipiente.Este valor não é uma orientação com suporte para o Splitter elemento.

  • Bottom: Alinha o campo junto com a parte inferior do recipiente.Este valor não é uma orientação com suporte para o Splitter elemento.

  • Left: Alinha o campo com o lado esquerdo do recipiente.

  • Right: Alinha o campo com o lado direito do recipiente.Este valor não é uma orientação com suporte para o Splitter elemento.

Padding

Opcional Control atributo.

Especifica a quantidade de espaço em pixels ao redor o interior borda do controle que corresponde à parte superior, inferior, esquerda e espaços à direita.O tipo de atributo é SizeType.

Valor de padrão: ^ \(\d+\,\d+\,\d+\,\d+\)$

Exemplo de valor padrão: (2,0,2,0)

Margin

Opcional Control atributo.

Especifica a quantidade de espaço em pixels ao redor da borda externa do controle que corresponde à parte superior, inferior, esquerda e espaços à direita.O tipo de atributo é SizeType.

Valor de padrão: ^ \(\d+\,\d+\,\d+\,\d+\)$

Exemplo de valor padrão: (2,0,2,0)

ReadOnly

Opcional Control atributo.

Especifica que o campo é somente leitura.O tipo de atributo é ReadOnlyType.Especifique uma seqüência de um dos seguintes valores:

  • True: Especifica que os dados de controle serão somente leitura.

  • False: Especifica que os dados do controle não não somente leitura.

MinimumSize

Opcional Control atributo.

Especifica o tamanho mínimo em pixels que o controle deve ocupar no formulário.A sintaxe é especificada no (width,height).O tipo de atributo é SizeType.

Valor de padrão: ^ \(\d+\,\d+\)$

Exemplo de valor padrão: (100,100)

ObservaçãoObservação
Se você não tem suficiente espaço vertical, aparece uma barra de rolagem para manter seu tamanho mínimo.Sem esse atributo, os controles são desenhados com seus tamanhos padrão, a menos que controles em outras guias levar mais espaço.O tamanho total de qualquer controle em um formulário depende do tamanho da maior área de formulário ou guia.

Name

Opcional Control atributo.

Identifica exclusivamente um controle.O Name é importante se mais de um controle no formulário está associado com o mesmo campo de item de trabalho.O tipo de atributo é xs:string.

ObservaçãoObservação
Usar o Name de atributo quando você deseja ter o mesmo campo exibido em mais de um local no formulário.Especificar um valor exclusivo para o Name de atributo para ambas as entradas de controle para que o sistema identifica cada controle com exclusividade.É útil mostrar o mesmo controle em vários locais com base no contexto das guias.

NumberFormat

Opcional Control atributo é válido somente quando ele é usado com FieldControl.

Especifica os caracteres que você pode inserir no controle de campo.Os valores válidos que você pode usar são:

  • WholeNumbers: Especifica que números inteiros são permitidos.

  • SignedWholeNumbers: Especifica que números inteiros assinados são permitidos.

  • DecimalNumbers: Especifica que números decimais são permitidos.

  • SignedDecimalNumbers: Especifica que números decimais assinados são permitidos.

MaxLength

Opcional Control atributo é válido somente quando ele é usado com FieldControl.

Especifica o comprimento máximo de caracteres permitidos para um controle de campo.O tipo de atributo é xs:integer.

Format

Opcional Control atributo é válido somente quando ele é usado com DateTimeControl.

Especifica o formato do campo de data e hora correspondente a um dos valores de enumeração DateTimePickerFormat.Os valores válidos que você pode usar são:

  • Custom: Exibe o valor de data/hora em um formato personalizado.O formato personalizado pode ser definido especificando 'Personalizado' como valor do atributo de formato e a configuração de outro atributo chamado CustomFormat com uma seqüência de caracteres de formato personalizado.Por exemplo:

    Formato = "Personalizado"

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

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

  • Long: Exibe o valor de data/hora no formato de data por extenso definido pelo sistema operacional do usuário.

  • Short: Exibe o valor de data/hora no formato de data abreviada definido pelo sistema operacional do usuário.

  • Time: Exibe o valor de data/hora no formato de hora definido pelo sistema operacional do usuário.

Para obter mais informações, consulte o site da Microsoft: Enumeração DateTimePickerFormat.

CustomFormat

Opcional Control atributo é válido somente quando ele é usado com DateTimeControl e Format atributo.

Especifica o formato personalizado para o campo de data e hora correspondente a sintaxe definida para a propriedade DateTimePicker.CustomFormat.Para obter mais informações, consulte o site da Microsoft: DateTimePicker.CustomFormat propriedade.

Elementos filho

Elemento

Descrição

LabelText

Elemento opcional.Você pode especificar esse elemento quando o Type atributo é especificado como FieldControl ou LabelControl.

Elemento de contêiner para especificar o texto, hiperlink e posição de um campo ou rótulo cujo texto está parcialmente associado um hiperlink.

Para obter mais informações, consulte Referência de elementos XML LabelText e texto e 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.

Link

Elemento opcional.Você pode especificar esse elemento quando o Type atributo é especificado como FieldControl ou LabelControl.

Define o hiperlink para um campo ou rótulo.

Para obter mais informações, consulte Referência de elementos XML link e Param e 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.

LinksControlOptions

Elemento opcional.Você pode especificar esse elemento quando o Type atributo é especificado como LinksControl.

Define os filtros de link e o layout dos campos de coluna para exibir a lista de links.

Para mais informações, consulte Definir controles de link para restringir as relações de link.

WebpageControlOptions

Elemento opcional.Você pode especificar esse elemento quando o Type é WebpageControl.

Especifica os controles que regem a carregar o página da Web de destino no formulário de item de trabalho.

Para obter mais informações, consulte Referência de elementos XML WebpageControlOptions e 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.

anyAttribute

Elemento opcional.

Opcional.Controlé extensível através do uso de anyAttribute elemento.

Elementos pai

Elemento

Descrição

Layout

Necessário.Define como exibir os elementos no formulário de item de trabalho.

Coluna elemento

Necessário.Define as colunas para o formulário.

Guia elemento

Necessário.Define uma guia para o formulário.

Comentários

Controlé um elemento filho opcional de Layout, Column, e Tab.

Layoute Column indicadores:

minOccurs = "0"

maxOccurs = "1"

Tabindicadores:

minOccurs = "0"

maxOccurs = "não vinculado"

Para implementar um controle personalizado, você deve especificar o nome do controle para o Type atributo.Para obter mais informações, consulte o site da Microsoft: Trabalho Item rastreamento personalizado controles.

Para obter um exemplo de cada tipo de controle, consulte Especificar controles de formulário de item de trabalho.

Exemplo

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

Informações do elemento

Namespace

https://schemas.microsoft.com/VisualStudio/2008/WorkItemTracking/TypeDef

Nome do esquema

Definição de tipo de Item de trabalho

Arquivo de validação

WorkItemTypeDefinition.xsd

Tipo de elemento

Tipo complexo ControlType

Pode ser vazio

Não aplicável.

Consulte também

Conceitos

Criar e personalizar um formulário de item de trabalho

Todas as referências de elementos do formulário XML

Especificar controles de formulário de item de trabalho