Referencia de elementos Control de XML

Artículo
08/10/2011

Se usa el Control para definir un campo de elemento de trabajo, texto, hipervínculo u otro elemento de control que aparecerá en un formulario de elemento de trabajo. Para obtener ejemplos de cómo se utiliza este elemento , vea Especificar controles de formulario de elemento de trabajo. Para obtener más información, vea Diseñar y personalizar un formulario de elementos de trabajo.

Jerarquía del esquema

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

<Control FieldName="FieldName" Type="AttachmentsControl | DateTimeControl | FieldControl | 
HtmlFieldControl | LabelControl | LinksControl | WebpageControl | WorkItemClassificationControl | 
WorkItemLogControl" 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 y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
FieldName	Atributo ControlType opcional. Especifica el campo de elemento de trabajo al que está asociado el control. El tipo de atributo es typelib:ReferenceFieldName. Longitud mínima: 1; longitud máxima: 70. Valor de modelo: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Ejemplo de un valor de modelo: Company.Division.IssueType
Type	El atributo ControlType es obligatorio. Especifica el tipo de datos del control. El tipo de atributo es un tipo simple ValidControlsType. Defina una cadena a partir de uno de los tipos integrados siguientes: AttachmentControl: Se utiliza para mostrar los datos adjuntos del elemento de trabajo. Este control no tiene asociado ningún campo o tipo de campo. DateTimeControl: Se usa para mostrar los campos de fecha con formato con un tipo de campo DateTime. FieldControl: Se usa para mostrarse campos de texto sin formato o numéricos y listas de valores para los campos con un tipo de campo de String, Identity, Integer, Double y PlainText. HtmlFieldControl: Se usa para mostrar formato de texto enriquecido multilínea de campos con un tipo de campo de HTML. LabelControl: Se utiliza para mostrar texto sin formato que no está asociado a un campo. El texto puede ser sin formato o hipervinculado. LinksControl: Se utiliza para mostrar los vínculos del elemento de trabajo. Este control no tiene asociado ningún campo o tipo de campo. WebpageControl: Se usa para mostrar contenido basado en HTML definido por un URI o incrustado dentro de una etiqueta de CDATA. Este control no tiene asociado ningún campo o tipo de campo. WorkItemClassificationControl Usado para mostrar los campos de ruta de acceso jerárquicos con un tipo de campo TreePath. Nota Los campos System.AreaPath y System.IterationPath son los únicos campos que utilizan este tipo de datos.No puede definir ningún campo personalizado utilizando este tipo de datos. WorkItemLogControl: Se utiliza para mostrar información de historial y campos del elemento de trabajo con un tipo de campo History. Nota El campo System.History es el único campo que utiliza este tipo de datos.No puede definir ningún campo personalizado utilizando este tipo de datos. Para obtener más información, vea Especificar controles de formulario de elemento de trabajo. Nota Puede utilizar un control personalizado estableciendo el atributo Type en un valor personalizado.Todos los controles cuyo valor Type no coincida con el nombre de un tipo integrado se consideran controles personalizados.Para obtener más información, vea el sitio web de Microsoft: Work Item Tracking Custom Controls.
Label	Atributo ControlType opcional. Especifica el texto visible en el formulario que identifica el control. Escriba una cadena que no supere los 80 caracteres.
LabelPosition	Atributo ControlType opcional. Especifica la posición de la etiqueta en relación con los datos del control. Defina una cadena a partir de uno de los valores siguientes: Top: coloca la etiqueta encima de los datos del control. Bottom: coloca la etiqueta debajo de los datos del control. Left: coloca la etiqueta a la izquierda de los datos del control. Right: coloca la etiqueta a la derecha de los datos del control.
Dock	Atributo ControlType opcional. Alinea el campo con el lado especificado del contenedor o ajusta el campo de modo que rellene el contenedor. El tipo de atributo es DockType. Defina una cadena a partir de uno de los valores siguientes: Fill: alinea el campo para que rellene el contenedor. Este valor no es una orientación compatible para el elemento Splitter. Top: Alinea el campo con la parte superior del contenedor. Este valor no es una orientación compatible para el elemento Splitter. Bottom: Alinea el campo con la parte inferior del contenedor. Este valor no es una orientación compatible para el elemento Splitter. Left: Alinea el campo con la parte izquierda del contenedor. Right: Alinea el campo con la parte derecha del contenedor. Este valor no es una orientación compatible para el elemento Splitter.
Padding	Atributo ControlType opcional. Especifica la cantidad de espacio en píxeles alrededor del borde interior del control, que corresponde a los espacios superior, inferior, izquierdo y derecho. El tipo de atributo es SizeType. Valor de modelo: ^$\d+\,\d+\,\d+\,\d+$$ Ejemplo de un valor de modelo: (2,0,2,0)
Margin	Atributo ControlType opcional. Especifica la cantidad de espacio en píxeles alrededor del borde exterior del control, que corresponde a los espacios superior, inferior, izquierdo y derecho. El tipo de atributo es SizeType. Valor de modelo: ^$\d+\,\d+\,\d+\,\d+$$ Ejemplo de un valor de modelo: (2,0,2,0)
ReadOnly	Atributo ControlType opcional. Especifica si el campo es de sólo lectura. El tipo de atributo es ReadOnlyType. Defina una cadena a partir de uno de los valores siguientes: True: especifica que los datos del control son de solo lectura. False: especifica que los datos del control no son de solo lectura.
MinimumSize	Atributo ControlType opcional. Especifica el tamaño mínimo en píxeles que debería ocupar el control en el formulario. La sintaxis se especifica en (width,height). El tipo de atributo es SizeType. Valor de modelo: ^$\d+\,\d+$$ Ejemplo de un valor de modelo: (100,100) Nota Si no tiene espacio vertical suficiente, aparecerá una barra de desplazamiento para mantener su tamaño mínimo.Sin este atributo, los controles se dibujan con sus tamaños predeterminados, a menos que haya controles en otras pestañas que ocupen más espacio.El tamaño total de cualquier control de formulario depende del tamaño del área de formulario o pestaña más grande.
Name	Atributo ControlType opcional. Identifica un control de forma única. Name es importante si hay varios controles en el formulario asociados al mismo campo de elemento de trabajo. El tipo de atributo es xs:string. Nota El atributo Name se usa cuando se desea mostrar el mismo campo en más de una ubicación del formulario.Se especifica un valor único para el atributo Name de ambas entradas de control a fin de que el sistema identifique cada control de forma exclusiva.Es útil para mostrar el mismo control en varias ubicaciones en función del contexto de pestañas.
NumberFormat	Atributo ControlType opcional que solo es válido cuando se utiliza con FieldControl. Especifica los caracteres que se pueden escribir en el control de campo. Los valores válidos que puede utilizar son los siguientes: WholeNumbers: Especifica que se permiten los números enteros. SignedWholeNumbers: Especifica que se permiten los números enteros firmados. DecimalNumbers: Especifica que se permiten los números decimales. SignedDecimalNumbers: Especifica que se permiten los números decimales firmados.
MaxLength	Atributo ControlType opcional que solo es válido cuando se utiliza con FieldControl. Especifica la longitud máxima de los caracteres permitidos para un control de campo. El tipo de atributo es xs:integer.
Format	Atributo ControlType opcional que solo es válido cuando se utiliza con DateTimeControl. Especifica el formato para el campo de fecha y hora que corresponde a uno de los valores de la enumeración DateTimePickerFormat. Los valores válidos que puede utilizar son los siguientes: Custom: Muestra el valor de fecha y hora en un formato personalizado. El formato personalizado se puede establecer especificando 'Custom' como valor para el atributo Format y estableciendo otro atributo denominado CustomFormat con una cadena de formato personalizado. Por ejemplo: Format="Custom" CustomFormat = "MMM dd, 'del año' yyyy" Para obtener más información, vea en el sitio web de Microsoft: DateTimePicker.CustomFormat (Propiedad). Long: muestra el valor de fecha y hora con el formato de fecha larga establecido por el sistema operativo del usuario. Short: muestra el valor de fecha y hora con el formato de fecha corta establecido por el sistema operativo del usuario. Time: muestra el valor de fecha y hora con el formato de hora establecido por el sistema operativo del usuario. Para obtener información, vea DateTimePickerFormat (Enumeración) en el sitio web de MSDN.
CustomFormat	Atributo ControlType opcional que solo es válido cuando se utiliza con los atributos Format y DateTimeControl. Especifica el formato personalizado para el campo de fecha y hora que corresponde a la sintaxis definida para la propiedad DateTimePicker.CustomFormat. Para obtener más información, vea en el sitio web de Microsoft: DateTimePicker.CustomFormat (Propiedad).

