Struct ComboBox 

pub struct ComboBox {
    pub name: String,
    pub options: Vec<(String, String)>,
    pub value: Option<String>,
    pub selected: Option<usize>,
    pub editable: bool,
    pub default_appearance: Option<DefaultAppearance>,
}

Combo box field

Fields

name: String

Field name

options: Vec<(String, String)>

Options (export value, display text)

value: Option<String>

Current value

selected: Option<usize>

Selected index

editable: bool

Whether custom text entry is allowed

default_appearance: Option<DefaultAppearance>

Typed /DA (default appearance) — drives the font/size/colour used to regenerate the field’s /AP/N when Document::fill_field is called. When None, fill_field falls back to Helvetica + WinAnsi (which fails for any non-WinAnsi value — see issue #212).

Implementations

impl ComboBox

pub fn new(name: impl Into<String>) -> Self

Create a new combo box

pub fn with_default_appearance( self, font: Font, font_size: f64, color: Color, ) -> Self

Attach a typed /DA so Document::fill_field knows which font to pick when regenerating this combo box’s /AP/N stream.

Mirrors TextField::with_default_appearance. Selecting a custom Type0/CID font here is the only path today that lets fill_field emit a correct appearance for non-WinAnsi values (CJK, Arabic, non-WinAnsi Latin) — the default built-in Helvetica cannot render those and fill_field will otherwise return PdfError::EncodingError. See issue #212.

The font must be registered on the Document via add_font_from_bytes if it’s a Font::Custom(_).

pub fn add_option( self, export_value: impl Into<String>, display: impl Into<String>, ) -> Self

Add an option

pub fn editable(self) -> Self

Enable editing

pub fn with_value(self, value: impl Into<String>) -> Self

Set value

pub fn with_selected(self, index: usize) -> Self

Set selected option by index

pub fn to_dict(&self) -> Dictionary

Convert to field dictionary

Trait Implementations

impl Clone for ComboBox

fn clone(&self) -> ComboBox

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ComboBox

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.