Método THotPDF.AddLoadedComboBox
Agrega un combo box (un campo de elección desplegable con la bandera Combo establecida) a una página del documento cargado y lo registra en el AcroForm. El appearance stream muestra el valor seleccionado
Declaración
function AddLoadedComboBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; const AOptions: array of AnsiString): Integer;
Unidad
HPDFDoc
Parámetros
| Nombre | Uso |
|---|---|
PageIndex | Índice a partir de cero de la página cargada que recibe el widget |
X1 | Borde izquierdo del rectángulo del widget en el espacio de usuario de PDF (puntos, origen en la esquina inferior izquierda de la página) |
Y1 | Borde inferior del rectángulo del widget en el espacio de usuario de PDF |
X2 | Borde derecho del rectángulo del widget en el espacio de usuario de PDF |
Y2 | Borde superior del rectángulo del widget en el espacio de usuario de PDF |
AFieldName | Nombre del campo nuevo; no debe existir todavía en el formulario cargado |
AValue | Opción seleccionada; vacío para no seleccionar nada |
AOptions | Opciones que ofrece la lista desplegable |
Valor devuelto
Índice del campo nuevo, para usarlo con los demás métodos de campos de formulario cargados, o -1 cuando PageIndex está fuera de rango
Precauciones de uso
- Use este API en el flujo de trabajo de geometría de páginas antes de que la página, el recurso, el campo o el objeto de catálogo afectado quede finalizado
- Mantenga estables los nombres de objetos, campos, recursos y los handles devueltos hasta que el documento quede finalizado
- Las referencias a objetos del documento cargado pueden ser indirectas; resuelva arrays, diccionarios o streams antes de inspeccionar valores anidados