Elementos secundarios

Elemento	Descripción
LabelText	Elemento opcional. Puede especificar este elemento cuando ControlType se especifica como FieldControl o LabelControl. Elemento contenedor que se usa para especificar texto, hipervínculo y posición de un campo o etiqueta cuyo texto está asociado en parte a un hipervínculo. Para obtener más información, vea Referencia de los elementos LabelText y Text de XML y Proporcionar texto de ayuda, guía de procesos, contenido web y vínculos con páginas web en un formulario de elemento de trabajo.
Link	Elemento opcional. Puede especificar este elemento cuando ControlType se especifica como FieldControl o LabelControl. Define el hipervínculo para un campo o etiqueta. Para obtener más información, vea Referencia de los elementos Link y Param de XML y Proporcionar texto de ayuda, guía de procesos, contenido web y vínculos con páginas web en un formulario de elemento de trabajo.
LinksControlOptions	Elemento opcional. Puede especificar este elemento cuando ControlType se especifica como LinksControl. Define los filtros de los vínculos y el diseño de los campos de columna que se utilizan para mostrar la lista de vínculos. Para obtener más información, vea Definir controles de vínculos para restringir las relaciones de los vínculos.
WebpageControlOptions	Elemento opcional. Puede especificar este elemento cuando ControlType es WebpageControl. Especifica los controles que rigen la carga del destino de la página web en el formulario de elemento de trabajo. Para obtener más información, vea WebpageControlOptions (Referencia de elementos de XML) y Proporcionar texto de ayuda, guía de procesos, contenido web y vínculos con páginas web en un formulario de elemento de trabajo.
anyAttribute	Elemento opcional. Opcional. ControlType se puede extender mediante el uso del elemento anyAttribute. ProcessContents: skip.

