Métodos THotPDF de edición de campos de formulario cargados

Actualiza restricciones de campo y diccionarios de apariencia de widget en un AcroForm existente conservando la corrección del guardado incremental y de la cache de renderizado

Métodos a nivel de campo

procedure SetLoadedFormFieldFlags(FieldIndex, AFlags: Integer);
procedure SetLoadedFormFieldMaxLength(FieldIndex, AMaxLength: Integer);
procedure SetLoadedFormFieldJustification(FieldIndex: Integer;
  AJustification: THPDFFormFieldJustification);
procedure SetLoadedFormFieldTooltip(FieldIndex: Integer; const ATooltip: AnsiString);

• SetLoadedFormFieldFlags reemplaza la máscara de bits /Ff completa del PDF
• SetLoadedFormFieldMaxLength escribe /MaxLen; un valor cero o negativo elimina el límite
• THPDFFormFieldJustification contiene ffjLeft, ffjCenter y ffjRight para los valores /Q del PDF de 0 a 2

Geometría del widget

function GetLoadedFormFieldWidgetCount(FieldIndex: Integer): Integer;
function GetLoadedFormFieldWidgetRect(FieldIndex, WidgetIndex: Integer;
  out ARect: THPDFRect): boolean;
procedure SetLoadedFormFieldWidgetRect(FieldIndex, WidgetIndex: Integer;
  X1, Y1, X2, Y2: Single);

• Los índices de campos y widgets son de base cero
• La enumeración de widgets expone cada entrada /Kids de los grupos de botones de opción y demás campos multi-widget
• Los extremos del rectángulo usan puntos PDF de espacio de usuario en bruto y se normalizan antes de escribir

Apariencia y visibilidad del widget

procedure SetLoadedFormFieldRotation(FieldIndex, ADegrees: Integer);
procedure SetLoadedFormFieldBorderColor(FieldIndex: Integer;
  ARed, AGreen, ABlue: Single);
procedure SetLoadedFormFieldVisibility(FieldIndex: Integer;
  AVisible, APrintable: boolean);
procedure SetLoadedFormFieldBorderWidth(FieldIndex: Integer; AWidth: Single);
procedure SetLoadedFormFieldBackgroundColor(FieldIndex: Integer;
  ARed, AGreen, ABlue: Single);

• La rotación acepta múltiplos positivos o negativos de 90 grados y guarda el valor normalizado /MK /R
• Los componentes RGB del borde y del fondo se ajustan al rango DeviceRGB del PDF, de 0 a 1
• Los setters de apariencia y visibilidad actualizan todos los widgets del campo seleccionado
• La visibilidad conserva los flags de anotación no relacionados mientras controla Hidden, NoView y Print

Comportamiento de la actualización incremental

• Los diccionarios de campo, widget, /MK y /BS se marcan como modificados en el nivel donde se guarda cada valor
• Los cambios visuales invalidan solo las variantes DPI en cache de la página afectada
• Los índices de campo o widget no válidos dejan el documento sin cambios

Ejemplo

PDF.BeginIncrementalUpdate('input.pdf');
PDF.SetLoadedFormFieldMaxLength(0, 40);
PDF.SetLoadedFormFieldJustification(0, ffjCenter);
PDF.SetLoadedFormFieldRotation(0, 90);
PDF.SetLoadedFormFieldBorderColor(0, 0.1, 0.4, 0.8);
PDF.SetLoadedFormFieldWidgetRect(1, 1, 80, 150, 100, 170);
PDF.SaveIncrementalUpdate('updated.pdf');

APIs relacionadas

Métodos de campos de formulario cargados · Toolkit de documentos cargados · THotPDF