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
<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:
Para mais informações, consulte Especificar controles de formulário de item de trabalho.
Observaçã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:
|
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:
|
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:
|
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çã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çã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:
|
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:
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 |
---|---|
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. |
|
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. |
|
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. |
|
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 |
---|---|
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