iText 8.0.2 API
iText.Kernel.Pdf.Tagutils.IRoleMappingResolver Interface Reference

A helper interface that facilitates roles mapping resolving for the tag structures that are defined for different PDF document specification versions. More...

Inherited by iText.Kernel.Pdf.Tagutils.RoleMappingResolver, and iText.Kernel.Pdf.Tagutils.RoleMappingResolverPdf2.

Public Member Functions

String  GetRole ()
  Defines the current role of the resolver. More...
 
PdfNamespace  GetNamespace ()
  Defines the namespace of the current role. More...
 
bool  CurrentRoleIsStandard ()
  Checks if the current role belongs to one of the standard structure namespaces. More...
 
bool  CurrentRoleShallBeMappedToStandard ()
  Checks if the current role and namespace are specified to be obligatory mapped to the standard structure namespace in order to be a valid role in the Tagged PDF. More...
 
bool  ResolveNextMapping ()
  Performs a mapping resolving "step". More...
 

Detailed Description

A helper interface that facilitates roles mapping resolving for the tag structures that are defined for different PDF document specification versions.

A helper interface that facilitates roles mapping resolving for the tag structures that are defined for different PDF document specification versions.

Be aware, that it is explicitly allowed for the document by the specification to have circular or transitive mappings.

Member Function Documentation

◆ CurrentRoleIsStandard()

bool iText.Kernel.Pdf.Tagutils.IRoleMappingResolver.CurrentRoleIsStandard ( )

Checks if the current role belongs to one of the standard structure namespaces.

Returns
true if the current namespace is a standard structure namespace and the current role is defined as standard role in it.

◆ CurrentRoleShallBeMappedToStandard()

bool iText.Kernel.Pdf.Tagutils.IRoleMappingResolver.CurrentRoleShallBeMappedToStandard ( )

Checks if the current role and namespace are specified to be obligatory mapped to the standard structure namespace in order to be a valid role in the Tagged PDF.

Returns
true, if the current role in the current namespace either belongs to the standard structure roles or is in the domain specific namespace; otherwise false.

◆ GetNamespace()

PdfNamespace iText.Kernel.Pdf.Tagutils.IRoleMappingResolver.GetNamespace ( )

Defines the namespace of the current role.

Returns
the iText.Kernel.Pdf.Tagging.PdfNamespace instance of the namespace dictionary wrapper. The role returned by the GetRole() method call is considered to belong to this namespace. Might be null, which means that role belongs to the default standard namespace.

◆ GetRole()

String iText.Kernel.Pdf.Tagutils.IRoleMappingResolver.GetRole ( )

Defines the current role of the resolver.

Defines the current role of the resolver. On every successful resolving "step" the role returned by this method changes in order to reflect the mapping of the previous role.

Returns
the System.String which identifies current role of the resolver.

◆ ResolveNextMapping()

bool iText.Kernel.Pdf.Tagutils.IRoleMappingResolver.ResolveNextMapping ( )

Performs a mapping resolving "step".

Performs a mapping resolving "step". Essentially finds the role and it's namespace to which the current role is mapped to. After this method call GetRole() and GetNamespace() methods might change their return value.

Returns
true if current role and/or namespace have changed their values; otherwise false which means that current role is not mapped.