PdfComboBoxField

Represents a combo box (drop-down list) form field in a PDF document. Combo boxes display a list of options and may optionally allow custom text entry.

from nutrient_sdk import PdfComboBoxField

Inherits from: PdfFormField

Construction

PdfComboBoxField cannot be instantiated directly. Obtain instances through static factory methods or via other SDK classes.

Methods

add_item

def add_item(self, text: str) -> None

def add_item(self, text: str, value: str) -> None

Adds an item to the combo box.

Parameters:

Name	Type	Description
`text`	`str`	The display text for the item.
`value` (optional)	`str`	The export value for the item.

Raises:

SdkException: Thrown when the operation fails.

remove_item_at

def remove_item_at(self, index: int) -> None

Removes an item from the combo box at the specified index.

Parameters:

Name	Type	Description
`index`	`int`	The 0-based index of the item to remove.

Raises:

IndexOutOfBoundsException: Thrown when index is out of range.
SdkException: Thrown when the operation fails.

Properties

has_selection

@property
def has_selection(self) -> bool

Whether the combo box has a value selected or entered.

Type: bool

Read-only property.

item_count

@property
def item_count(self) -> int

The number of items in the combo box.

Type: int

Read-only property.

selected_value

@property
def selected_value(self) -> str

@selected_value.setter
def selected_value(self, value: str) -> None

The currently selected or entered value.

Type: str

Inherited members

From PdfFormField: child, child_count, default_value, field_type, full_name, is_read_only, is_required, is_terminal, name, parent, value, widget, widget_count, remove_child_at