File: form.md

package info (click to toggle)
pikepdf 10.3.0%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 9,136 kB
  • sloc: python: 14,167; cpp: 5,287; makefile: 260; sh: 82
file content (83 lines) | stat: -rw-r--r-- 1,718 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
# Form

The `pikepdf.form` module provides a high-level API for working with interactive forms, built on top of the lower-level `pikepdf.AcroForm` interface.

```{eval-rst}
.. autoapimodule:: pikepdf.form

.. autoapiclass:: pikepdf.form.Form
    :members:
```

## Form Fields

```{eval-rst}
.. autoapiclass:: pikepdf.form._FieldWrapper
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.TextField
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.CheckboxField
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.RadioButtonGroup
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.RadioButtonOption
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.PushbuttonField
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.ChoiceField
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.ChoiceFieldOption
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.SignatureField
    :members:
```

## Generating Appearance Streams

Merely setting the values of form fields is not sufficient. It is also necessary to
generate appearance streams for fields. These appearance streams define how the filled-out
field should actually look when viewed in a PDF reader.

Generating appearance streams can be very complex. Both of the classes below have limited
capacities, but should work for many use cases, and can be extended to meet your needs.

```{eval-rst}
.. autoapiclass:: pikepdf.form.AppearanceStreamGenerator
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.DefaultAppearanceStreamGenerator
    :members:
```

```{eval-rst}
.. autoapiclass:: pikepdf.form.ExtendedAppearanceStreamGenerator
    :members:


```