Package com.itextpdf.kernel.pdf.tagutils

Class AccessibilityProperties

java.lang.Object

com.itextpdf.kernel.pdf.tagutils.AccessibilityProperties

Direct Known Subclasses:

DefaultAccessibilityProperties

 public abstract class AccessibilityProperties extends Object 
      

The accessibility properties are used to define properties of structure elements in Tagged PDF documents via TagTreePointer API.

Constructor Summary

Constructors

Constructor	Description
AccessibilityProperties()

Method Summary

Modifier and Type	Method	Description
AccessibilityProperties	addAttributes(int index, PdfStructureAttributes attributes)	Adds the attributes to the element with specified index.
AccessibilityProperties	addAttributes(PdfStructureAttributes attributes)	Adds the attributes to the element.
AccessibilityProperties	addRef(TagTreePointer treePointer)	Adds the reference to other tagged element.
AccessibilityProperties	clearAttributes()	Clears the list of attributes.
AccessibilityProperties	clearRefs()	Clears the list of references to other tagged elements.
String	getActualText()	Gets the actual text of element.
String	getAlternateDescription()	Gets the alternate description of element.
List<PdfStructureAttributes>	getAttributesList()	Gets the attributes list.
String	getExpansion()	Gets the expansion of element.
String	getLanguage()	Gets the language identifier of element.
PdfNamespace	getNamespace()	Gets the namespace of element.
String	getPhoneme()	Gets the phoneme of element.
String	getPhoneticAlphabet()	Gets the phonetic alphabet of element.
List<TagTreePointer>	getRefsList()	Gets the list of references to other tagged elements.
String	getRole()	Gets the role of element.
byte[]	getStructureElementId()	Gets the associated structure element's ID string, if it has one.
AccessibilityProperties	setActualText(String actualText)	Sets the actual text of element.
AccessibilityProperties	setAlternateDescription(String alternateDescription)	Sets the alternate description of element.
AccessibilityProperties	setExpansion(String expansion)	Sets the expansion of element.
AccessibilityProperties	setLanguage(String language)	Sets the language identifier of element.
AccessibilityProperties	setNamespace(PdfNamespace namespace)	Sets the namespace of element.
AccessibilityProperties	setPhoneme(String phoneme)	Sets the phoneme of element.
AccessibilityProperties	setPhoneticAlphabet(String phoneticAlphabet)	Sets the phonetic alphabet of element.
AccessibilityProperties	setRole(String role)	Sets the role of element.
AccessibilityProperties	setStructureElementId(byte[] id)	Sets the associated structure element's ID.
AccessibilityProperties	setStructureElementIdString(String id)	Sets the associated structure element's ID.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

AccessibilityProperties

 public AccessibilityProperties() 
            

Method Details

getRole

 public String getRole() 
            

Gets the role of element.

See also StandardRoles.

Returns:

the role

setRole

 public AccessibilityProperties setRole 
             (String role) 
            

Sets the role of element.

See also StandardRoles.

Calling this method with a null argument will make the tagging on the associated layout element "neutral". The effect is that all children of the layout element will be tagged as if they were direct children of the parent element.

Parameters:

role - the role to be set

Returns:

this AccessibilityProperties instance

getLanguage

 public String getLanguage() 
            

Gets the language identifier of element. Should be in format xy-ZK (for example en-US).

For more information see PDF Specification ISO 32000-1 section 14.9.2.

Returns:

the language

setLanguage

 public AccessibilityProperties setLanguage 
             (String language) 
            

Sets the language identifier of element. Should be in format xy-ZK (for example en-US).

For more information see PDF Specification ISO 32000-1 section 14.9.2.

Parameters:

language - the language to be set

Returns:

this AccessibilityProperties instance

getActualText

 public String getActualText() 
            

Gets the actual text of element.

Returns:

the actual text

setActualText

 public AccessibilityProperties setActualText 
             (String actualText) 
            

Sets the actual text of element.

Parameters:

actualText - the actual text to be set

Returns:

this AccessibilityProperties instance

getAlternateDescription

 public String getAlternateDescription() 
            

Gets the alternate description of element.

Returns:

the alternate description

setAlternateDescription

 public AccessibilityProperties setAlternateDescription 
             (String alternateDescription) 
            

Sets the alternate description of element.

Parameters:

alternateDescription - the alternation description to be set

Returns:

this AccessibilityProperties instance

