PyMuPDF 1.23.0rc1 - en to ja translation catalogue (70 entries)

en: PyMuPDF is a high-performance Python library for data extraction, analysis, conversion & manipulation of PDF (and other) documents.
ja: PyMuPDF は、PDF （およびその他の）ドキュメントのデータ抽出、分析、変換、操作のための高性能な Python ライブラリです。

en: PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, PDF Splitting, PDF Creation, Pyodide, PyScript
ja: PDFテキスト抽出、PDFイメージ抽出、PDF変換、PDFテーブル、PDF分割、PDF作成, Pyodide, PyScript

en: Widget
ja: Widget (ウィジェット)

en: This class represents a PDF Form field, also called a "widget". Throughout this documentation, we are using these terms synonymously. Fields technically are a special case of PDF annotations, which allow users with limited permissions to enter information in a PDF. This is primarily used for filling out forms.
ja: このクラスは、PDFフォームフィールド、または「ウィジェット」とも呼ばれるものを表します。このドキュメンテーション全体で、これらの用語を同義語として使用しています。フィールドは技術的にはPDF注釈の特殊なケースであり、制限付きの権限を持つユーザーがPDFに情報を入力することを可能にします。これは主にフォームの記入に使用されます。

en: Like annotations, widgets live on PDF pages. Similar to annotations, the first widget on a page is accessible via :attr:`Page.first_widget` and subsequent widgets can be accessed via the :attr:`Widget.next` property.
ja: アノテーションと同様に、ウィジェットもPDFページ上に存在します。注釈と同様に、ページ上の最初のウィジェットは :attr:`Page.first_widget` 経由でアクセスでき、その後のウィジェットは :attr:`Widget.next` プロパティ経由でアクセスできます。

en: *(Changed in version 1.16.0)* MuPDF no longer treats widgets as a subset of general annotations. Consequently, :attr:`Page.first_annot` and :meth:`Annot.next` will deliver **non-widget annotations exclusively**, and be *None* if only form fields exist on a page. Vice versa, :attr:`Page.first_widget` and :meth:`Widget.next` will only show widgets. This design decision is purely internal to MuPDF; technically, links, annotations and fields have a lot in common and also continue to share the better part of their code within (Py-) MuPDF.
ja: *（バージョン1.16.0で変更）* MuPDFはウィジェットを一般的な注釈のサブセットとして扱わなくなりました。したがって、:attr:`Page.first_annot` および :meth:`Annot.next` は非ウィジェット注釈のみを返し、ページにフォームフィールドのみが存在する場合はNoneを返します。逆に、:attr:`Page.first_widget` および :meth:`Widget.next` はウィジェットのみを表示します。この設計の決定はMuPDF内部におけるものであり、技術的にはリンク、注釈、およびフィールドは多くの共通点を持ち、また（Py-）MuPDF内でコードの大部分を共有し続けています。

en: **Class API**
ja: クラスAPI

en: *New in version 1.18.15*
ja: *バージョン1.18.15で新しく追加*

en: Return the names of On / Off (i.e. selected / clicked or not) states a button field may have. While the 'Off' state usually is also named like so, the 'On' state is often given a name relating to the functional context, for example 'Yes', 'Female', etc.
ja: ボタンフィールドが持つOn / Off（選択/クリックしたかどうか）状態の名前を返します。通常、 'Off'状態も同様に名前が付けられていますが、 'On'状態は機能的なコンテキストに関連する名前がよく付けられます。たとえば、「Yes」、「Female」などです。

en: This method helps finding out the possible values of :attr:`field_value` in these cases.
ja: このメソッドは、これらのケースで :attr:`field_value` の可能な値を調べるのに役立ちます。

en: returns
ja: 戻り値：

en: a dictionary with the names of 'On' and 'Off' for the *normal* and the *pressed-down* appearance of button widgets. The following example shows that the "selected" value is "Male":
ja: *normal* の 状態と *pressed-down* 状態のボタンウィジェットの 'On'と 'Off'の名前を持つ辞書。次の例では、「選択された」値は「Male」であることが示されています：

en: New in version 1.22.2
ja: 新機能（バージョン1.22.2で追加）

en: Return the value of the "ON" state of check boxes and radio buttons. For check boxes this is always the value "Yes". For radio buttons, this is the value to select / activate the button.
ja: チェックボックスとラジオボタンの「ON」状態の値を返します。チェックボックスの場合、これは常に「Yes」という値です。ラジオボタンの場合、これはボタンを選択/アクティブ化する値です。

en: the value that sets the button to "selected". For non-checkbox, non-radiobutton fields, always `None` is returned. For check boxes the return is `True`. For radio buttons this is the value "Male" in the following example:
ja: ボタンを「選択」に設定する値が返されます。非チェックボックス、非ラジオボタンフィールドの場合、常に `None` が返されます。チェックボックスの場合、戻り値は `True` です。ラジオボタンの場合、次の例では値が「Male」です。

