Update widget.rst - #5131
Open
JorjMcKie wants to merge 1 commit into
Open
Update widget.rst#5131JorjMcKie wants to merge 1 commit into
JorjMcKie wants to merge 1 commit into
Conversation
jamie-lemon
requested changes
Sep 21, 2026
| * combo box (`PDF_WIDGET_TYPE_COMBOBOX`) | ||
| * list box (`PDF_WIDGET_TYPE_LISTBOX`) | ||
| * radio button (`PDF_WIDGET_TYPE_RADIOBUTTON`): PyMuPDF now supports the creation and update of Radio Button Groups (RBGs). Adding a new radio button widget with the same (full) name as an existing one anywhere in the PDF will automatically create or extend an RBG. | ||
| * radio button (`PDF_WIDGET_TYPE_RADIOBUTTON`): PyMuPDF now supports the creation and update of Radio Button Groups (RBGs). Adding a new radio button widget with the same (full) name as an existing one anywhere in the PDF will automatically create or extend an RBG. There currently still exist some limitations [#f3]_. |
Collaborator
There was a problem hiding this comment.
There are currently some limitations?
"There currently still exist some" sounds overly complicated!
Collaborator
Author
There was a problem hiding this comment.
I haven't uploaded all novelties regarding form fields. Once I have (in a next PR), most of the limitations will be gone.
So I guess we must decide whether telling the final truth or a the current one.
|
|
||
| .. [#f2] Among other purposes, ``Parent`` objects are also used to facilitate multiple occurrences of a field (on the same or on different pages). The ``Kids`` array in this ``Parent`` object contains the cross references of all widgets that are "copies" of the same field. Whenever the field value of any "kid" widget is changed, all the other kids are immediately updated too. This is a very efficient way to handle multiple copies of the same field, e.g. for filling out forms. This simultaneous update only happens for :attr:`Widget.field value`. The new parameter ``sync_flags`` extends this to :attr:`Widget.field_flags`. This cannot be automated in the same way as for the field value to allow for more flexibility. | ||
|
|
||
| .. [#f3] Radio Button Groups (RBGs) come in (at least) three technical variants. Please note that the actual PDF Form Field is the RBG - not the individual widgets. Each RB widget represents one of the possible "values" of the Form Field parent. Widgets in general do not need to exist all on the same page. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.