Public Member Functions
def	AddNewTag (selected_tag_id, type, title)
	Add a new tag to the tag tree. More...

def	AddTagForAnnotation (is_tag_annotations, annot, page_index, selected_tag_id)
	Add tag for annotation. More...

def	ChangeTagToArtifact (selected_tag_ids, artifact_type, artifact_to_side)
	Change tag to artifact. More...

def	CreateTagFromSelectionByContent (selected_content_ids, selected_tag_id)
	Create tag from selection by content. More...

def	CreateTagFromSelectionByElement (page_index, selected_tag_id)
	Create tag from selection by element. More...

def	CreateTagFromSelectionByTag (selected_tag_ids, last_selected_tag_id)
	Create tag from selection by tag. More...

def	CreateTagFromSelectionByText (page_index, selected_text_rects, selected_tag_id)
	Create tag from selection by text. More...

def	DeleteEmptyTags (selected_tag_ids)
	Delete empty tags from the tag tree. More...

def	DeleteTags (selected_tag_ids)
	Delete specified tags from the tag tree. More...

def	FindTagFromSelection (selected_tag_ids)
	Find tag from selection. More...

def	GetAllContents (selected_tag_id)
	Get all contents of a specified tag item. More...

def	GetContentTreeItemIDsByTagItemID (selected_tag_id)
	Get content tree item IDs by tag item ID. More...

def	GetTagPropertyByID (item_id)
	Get tag property by tag item ID. More...

def	GetTagTree ()
	Get the tag tree of the current PDF document. More...

def	GetTagTreeContextMenuItems (input_data)
	Get context menu items for tag tree. More...

def	IsEmpty ()
	Check whether current object is empty or not. More...

def	MoveTags (source_tag_ids, dest_tag_id, is_moved_as_child)
	Move tags in the tag tree. More...

def	SetDocAsTaggedPDF ()
	Set the current PDF document as a tagged PDF. More...

def	SetTagPropertyActualText (item_id, actual_text)
	Set tag property actual text for a specified tag item. More...

def	SetTagPropertyAlternateText (item_id, alternate_text)
	Set tag property alternate text for a specified tag item. More...

def	SetTagPropertyID (item_id, id)
	Set tag property ID for a specified tag item. More...

def	SetTagPropertyLanguage (item_id, language)
	Set tag property language for a specified tag item. More...

def	SetTagPropertyTitle (item_id, title)
	Set tag property title for a specified tag item. More...

def	SetTagPropertyType (item_id, type)
	Set tag property type for a specified tag item. More...

Detailed Description

This class lets user edit the tag tree (structure tree) of a PDF document: query and modify tag properties, add / delete / move tags, create tags from selection, change tags to artifacts and mark the document as a tagged PDF. Before using any class or methods in this module, please ensure Foxit PDF SDK has been initialized successfully by function fsdk.LibraryInitialize with a key including "Accessibility" module.

See also: fsdk.Library

Member Function Documentation

◆ AddNewTag()

def fsdk.TagTreeEditor.AddNewTag	(	selected_tag_id,
		type,
		title
	)

Add a new tag to the tag tree.

Parameters

[in]	selected_tag_id	The selected tag ID as parent.
[in]	type	The tag type.
[in]	title	The tag title.

Returns: The updated tag tree item array.

◆ AddTagForAnnotation()

def fsdk.TagTreeEditor.AddTagForAnnotation	(	is_tag_annotations,
		annot,
		page_index,
		selected_tag_id
	)

Add tag for annotation.

Parameters

[in]	is_tag_annotations	Whether to tag annotations.
[in]	annot	The annotation object.
[in]	page_index	The page index. Valid range: from 0 to (count-1), where count is returned by function fsdk.PDFDoc.GetPageCount .
[in]	selected_tag_id	The selected tag ID.

Returns: The updated tag tree item array.

◆ ChangeTagToArtifact()

def fsdk.TagTreeEditor.ChangeTagToArtifact	(	selected_tag_ids,
		artifact_type,
		artifact_to_side
	)

Change tag to artifact.

Parameters

[in]	selected_tag_ids	The selected tag IDs.
[in]	artifact_type	The artifact type. Please refer to .
[in]	artifact_to_side	The artifact attach to side type. Please refer to .

Returns: true means success, while false means not.

◆ CreateTagFromSelectionByContent()

def fsdk.TagTreeEditor.CreateTagFromSelectionByContent	(	selected_content_ids,
		selected_tag_id
	)

Create tag from selection by content.

Parameters

[in]	selected_content_ids	The selected content IDs.
[in]	selected_tag_id	The selected tag ID.

Returns: The updated tag tree item array.

◆ CreateTagFromSelectionByElement()

def fsdk.TagTreeEditor.CreateTagFromSelectionByElement	(	page_index,
		selected_tag_id
	)

Create tag from selection by element.

Parameters

[in]	page_index	The page index. Valid range: from 0 to (count-1), where count is returned by function fsdk.PDFDoc.GetPageCount .
[in]	selected_tag_id	The selected tag ID.