en: So for check boxes and radio buttons, the recommended method to set them to "selected", or to check the state is the following:
ja: したがって、チェックボックスとラジオボタンの場合、それらを「選択」または状態を確認するための推奨される方法は次のとおりです。

en: After any changes to a widget, this method **must be used** to store them in the PDF [#f1]_.
ja: ウィジェットに変更が加えられた後、これらの変更をPDFに保存するためにこのメソッドを **使用する必要があります** [#f1]_。

en: Reset the field's value to its default -- if defined -- or remove it. Do not forget to issue :meth:`update` afterwards.
ja: フィールドの値をデフォルト値にリセットします。デフォルトが定義されている場合、それを削除します。その後、:meth:`update` を実行するのを忘れないでください。

en: Point to the next form field on the page. The last widget returns *None*.
ja: ページ上の次のフォームフィールドを指します。最後のウィジェットは *None* を返します。

en: A list of up to 4 floats defining the field's border color. Default value is *None* which causes border style and border width to be ignored.
ja: フィールドの境界線の色を定義する最大4つの浮動小数点数のリストです。デフォルト値は *None* で、これにより境界線スタイルと境界線の幅が無視されます。

en: A string defining the line style of the field's border. See :attr:`Annot.border`. Default is "s" ("Solid") -- a continuous line. Only the first character (upper or lower case) will be regarded when creating a widget.
ja: フィールドの境界線の線スタイルを定義する文字列です。:attr:`Annot.border` を参照してください。デフォルトは "s" ("Solid") で、連続線です。ウィジェットを作成する際、最初の文字（大文字または小文字）のみが考慮されます。

en: A float defining the width of the border line. Default is 1.
ja: 境界線の幅を定義する浮動小数点数です。デフォルトは1です。

en: A list/tuple of integers defining the dash properties of the border line. This is only meaningful if *border_style == "D"* and :attr:`border_color` is provided.
ja: *border_style == "D"* であり、:attr:`border_color` が指定されている場合にのみ意味があります。これは、境界線のダッシュプロパティを定義する整数のリスト/タプルです。

en: Python sequence of strings defining the valid choices of list boxes and combo boxes. For these widget types, this property is mandatory and must contain at least two items. Ignored for other types.
ja: リストボックスとコンボボックスの有効な選択肢を定義するPythonシーケンスの文字列です。これらのウィジェットタイプでは、このプロパティが必須で、少なくとも2つのアイテムを含める必要があります。他のタイプでは無視されます。

en: A mandatory string defining the field's name. No checking for duplicates takes place.
ja: フィールドの名前を定義する必須の文字列です。重複をチェックしません。

en: An optional string containing an "alternate" field name. Typically used for any notes, help on field usage, etc. Default is the field name.
ja: 「代替」フィールド名を含むオプションの文字列です。通常、フィールドの使用方法に関するメモ、ヘルプなどに使用されます。デフォルトはフィールド名です。

en: The value of the field.
ja: フィールドの値です。

en: An integer defining a large amount of properties of a field. Be careful when changing this attribute as this may change the field type.
ja: フィールドの多くのプロパティを定義する整数です。この属性を変更する際は注意してください。これはフィールドのタイプを変更する可能性があります。

en: A mandatory integer defining the field type. This is a value in the range of 0 to 6. It cannot be changed when updating the widget.
ja: フィールドタイプを定義する必須の整数です。これは0から6の範囲の値です。ウィジェットを更新する際に変更できません。

en: A string describing (and derived from) the field type.
ja: フィールドタイプを説明する文字列（フィールドタイプから派生）。

en: A list of up to 4 floats defining the field's background color.
ja: フィールドの背景色を定義する、最大4つの浮動小数点数のリスト。

en: The caption string of a button-type field.
ja: ボタンタイプのフィールドのキャプション文字列。

en: A bool indicating the signing status of a signature field, else *None*.
ja: 署名フィールドの署名ステータスを示すブール値。それ以外の場合は *None*。

en: The rectangle containing the field.
ja: フィールドを含む矩形。

en: A list of **1, 3 or 4 floats** defining the text color. Default value is black (`[0, 0, 0]`).
ja: テキストの色を定義する、**1、3、または4つの浮動小数点数** のリスト。デフォルト値は黒 (`[0, 0, 0]`)です。

en: A string defining the font to be used. Default and replacement for invalid values is *"Helv"*. For valid font reference names see the table below.
ja: 使用するフォントを定義する文字列。デフォルトおよび無効な値の置換は *「Helv」* です。有効なフォント参照名については以下の表を参照してください。

en: A float defining the text :data:`fontsize`. Default value is zero, which causes PDF viewer software to dynamically choose a size suitable for the annotation's rectangle and text amount.
ja: テキストの :data:`fontsize` を定義する浮動小数点数。デフォルト値はゼロで、PDFビューアソフトウェアが注釈の矩形とテキストの量に適したサイズを動的に選択します。

en: An integer defining the maximum number of text characters. PDF viewers will (should) not accept a longer text.
ja: テキストの最大文字数を定義する整数。PDFビューアは（するはずです）より長いテキストを受け入れません。

en: An integer defining acceptable text types (e.g. numeric, date, time, etc.). For reference only for the time being -- will be ignored when creating or updating widgets.
ja: 許容可能なテキストタイプを定義する整数（例：数値、日付、時刻など）。現時点では参考用のみで、ウィジェットを作成または更新する際には無視されます。

en: The PDF :data:`xref` of the widget.
ja: ウィジェットのPDF :data:`xref`。

en: New in version 1.16.12
ja: バージョン1.16.12で新登場

en: JavaScript text (unicode) for an action associated with the widget, or *None*. This is the only script action supported for **button type** widgets.
ja: ウィジェットに関連付けられたアクション用のJavaScriptテキスト（Unicode）、または *None*。これは **ボタンタイプ** のウィジェットに対してサポートされる唯一のスクリプトアクションです。

en: JavaScript text (unicode) to be performed when the user types a key-stroke into a text field or combo box or modifies the selection in a scrollable list box. This action can check the keystroke for validity and reject or modify it. *None* if not present.
ja: JavaScriptテキスト（Unicode）は、ユーザーがテキストフィールドまたはコンボボックスにキーストロークを入力するか、スクロール可能なリストボックスの選択を変更するときに実行されるアクションです。このアクションはキーストロークの妥当性をチェックし、拒否または変更することができます。存在しない場合は *None* です。

en: JavaScript text (unicode) to be performed before the field is formatted to display its current value. This action can modify the field’s value before formatting. *None* if not present.
ja: このアクションは、フィールドが現在の値を表示するためにフォーマットされる前に、フィールドの値を変更するために実行されるJavaScriptテキスト（Unicode）です。存在しない場合は *None* です。

en: JavaScript text (unicode) to be performed when the field’s value is changed. This action can check the new value for validity. *None* if not present.
ja: このアクションは、フィールドの値が変更されたときに実行されるJavaScriptテキスト（Unicode）です。このアクションは新しい値の妥当性をチェックすることができます。存在しない場合は *None* です。

en: New in version 1.22.6
ja: バージョン1.22.6で新規追加

en: JavaScript text (unicode) to be performed on losing the focus of this field. *None* if not present.
ja: このフィールドからフォーカスを失ったときに実行されるJavaScriptテキスト（Unicode）です。存在しない場合は *None* です。

en: JavaScript text (unicode) to be performed on focusing this field. *None* if not present.
ja: このフィールドにフォーカスが当たったときに実行されるJavaScriptテキスト（Unicode）です。存在しない場合は *None* です。

en: For **adding** or **changing** one of the above scripts,
ja: 上記のいずれかのスクリプトを **追加** または **変更** するには、

en: just put the appropriate JavaScript source code in the widget attribute. To **remove** a script, set the respective attribute to *None*.
ja: 適切なJavaScriptソースコードをウィジェット属性に配置するだけです。スクリプトを **削除する** には、該当する属性を *None* に設定します。

en: Other script entries will automatically be set to *None*.
ja: 他のスクリプトエントリは自動的に *None* に設定されます。

en: It is worthwhile to look at `this <https://experienceleague.adobe.com/docs/experience-manager-learn/assets/FormsAPIReference.pdf?lang=en>`_ manual with lots of information about Adobe's standard scripts for various field types. For example, if you want to add a text field representing a date, you may want to store the following scripts. They will ensure pattern-compatible date formats and display date pickers in supporting viewers::
ja: Adobeの標準スクリプトに関する多くの情報が含まれている `この <https://experienceleague.adobe.com/docs/experience-manager-learn/assets/FormsAPIReference.pdf?lang=en>`_ マニュアルを確認する価値があります。たとえば、日付を表すテキストフィールドを追加する場合、次のスクリプトを保存することができます。これにより、パターン互換の日付形式が確保され、サポートされているビューアで日付ピッカーが表示されます。

en: Standard Fonts for Widgets
ja: ウィジェット用の標準フォント

en: Widgets use their own resources object */DR*. A widget resources object must at least contain a */Font* object. Widget fonts are independent from page fonts. We currently support the 14 PDF base fonts using the following fixed reference names, or any name of an already existing field font. When specifying a text font for new or changed widgets, **either** choose one in the first table column (upper and lower case supported), **or** one of the already existing form fonts. In the latter case, spelling must exactly match.
ja: ウィジェットは独自のリソースオブジェクト */DR* を使用します。ウィジェットのリソースオブジェクトには、少なくとも */Font* オブジェクトを含める必要があります。ウィジェットフォントはページフォントとは独立しています。現在、以下の固定参照名を使用して、14のPDFベースフォントをサポートしています。また、既存のフィールドフォントの名前でもかまいません。新しいウィジェットまたは変更されたウィジェットのテキストフォントを指定する際には、最初の表の列（大文字と小文字がサポートされています）から1つを選択するか、既存のフォームフォントの1つを選択してください。後者の場合、スペルは厳密に一致する必要があります。

en: To find out already existing field fonts, inspect the list :attr:`Document.FormFonts`.
ja: 既存のフィールドフォントを見つけるには、リスト :attr:`Document.FormFonts` を調べてください。

en: **Reference**
ja: **参照**

en: **Base14 Fontname**
ja: **Base14フォント名**

en: Helvetica **(default)**
ja: Helvetica **(デフォルト)**

en: You are generally free to use any font for every widget. However, we recommend using *ZaDb* ("ZapfDingbats") and :data:`fontsize` 0 for check boxes: typical viewers will put a correctly sized tickmark in the field's rectangle, when it is clicked.
ja: 一般的に、すべてのウィジェットに任意のフォントを使用することができます。ただし、チェックボックスには *ZaDb* （「ZapfDingbats」）フォントと :data:`fontsize`  0を使用することをお勧めします。典型的なビューアは、フィールドの四角形をクリックすると正しくサイズ調整されたチェックマークを配置します。

en: Supported Widget Types
ja: 対応ウィジェットの種類

en: PyMuPDF supports the creation and update of many, but not all widget types.
ja: PyMuPDFは、多くのウィジェットタイプの作成および更新をサポートしていますが、すべてのウィジェットタイプには対応していません。

en: text (`PDF_WIDGET_TYPE_TEXT`)
ja: テキスト（`PDF_WIDGET_TYPE_TEXT`）

en: push button (`PDF_WIDGET_TYPE_BUTTON`)
ja: プッシュボタン（`PDF_WIDGET_TYPE_BUTTON`）

en: check box (`PDF_WIDGET_TYPE_CHECKBOX`)
ja: チェックボックス（`PDF_WIDGET_TYPE_CHECKBOX`）

en: combo box (`PDF_WIDGET_TYPE_COMBOBOX`)
ja: コンボボックス（`PDF_WIDGET_TYPE_COMBOBOX`）

en: list box (`PDF_WIDGET_TYPE_LISTBOX`)
ja: リストボックス（`PDF_WIDGET_TYPE_LISTBOX`）

en: radio button (`PDF_WIDGET_TYPE_RADIOBUTTON`): PyMuPDF does not currently support the **creation** of groups of (interconnected) radio buttons, where setting one automatically unsets the other buttons in the group. The widget object also does not reflect the presence of a button group. However: consistently selecting (or unselecting) a radio button is supported. This includes correctly setting the value maintained in the owning button group. Selecting a radio button may be done by either assigning `True` or `field.on_sate()` to the field value. **De-selecting** the button should be done assigning `False`.
ja: ラジオボタン（`PDF_WIDGET_TYPE_RADIOBUTTON`）：PyMuPDFは現在、ラジオボタンのグループ（相互に接続された）の **作成** をサポートしていません。つまり、1つを設定すると、グループ内の他のボタンが自動的に設定解除されるような状態を作成することはできません。また、ウィジェットオブジェクトはボタングループの存在を反映しません。ただし、ラジオボタンを一貫して選択（または選択解除）することはサポートされています。これには、所属するボタングループで維持される値を正しく設定することも含まれます。ラジオボタンを選択するには、フィールドの値に `True`  または `field.on_state()` を割り当てることができます。ボタンの選択解除は、`False` を割り当てることによって行う必要があります。

en: signature (`PDF_WIDGET_TYPE_SIGNATURE`) **read only**.
ja: 署名（`PDF_WIDGET_TYPE_SIGNATURE`）は **読み取り専用です** 。

en: Footnotes
ja: 脚注

en: If you intend to re-access a new or updated field (e.g. for making a pixmap), make sure to reload the page first. Either close and re-open the document, or load another page first, or simply do `page = doc.reload_page(page)`.
ja: 新しいまたは更新されたフィールドに再アクセスする意図がある場合（たとえば、ピクセルマップを作成する場合）、まずページを再読み込むことを確認してください。文書を閉じて再度開くか、別のページを読み込むか、または単に `page = doc.reload_page(page)` を実行してください
