Saltar al contenido principal

Qué hace

Un campo del documento. El tipo de campo se puede determinar a partir de la propiedad Type. Para los campos de tabla, están disponibles los métodos del objeto Rows y Cell.

Métodos

AddRegion( page : IPage, rect : string ) : IFieldRegion

Agrega una región con las coordenadas especificadas al campo. rect es la descripción de un rectángulo con el formato [left,top,right,bottom]. Este método requiere permisos de escritura para el objeto IField.

Nota: Este método no está disponible para tablas. Para eliminar una región, use el método IFieldRegion.Delete().

Cell( columnName : string, rowNum : int ) : IField

Obtiene una celda de tabla por el nombre de la columna y el número de fila. Disponible solo para tablas. No está disponible en reglas de script.

CheckRules( )

Comprueba las reglas del campo especificado y de sus elementos secundarios. No se puede usar en reglas.

Field( Path : string) : IField

Busca el elemento secundario relativo al elemento dado. Se usan rutas relativas. En las reglas, solo se pueden usar sinónimos de nombres de campo tal como están definidos en la configuración de reglas.

GetFieldExtractor( )

Devuelve un objeto IFieldExtractor.

GetLangs() : IVARAIANTArray

Devuelve los ID de los idiomas detectados en un campo.

HasField( parameter : string) : bool

Comprueba si existe el campo con la ruta especificada. Se usan rutas relativas. En las reglas, solo se pueden usar sinónimos de nombres de campo tal como están definidos en la configuración de reglas.

Suggest( VARIANT newSuggest )

Agrega una sugerencia al campo.

Nota: Puede ser un valor o una cadena. Los valores agregados se escriben con cuatro decimales.

Por ejemplo, el método field.Suggest( “12.90” ) agrega la sugerencia con el formato “12.90”, mientras que field.Suggest( 12.90 ) agrega la sugerencia como 12.9000.

Propiedades

Etiqueta

string

De solo lectura

El nombre del campo que se muestra en el formulario. El valor de esta propiedad puede ser el mismo que el de la propiedad Name.

Elementos secundarios

IFields

De solo lectura

Elementos secundarios del campo (celdas en tablas). No disponible en reglas de script.

FullName

cadena

De solo lectura

El nombre completo del campo en relación con el documento. Es un identificador único del campo dentro del documento. Puede usarse para buscar campos del documento mediante el método Field. En las reglas de script, el valor devuelto coincide con Name y no es único.

HasRuleError

bool

Lectura/escritura

Especifica si hay una advertencia o un error de regla asociado al campo.

Nota: En las reglas de script, esta propiedad especifica si se debe mostrar el campo en el mensaje de error.

Una regla incluye una colección de campos especificados en el cuadro de diálogo de propiedades de la reglacuadro de diálogo de propiedades de la regla. Si falla la comprobación de la regla, un mensaje de error (especificado en IRuleContext .ErrorMessage) y enlaces a los campos de la colección se muestran en el editor de documentos. Establecer esta propiedad en false excluye el campo de la lista de enlaces asociados al error.

IsExportable

bool

De solo lectura

Especifica si el campo está previsto para la exportación (según la configuración de Definición de Document).

IsIndexed

bool

De solo lectura

Especifica si el campo se puede indexar. Si es así, el valor del campo puede estar disponible en los campos externos del documento y de la página de la Definición de Document.

IsMatched

bool

De solo lectura

Indica si el campo está emparejado.

IsSuspicious

bool

De solo lectura

Indica si el valor del campo se ha reconocido con certeza.

IsValid

bool

De solo lectura

Indica si el campo no tiene errores de formato.

IsVerified

bool

Lectura/escritura

Especifica si el campo está verificado.
Nota: La propiedad no funciona para grupos de camposgrupos de campos.

La propiedad puede establecerse en true en las reglas incluso sin permisos de “escritura” para el campo. Para desactivar el indicador, se requieren permisos de “escritura”.

Si el indicador es true, el campo se muestra en gris en el editor de documentos, como si ya estuviera confirmado. Si el indicador es false, el campo se muestra en blanco y debe confirmarse. Una vez que el campo se verifica, el indicador se establece en true.

Nota: Establecer este indicador en false no envía el campo a la etapa de Verificación de datos. Para ello, use la propiedad NeedVerification de las interfaces IField o ICharacterParams.

IsVisible

bool

Lectura/escritura

Especifica si el campo debe mostrarse en el diseño del documento (según la Configuración de Definición de Document).

Elementos

IFields

De solo lectura

Instancias del campo (filas de los campos de tabla).

Name

string

De solo lectura

El nombre del campo en la Definición de Documentos.

NeedVerification

bool

Lectura/escritura

Especifica si el campo en sí (no sus caracteres) necesita verificación.

Si la marca es true, el campo se muestra sobre un fondo rojo en el editor de documentos, lo que indica que el campo necesita verificación. Si la opción Send to field verification está seleccionada en las propiedades del campopropiedades del campo, el campo se enviará a la etapa de Verificación de datos. Una vez verificado el campo, la marca se establece en false.

Para especificar si determinados caracteres, pero no el campo completo, necesitan verificación, use la propiedad NeedVerification de la ICharacterParams interfaz.

ReadOnly

bool

De solo lectura

Especifica si el campo tiene permisos “de solo lectura” (según la Configuración de Definición de Document). Cuando se usa en las reglas, indica que la regla tiene permiso de “escritura” para el campo.

ReadOnlyInForm

bool

Lectura/escritura

Especifica si el campo del formulario tiene permisos de “solo lectura” (según la Configuración de Definición de Document).

Regiones**

IFieldRegions

De solo lectura

Un array de regiones de campo. Los campos que se desbordan pueden tener varias regiones.

Filas

IFields

De solo lectura

Un conjunto de filas de una tabla. No disponible para campos que no son de tabla.

Símbolos

ICharactersParams

De solo lectura

Información detallada sobre las propiedades de los símbolos.

Text

string

Lectura y escritura

La representación textual del valor de un campo.

Tipo

TExportFieldType

De solo lectura

El tipo del campo.

Value

VARIANT

Lectura/escritura

El valor del campo en formato VARIANT. La propiedad devuelve un objeto de tipo Int32 si la configuración del campo indica que contiene un entero y su valor absoluto no es superior a 2147483647. Si el valor absoluto del campo es superior a 2147483647, la propiedad devuelve un objeto de tipo double.

** - La propiedad no está disponible si la opción Advanced XML Export de las propiedades de License no está seleccionada.