Returns: The updated tag tree item array.

◆ CreateTagFromSelectionByTag()

def fsdk.TagTreeEditor.CreateTagFromSelectionByTag	(	selected_tag_ids,
		last_selected_tag_id
	)

Create tag from selection by tag.

Parameters

[in]	selected_tag_ids	The selected tag IDs.
[in]	last_selected_tag_id	The last selected tag ID.

Returns: The updated tag tree item array.

◆ CreateTagFromSelectionByText()

def fsdk.TagTreeEditor.CreateTagFromSelectionByText	(	page_index,
		selected_text_rects,
		selected_tag_id
	)

Create tag from selection by text.

Parameters

[in]	page_index	The page index. Valid range: from 0 to (count-1), where count is returned by function fsdk.PDFDoc.GetPageCount .
[in]	selected_text_rects	The selected text rectangles.
[in]	selected_tag_id	The selected tag ID.

Returns: The updated tag tree item array.

◆ DeleteEmptyTags()

def fsdk.TagTreeEditor.DeleteEmptyTags ( selected_tag_ids )

Delete empty tags from the tag tree.

Parameters

[in] selected_tag_ids The array of tag IDs to check for empty tags.

Returns: The updated tag tree item array.

◆ DeleteTags()

def fsdk.TagTreeEditor.DeleteTags ( selected_tag_ids )

Delete specified tags from the tag tree.

Parameters

[in] selected_tag_ids The array of tag IDs to delete.

Returns: The updated tag tree item array.

◆ FindTagFromSelection()

def fsdk.TagTreeEditor.FindTagFromSelection ( selected_tag_ids )

Find tag from selection.

Parameters

[in] selected_tag_ids The selected tag IDs.

Returns: The array of found tag IDs.

◆ GetAllContents()

def fsdk.TagTreeEditor.GetAllContents ( selected_tag_id )

Get all contents of a specified tag item.

Parameters

[in] selected_tag_id The selected tag ID.

Returns: The content text.

◆ GetContentTreeItemIDsByTagItemID()

def fsdk.TagTreeEditor.GetContentTreeItemIDsByTagItemID ( selected_tag_id )

Get content tree item IDs by tag item ID.

Parameters

[in] selected_tag_id The selected tag ID.

Returns: The array of content tree item IDs.

◆ GetTagPropertyByID()

def fsdk.TagTreeEditor.GetTagPropertyByID ( item_id )

Get tag property by tag item ID.

Parameters

[in] item_id The tag item ID, obtained from fsdk.TagTreeItemData.GetItem_id of items returned by fsdk.TagTreeEditor.GetTagTree .

Returns: The tag property object.

Note: The tag item referenced by item_id must be a structure element (fsdk.TagTreeItemDataE_TagNodeTypeElement ) node. Reference-type nodes such as marked content (fsdk.TagTreeItemDataE_TagNodeTypeMarkedContentSeq ) or object reference (fsdk.TagTreeItemDataE_TagNodeTypeObject ) do not carry this property and will cause the call to fail.

◆ GetTagTree()

def fsdk.TagTreeEditor.GetTagTree ( )

Get the tag tree of the current PDF document.

Returns: The tag tree item array.

◆ GetTagTreeContextMenuItems()

def fsdk.TagTreeEditor.GetTagTreeContextMenuItems ( input_data )

Get context menu items for tag tree.

Parameters

[in] input_data The input data for context menu.

Returns: The array of menu item data.

◆ IsEmpty()

def fsdk.TagTreeEditor.IsEmpty ( )

Check whether current object is empty or not.

When the current object is empty, that means current object is useless.

Returns: true means current object is empty, while false means not.

◆ MoveTags()

def fsdk.TagTreeEditor.MoveTags	(	source_tag_ids,
		dest_tag_id,
		is_moved_as_child
	)

Move tags in the tag tree.

Parameters

[in]	source_tag_ids	The source tag IDs to move.
[in]	dest_tag_id	The destination tag ID.
[in]	is_moved_as_child	Whether to move as child of destination.

Returns: The updated tag tree item array.

◆ SetDocAsTaggedPDF()

def fsdk.TagTreeEditor.SetDocAsTaggedPDF ( )

Set the current PDF document as a tagged PDF.

Returns: true means success, while false means not.

◆ SetTagPropertyActualText()

def fsdk.TagTreeEditor.SetTagPropertyActualText	(	item_id,
		actual_text
	)

Set tag property actual text for a specified tag item.

Parameters

[in]	item_id	The tag item ID, obtained from fsdk.TagTreeItemData.GetItem_id of items returned by fsdk.TagTreeEditor.GetTagTree .
[in]	actual_text	The actual text to set.

Returns: true means success, while false means not.

Note: The tag item referenced by item_id must be a structure element (fsdk.TagTreeItemDataE_TagNodeTypeElement ) node. Reference-type nodes such as marked content (fsdk.TagTreeItemDataE_TagNodeTypeMarkedContentSeq ) or object reference (fsdk.TagTreeItemDataE_TagNodeTypeObject ) do not carry this property and will cause the call to fail.

