Editor de formularios
Descripción general
FormEditor es una clase en Aspose.PDF FOSS para .NET.
Hereda de: IDisposable.
Fachada para operaciones de formulario: rellenar campos, aplanar formularios, importar/exportar datos.
Esta clase proporciona 64 métodos para trabajar con objetos FormEditor en programas .NET.
Los métodos disponibles incluyen: AddCheckBox, AddField, AddFieldScript, AddListItem, AddSubmitBtn, AddTextField, BindPdf, CheckField, Close, CopyInnerField, CopyOuterField, DecorateField y 34 métodos adicionales.
Todos los miembros públicos son accesibles para cualquier aplicación .NET después de instalar el paquete Aspose.PDF FOSS for .NET.
Propiedades: ConvertTo, DestFileName, DestStream, ExportItems, Facade, Items y 6 más.
Propiedades
| Name | Type | Access | Description |
|---|---|---|---|
SrcFileName | string? | Read/Write | Ruta del archivo fuente utilizada por el ctor sin parámetros + flujo Save. |
SrcStream | Stream? | Read/Write | Secuencia de origen utilizada por el ctor sin parámetros + flujo Save. |
DestFileName | string? | Read/Write | Ruta del archivo de destino escrita por el Save() sin parámetros. |
DestStream | Stream? | Read/Write | Secuencia de destino escrita por el Save() sin parámetros. |
ConvertTo | PdfFormat | Read/Write | Versión objetivo de PDF/A o PDF para la salida guardada. |
Facade | FormFieldFacade | Read/Write | Apariencia visual aplicada por AddField y DecorateField(). |
Items | string[]? | Read/Write | Lista predeterminada de elementos utilizada por AddField al crear campos ListBox / ComboBox. |
ExportItems | string[][]? | Read/Write | Pares de valor de exportación asociados con Items. |
RadioButtonItemSize | double | Read/Write | Longitud del borde del elemento de botón de opción (en puntos) utilizada al organizar un grupo de botones de opción. |
RadioGap | float | Read/Write | Espacio (en puntos) entre los elementos de botón de opción en un grupo. |
RadioHoriz | bool | Read/Write | Cuando es true, los elementos de botón de opción se disponen horizontalmente; de lo contrario, verticalmente. |
SubmitFlag | SubmitFormFlag | Read/Write | Formato de envío utilizado por AddSubmitBtn y SetSubmitFlag. |
Métodos
| Signature | Description |
|---|---|
FormEditor() | Constructor predeterminado para API basada en byte[] sin estado. |
FormEditor(document: Document) | Vincular el editor a un documento para operaciones in situ. |
FormEditor(document: Document, destStream: Stream) | Vincular un documento y preconfigurar un flujo de salida para el método Save sin parámetros. |
FormEditor(document: Document, destFileName: string) | Vincular un documento y preconfigurar una ruta de archivo de salida para el método Save sin parámetros. |
FormEditor(srcStream: Stream, destStream: Stream) | Abrir desde un flujo de entrada, escribiendo a un flujo de salida al guardar. |
FormEditor(srcFileName: string, destFileName: string) | Abrir desde un archivo de entrada, escribiendo a un archivo de salida al guardar. |
BindPdf(path: string) | Vincular un archivo PDF por ruta para editar. |
BindPdf(pdfData: byte[]) | Vincular un PDF desde un búfer de bytes. |
BindPdf(stream: Stream) | Vincular un PDF desde un flujo. |
BindPdf(document: Document) | Vincular un PDF desde un Document ya abierto. |
Save(path: string) | Guardar el documento vinculado en una ruta de archivo. |
Save(destStream: Stream) | Guardar el documento vinculado en un flujo. |
Save() | Guardar el documento vinculado en el destino configurado (DestFileName o DestStream). |
Close() | Cerrar y liberar el documento vinculado. |
Dispose() | Llama a Dispose en esta instancia de FormEditor. |
SetField(fieldName: string, value: string) | Establecer el valor de un campo por nombre. |
CheckField(fieldName: string) | Marcar una casilla de verificación por nombre. |
UncheckField(fieldName: string) | Desmarcar una casilla de verificación por nombre. |
AddTextField(fieldName: string, pageNumber: int, llx: double, lly: double, urx: double, ury: double) | Añadir un campo de texto al documento vinculado. |
AddCheckBox(fieldName: string, pageNumber: int, llx: double, lly: double, urx: double, ury: double, isChecked: bool) | Añadir un campo de casilla de verificación al documento vinculado. |
AddField(fieldType: FieldType, fieldName: string, pageNum: int, llx: float, lly: float, urx: float, ury: float) | Añadir un campo del tipo fieldType especificado en el rectángulo solicitado en la página pageNum. |
AddField(fieldType: FieldType, fieldName: string, initValue: string?, pageNum: int, llx: float, lly: float, urx: float, ury: float) | Añadir un campo con un valor inicial (campos de texto y cuadros combinados). |
AddListItem(fieldName: string, itemName: string) | Añadir un único elemento a un campo ListBox / ComboBox. |
AddListItem(fieldName: string, exportName: string[]) | Añadir un único elemento con un par valor de exportación (display, export). |
DelListItem(fieldName: string, itemName: string) | Eliminar un único elemento de un campo ListBox / ComboBox. |
AddSubmitBtn(fieldName: string, page: int, label: string, url: string, llx: float, lly: float, urx: float, ury: float) | Añadir un botón Submit. |
AddFieldScript(fieldName: string, script: string) | Adjuntar un script de acción JavaScript a un campo. |
SetFieldScript(fieldName: string, script: string) | Reemplazar el script de acción JavaScript del campo. |
CopyInnerField(fieldName: string, newFieldName: string, pageNum: int) | Copiar un campo dentro del documento vinculado a otra página. |
CopyInnerField(fieldName: string, newFieldName: string, pageNum: int, abscissa: float, ordinate: float) | Copiar un campo dentro del documento vinculado a otra página en las coordenadas dadas. |
CopyOuterField(srcFileName: string, fieldName: string) | Copiar un campo de otro archivo PDF al documento vinculado en la misma posición. |
CopyOuterField(srcFileName: string, fieldName: string, pageNum: int) | Copiar un campo de otro archivo PDF al documento vinculado en una página especificada. |
CopyOuterField(srcFileName: string, fieldName: string, pageNum: int, abscissa: float, ordinate: float) | Copiar un campo de otro archivo PDF en coordenadas explícitas. |
DecorateField() | Aplicar Facade a cada campo del documento. |
DecorateField(fieldType: FieldType) | Aplicar Facade a cada campo del tipo especificado. |
DecorateField(fieldName: string) | Aplicar Facade a un único campo con nombre. |
ResetFacade() | Restablecer todas las propiedades en Facade. |
ResetInnerFacade() | Alias de ResetFacade que cubre llamadores de nested-facade. |
MoveField(fieldName: string, llx: float, lly: float, urx: float, ury: float) | Mover el cuadro delimitador de un campo. |
RenameField(fieldName: string, newFieldName: string) | Renombrar un campo de formulario. |
RemoveField(fieldName: string) | Eliminar un campo por nombre. |
RemoveFieldAction(fieldName: string) | Eliminar la acción adjunta a un campo. |
SetFieldAlignment(fieldName: string, alignment: int) | Establecer la alineación horizontal del valor de un campo. |
SetFieldAlignmentV(fieldName: string, alignment: int) | Establecer la alineación vertical del valor de un campo. |
SetFieldAppearance(fieldName: string, flags: AnnotationFlags) | Establecer los indicadores de visibilidad / solo lectura / obligatorio en un campo. |
GetFieldAppearance(fieldName: string) | Devolver los indicadores de visibilidad / solo lectura / obligatorio de un campo. |
SetFieldAttribute(fieldName: string, flag: PropertyFlag) | Establecer ReadOnly / Required / NoExport. |
SetFieldCombNumber(fieldName: string, combNumber: int) | Establecer el recuento de celdas combinadas para un campo de texto (PDF 1.5+). |
SetFieldLimit(fieldName: string, fieldLimit: int) | Establecer el recuento máximo de caracteres de un campo de texto por nombre. |
SetSubmitFlag(fieldName: string, submitFormFlag: SubmitFormFlag) | Establecer el indicador de acción SubmitForm en un campo de botón. |
SetSubmitUrl(fieldName: string, url: string) | Establecer la URL de destino de la acción SubmitForm en un campo de botón. |
Single2Multiple(fieldName: string) | Convertir un campo de texto de una sola línea en uno de varias líneas. |
FlattenAllFields() | Aplanar todos los campos de formulario en el documento vinculado. |
FillFields(input: byte[], fieldValues: Dictionary<string, string>) | Rellenar los campos del formulario con los valores dados (nombre del campo → valor). |
FillField(input: byte[], fieldName: string, value: string) | Rellenar un único campo de formulario por nombre. |
FlattenForm(input: byte[]) | Aplanar el formulario — renderizar los campos como contenido estático y eliminar el AcroForm. |
GetFieldNames(input: byte[]) | Obtener todos los nombres de campo en el formulario del documento. |
GetFieldValue(input: byte[], fieldName: string) | Obtener el valor de un campo específico. |
GetFieldType(input: byte[], fieldName: string) | Obtener el tipo de un campo específico. |
HasForm(input: byte[]) | Verificar si el documento tiene un formulario. |
GetFieldCount(input: byte[]) | Obtener el número total de campos de formulario. |
ExportFormData(input: byte[]) | Exportar los datos del formulario como un diccionario (nombre del campo → valor). |
ImportFormData(input: byte[], data: Dictionary<string, string>) | Importar datos del formulario desde un diccionario. |
RenameField(input: byte[], oldName: string, newPartialName: string) | Renombrar un campo de formulario en los bytes suministrados. |