Combo box

コンボボックスは、PDF文書内のインタラクティブなフォームフィールドで、ドロップダウンリストとテキスト入力機能を組み合わせたものです。ユーザーは事前定義されたオプションから選択するか、独自の値を入力することができます。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているように、コンボボックスは選択フィールドの特定のタイプであり、提案された値のセットを維持しながらデータ入力の柔軟性を提供します。この二重の機能により、コンボボックスは標準オプションが推奨されるが、カスタム入力が必要になる可能性があるフォームに特に有用です。

コンボボックスは、PDFフォームにおける選択フィールドウィジェットで、事前定義されたオプションのドロップダウンリストをユーザーに提示しながら、同時に自由形式のテキスト入力を可能にします。複数の表示可能なオプションを表示し、スクロールが必要になる場合があるリストボックスとは異なり、コンボボックスはアクティブ化されるまで現在選択されている値のみを表示します。標準的なテキストフィールドとは異なり、コンボボックスはユーザー入力を誘導するための提案値を提供しますが、入力をそれらの提案のみに制限することはありません。コンボボックスの動作は、PDFフォームフィールドディクショナリ内の特定のフィールドフラグによって制御され、他の選択フィールドタイプと区別されます。コンボボックスフラグが設定されている場合、フィールドはリストからの選択に加えてキーボード入力を許可しますが、このフラグがない選択フィールドは選択のみ可能な標準的なリストボックスとして機能します。

PDFフォームソリューションを構築する開発者にとって、コンボボックスはデータ検証とユーザーの自由度のバランスを取る上で重要な柔軟性を提供します。これにより、アプリケーションは標準化された値を提案して—データの一貫性を向上させ、エラーを削減し—同時に、元の設計で想定されていなかった値をユーザーが入力する必要があるエッジケースに対応できます。これは、地域的な変動、進化する用語、またはユニークな状況がカスタムエントリを必要とする可能性がある、多様なユーザー層に展開されるフォームにとって特に重要です。 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) などの標準に準拠したアクセシブルなPDFフォームを実装する際、適切に構成されたコンボボックスにより、支援技術が利用可能なオプションとテキスト入力機能の両方を障害のあるユーザーに伝えることができます。コンボボックスの理解は、PDFライブラリを使用してインタラクティブなPDFフォームをプログラム的に作成、入力、またはデータを抽出する開発者にとって不可欠です。

コンボボックスは、PDF内でフィールドディクショナリとして実装され、FT（フィールドタイプ）エントリが選択フィールドを示す"Ch"に設定され、Ff（フィールドフラグ）エントリにComboフラグ（ビット18）が含まれています。フィールドディクショナリ内のOpt配列は、選択可能なオプションのリストを定義し、単純なテキスト文字列、またはエクスポート値と表示テキストをペアにした配列のいずれかになります。レンダリングされると、PDFビューアはコンボボックスを、ドロップダウンボタン付きの単一行テキストフィールドとして表示します。ドロップダウンをクリックすると、Opt配列からのオプションのリストが表示され、テキスト領域をクリックすると、直接キーボード入力が可能になります。V（値）エントリは、リストから選択されたものであれ、ユーザーが入力したものであれ、現在のフィールド値を格納します。追加のフラグで動作を変更できます：Editフラグは、選択のみのフィールドでテキスト入力を許可し、Sortフラグはオプションをアルファベット順に表示させます。コンボボックスの外観は、AP（appearance）ディクショナリと関連するウィジェット注釈によって制御され、デフォルトの外観特性は、フォント、サイズ、色のプロパティを指定するDA（default appearance）文字列によって定義されます。

• Choice field（選択フィールド） – 事前定義されたオプションから選択するためのフォームフィールドの親カテゴリ
• List box（リストボックス） – テキスト入力機能なしで複数の表示可能なオプションを表示する選択フィールド
• Text field（テキストフィールド） – 事前定義されたオプションなしで自由形式のテキスト入力を行うフォームフィールド
• Widget annotation（ウィジェット注釈） – PDF ページ上のインタラクティブなフォームフィールドの視覚的表現
• Form field dictionary（フォームフィールドディクショナリ） – インタラクティブフィールドのプロパティと動作を定義するPDFオブジェクト