◆ SetTagPropertyAlternateText()

def fsdk.TagTreeEditor.SetTagPropertyAlternateText	(	item_id,
		alternate_text
	)

Set tag property alternate text for a specified tag item.

Parameters

[in]	item_id	The tag item ID, obtained from fsdk.TagTreeItemData.GetItem_id of items returned by fsdk.TagTreeEditor.GetTagTree .
[in]	alternate_text	The alternate text to set.

Returns: true means success, while false means not.

Note: The tag item referenced by item_id must be a structure element (fsdk.TagTreeItemDataE_TagNodeTypeElement ) node. Reference-type nodes such as marked content (fsdk.TagTreeItemDataE_TagNodeTypeMarkedContentSeq ) or object reference (fsdk.TagTreeItemDataE_TagNodeTypeObject ) do not carry this property and will cause the call to fail.

◆ SetTagPropertyID()

def fsdk.TagTreeEditor.SetTagPropertyID	(	item_id,
		id
	)

Set tag property ID for a specified tag item.

Parameters

[in]	item_id	The tag item ID, obtained from fsdk.TagTreeItemData.GetItem_id of items returned by fsdk.TagTreeEditor.GetTagTree .
[in]	id	The ID to set.

Returns: true means success, while false means not.

Note: The tag item referenced by item_id must be a structure element (fsdk.TagTreeItemDataE_TagNodeTypeElement ) node. Reference-type nodes such as marked content (fsdk.TagTreeItemDataE_TagNodeTypeMarkedContentSeq ) or object reference (fsdk.TagTreeItemDataE_TagNodeTypeObject ) do not carry this property and will cause the call to fail.

◆ SetTagPropertyLanguage()

def fsdk.TagTreeEditor.SetTagPropertyLanguage	(	item_id,
		language
	)

Set tag property language for a specified tag item.

Parameters

[in]	item_id	The tag item ID, obtained from fsdk.TagTreeItemData.GetItem_id of items returned by fsdk.TagTreeEditor.GetTagTree .
[in]	language	The language to set.

Returns: true means success, while false means not.

Note: The tag item referenced by item_id must be a structure element (fsdk.TagTreeItemDataE_TagNodeTypeElement ) node. Reference-type nodes such as marked content (fsdk.TagTreeItemDataE_TagNodeTypeMarkedContentSeq ) or object reference (fsdk.TagTreeItemDataE_TagNodeTypeObject ) do not carry this property and will cause the call to fail.

◆ SetTagPropertyTitle()

def fsdk.TagTreeEditor.SetTagPropertyTitle	(	item_id,
		title
	)

Set tag property title for a specified tag item.

Parameters

[in]	item_id	The tag item ID, obtained from fsdk.TagTreeItemData.GetItem_id of items returned by fsdk.TagTreeEditor.GetTagTree .
[in]	title	The tag title to set.

Returns: true means success, while false means not.

Note: The tag item referenced by item_id must be a structure element (fsdk.TagTreeItemDataE_TagNodeTypeElement ) node. Reference-type nodes such as marked content (fsdk.TagTreeItemDataE_TagNodeTypeMarkedContentSeq ) or object reference (fsdk.TagTreeItemDataE_TagNodeTypeObject ) do not carry this property and will cause the call to fail.

◆ SetTagPropertyType()

def fsdk.TagTreeEditor.SetTagPropertyType	(	item_id,
		type
	)

Set tag property type for a specified tag item.

Parameters

[in]	item_id	The tag item ID, obtained from fsdk.TagTreeItemData.GetItem_id of items returned by fsdk.TagTreeEditor.GetTagTree .
[in]	type	The tag type to set.

Returns: true means success, while false means not.

Note: The tag item referenced by item_id must be a structure element (fsdk.TagTreeItemDataE_TagNodeTypeElement ) node. Reference-type nodes such as marked content (fsdk.TagTreeItemDataE_TagNodeTypeMarkedContentSeq ) or object reference (fsdk.TagTreeItemDataE_TagNodeTypeObject ) do not carry this property and will cause the call to fail.

Public Member Functions

Detailed Description

Member Function Documentation

◆ AddNewTag()

◆ AddTagForAnnotation()

◆ ChangeTagToArtifact()

◆ CreateTagFromSelectionByContent()

◆ CreateTagFromSelectionByElement()

◆ CreateTagFromSelectionByTag()

◆ CreateTagFromSelectionByText()

◆ DeleteEmptyTags()

◆ DeleteTags()

◆ FindTagFromSelection()

◆ GetAllContents()

◆ GetContentTreeItemIDsByTagItemID()

◆ GetTagPropertyByID()

◆ GetTagTree()

◆ GetTagTreeContextMenuItems()

◆ IsEmpty()

◆ MoveTags()

◆ SetDocAsTaggedPDF()

◆ SetTagPropertyActualText()

◆ SetTagPropertyAlternateText()

◆ SetTagPropertyID()

◆ SetTagPropertyLanguage()

◆ SetTagPropertyTitle()

◆ SetTagPropertyType()