Elementos primarios

Elemento	Descripción
Diseño	Obligatorio. Define cómo mostrar los elementos en el formulario del elemento de trabajo.
Elemento Column	Obligatorio. Define las columnas del formulario.
Elemento Tab	Obligatorio. Define una pestaña del formulario.

Comentarios

Control es un elemento secundario opcional de Layout, Column y Tab.

Indicadores Layout y Column:

minOccurs = "0"

maxOccurs = "1"

Indicadores Tab:

minOccurs = "0"

maxOccurs = "unbounded"

Para implementar un control personalizado, debe especificar el nombre del control para el atributo Type. Para obtener más información, vea el sitio web de Microsoft: Work Item Tracking Custom Controls.

Para obtener un ejemplo de cada tipo de control, vea Especificar controles de formulario de elemento de trabajo.

Ejemplo

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

Información de elemento

Espacio de nombres	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nombre de esquema	Definición del tipo de elemento de trabajo
Archivo de validación	WorkItemTypeDefinition.xsd
Tipo de elemento	Tipo complejo ControlType
Puede estar vacío	No es aplicable

Vea también

Conceptos

Diseñar y personalizar un formulario de elementos de trabajo

Referencia de todos los elementos FORM de XML

Especificar controles de formulario de elemento de trabajo

Historial de cambios

Fecha	Historial	Motivo
Enero de 2011	Se agregan elementos secundarios a la sintaxis, se quitan o reemplazan los vínculos a los temas que se han quitado.	Mejora de la información.

Enero de 2011

Se agregan elementos secundarios a la sintaxis, se quitan o reemplazan los vínculos a los temas que se han quitado.

Mejora de la información.