Método THotPDF.AddLoadedComboBox
Adiciona uma caixa de combinação (um campo choice suspenso com a flag Combo definida) a uma página do documento carregado e a registra no AcroForm. O stream de aparência mostra o valor selecionado
Declaração
function AddLoadedComboBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; const AOptions: array of AnsiString): Integer;Unit
HPDFDoc
Parâmetros
| Nome | Finalidade |
|---|---|
PageIndex | Índice de base zero da página carregada que recebe o widget |
X1 | Borda esquerda do retângulo do widget no espaço de usuário do PDF (pontos, origem no canto inferior esquerdo da página) |
Y1 | Borda inferior do retângulo do widget no espaço de usuário do PDF |
X2 | Borda direita do retângulo do widget no espaço de usuário do PDF |
Y2 | Borda superior do retângulo do widget no espaço de usuário do PDF |
AFieldName | Nome do novo campo; ele não pode já existir no formulário carregado |
AValue | Opção selecionada; vazio para nenhuma seleção |
AOptions | Opções oferecidas na lista suspensa |
Valor de retorno
Índice do novo campo, para usar com os outros métodos de campo de formulário carregado, ou -1 quando PageIndex estiver fora da faixa
Notas de uso
- Use esta API no fluxo de trabalho de geometria de página antes que a página, o recurso, o campo ou o objeto de catálogo afetados sejam finalizados
- Mantenha nomes de objetos, nomes de campos, nomes de recursos e handles retornados estáveis até que o documento seja finalizado
- Referências de objeto em documentos carregados podem ser indiretas; resolva arrays, dicionários ou streams antes de inspecionar valores aninhados