getExpansion

 public String getExpansion() 
            

Gets the expansion of element.

Expansion it is the expanded form of an abbreviation of structure element.

Returns:

the expansion

setExpansion

 public AccessibilityProperties setExpansion 
             (String expansion) 
            

Sets the expansion of element.

Expansion it is the expanded form of an abbreviation of structure element.

Parameters:

expansion - the expansion to be set

Returns:

this AccessibilityProperties instance

getPhoneme

 public String getPhoneme() 
            

Gets the phoneme of element.

For more information see PdfStructElem.setPhoneme(PdfString).

Returns:

the phoneme

setPhoneme

 public AccessibilityProperties setPhoneme 
             (String phoneme) 
            

Sets the phoneme of element.

For more information see PdfStructElem.setPhoneme(PdfString).

Parameters:

phoneme - the phoneme to be set

Returns:

this AccessibilityProperties instance

getPhoneticAlphabet

 public String getPhoneticAlphabet() 
            

Gets the phonetic alphabet of element.

For more information see PdfStructElem.setPhoneticAlphabet(PdfName).

Returns:

the phonetic alphabet

setPhoneticAlphabet

 public AccessibilityProperties setPhoneticAlphabet 
             (String phoneticAlphabet) 
            

Sets the phonetic alphabet of element.

For more information see PdfStructElem.setPhoneticAlphabet(PdfName).

Parameters:

phoneticAlphabet - the phonetic alphabet to be set

Returns:

this AccessibilityProperties instance

getNamespace

 public PdfNamespace getNamespace() 
            

Gets the namespace of element.

Returns:

the namespace

setNamespace

 public AccessibilityProperties setNamespace 
             (PdfNamespace namespace) 
            

Sets the namespace of element.

Parameters:

namespace - the namespace to be set

Returns:

this AccessibilityProperties instance

addRef

 public AccessibilityProperties addRef 
             (TagTreePointer treePointer) 
            

Adds the reference to other tagged element.

For more information see PdfStructElem.addRef(PdfStructElem).

Parameters:

treePointer - the reference to be set

Returns:

this AccessibilityProperties instance

getRefsList

 public List<TagTreePointer> getRefsList() 
            

Gets the list of references to other tagged elements.

For more information see PdfStructElem.addRef(PdfStructElem).

Returns:

the list of references

clearRefs

 public AccessibilityProperties clearRefs() 
            

Clears the list of references to other tagged elements.

For more information see PdfStructElem.addRef(PdfStructElem).

Returns:

this AccessibilityProperties instance

addAttributes

 public AccessibilityProperties addAttributes 
             (PdfStructureAttributes attributes) 
            

Adds the attributes to the element.

Parameters:

attributes - the attributes to be added

Returns:

this AccessibilityProperties instance

addAttributes

 public AccessibilityProperties addAttributes 
             (int index, PdfStructureAttributes attributes) 
            

Adds the attributes to the element with specified index.

If an attribute with the same O and NS entries is specified more than once, the later (in array order) entry shall take precedence. For more information see PDF Specification ISO-32000 section 14.7.6.

Parameters:

index - the attributes index

attributes - the attributes to be added

Returns:

this AccessibilityProperties instance

clearAttributes

 public AccessibilityProperties clearAttributes() 
            

Clears the list of attributes.

Returns:

this AccessibilityProperties instance

getAttributesList

 public List<PdfStructureAttributes> getAttributesList() 
            

Gets the attributes list.

Returns:

the attributes list

getStructureElementId

 public byte[] getStructureElementId() 
            

Gets the associated structure element's ID string, if it has one.

See also PdfStructElem.getStructureElementId().

Returns:

the structure element's ID string, or null if there is none

setStructureElementId

 public AccessibilityProperties setStructureElementId 
             (byte[] id) 
            

Sets the associated structure element's ID. Passing null removes the ID.

See also PdfStructElem.setStructureElementId(PdfString).

Parameters:

id - the element's ID to be set

Returns:

this AccessibilityProperties instance

setStructureElementIdString

 public AccessibilityProperties setStructureElementIdString 
             (String id) 
            

Sets the associated structure element's ID. Passing null removes the ID. If non-null, the argument will be encoded in UTF-8 (without BOM), since ID strings are considered binary data in PDF.

See also PdfStructElem.setStructureElementId(PdfString).

Parameters:

id - the element's ID to be set

Returns:

this AccessibilityProperties instance