/// <summary>
/// Assigns waiting state to the tag at which given
/// <see cref="TagTreePointer"/>
/// points, associating it with the given
/// <see cref="System.Object"/>
/// . If current tag of the given
/// <see cref="TagTreePointer"/>
/// is already waiting, then after this method call
/// it's associated object will change to the one passed as the argument and the old one will not longer be
/// an associated object.
/// </summary>
/// <param name="pointerToTag">
/// a
/// <see cref="TagTreePointer"/>
/// pointing at a tag which is desired to be marked as waiting.
/// </param>
/// <param name="associatedObj">an object that is to be associated with the waiting tag. A null value is forbidden.
/// </param>
/// <returns>
/// the previous associated object with the tag if it has already had waiting state,
/// or null if it was not waiting tag.
/// </returns>
public virtual Object AssignWaitingState(TagTreePointer pointerToTag, Object associatedObj)
{
if (associatedObj == null)
{
throw new ArgumentException("Passed associated object can not be null.");
}
return(SaveAssociatedObjectForWaitingTag(associatedObj, pointerToTag.GetCurrentStructElem()));
}
/// <summary>
/// Gets
/// <see cref="iText.Kernel.Pdf.Tagging.PdfStructElem"/>
/// at which
/// <see cref="TagTreePointer"/>
/// points.
/// </summary>
/// <remarks>
/// Gets
/// <see cref="iText.Kernel.Pdf.Tagging.PdfStructElem"/>
/// at which
/// <see cref="TagTreePointer"/>
/// points.
/// <para />
/// NOTE: Be aware that
/// <see cref="iText.Kernel.Pdf.Tagging.PdfStructElem"/>
/// is a low level class, use it carefully,
/// especially in conjunction with high level
/// <see cref="TagTreePointer"/>
/// and
/// <see cref="TagStructureContext"/>
/// classes.
/// </remarks>
/// <param name="pointer">
/// a
/// <see cref="TagTreePointer"/>
/// which points at desired
/// <see cref="iText.Kernel.Pdf.Tagging.PdfStructElem"/>.
/// </param>
/// <returns>
/// a
/// <see cref="iText.Kernel.Pdf.Tagging.PdfStructElem"/>
/// at which given
/// <see cref="TagTreePointer"/>
/// points.
/// </returns>
public virtual PdfStructElem GetPointerStructElem(TagTreePointer pointer)
{
return(pointer.GetCurrentStructElem());
}
private PdfStructElem GetBackingElem()
{
return(pointerToBackingElem.GetCurrentStructElem());
}
public override AccessibilityProperties AddRef(TagTreePointer treePointer)
{
GetBackingElem().AddRef(treePointer.GetCurrentStructElem());
return(this);
}
