Class OptionalContentOrderArray

java.lang.Object
com.datalogics.PDFL.OptionalContentOrderNode
com.datalogics.PDFL.OptionalContentOrderArray

public class OptionalContentOrderArray extends OptionalContentOrderNode
Array node class for items in the OptionalContentConfig Order array. Items in the Order array can be arranged into a tree structure; subarrays within the parent array form 'branches' of the tree. Each OptionalContentOrderArray may contain OptionalContentOrderLeafs or OptionalContentOrderArrays in a specific order; this order determines how they will appear in the 'Layers' control of the viewer.

By placing OptionalContentOrderArrays into a higher-level array, branches can be added to the tree. The 'Title' property is a string that will appear next to the expand/collapse branch control in a PDF Viewer 'Layers' panel.

  • Constructor Details

    • OptionalContentOrderArray

      public OptionalContentOrderArray(Document doc)
      Create an OptionalContentOrderArray with no title.

      Parameters:
      doc - The Document this OptionalContentOrderArray is being created in
    • OptionalContentOrderArray

      public OptionalContentOrderArray(Document doc, String title)
      Create an OptionalContentOrderArray with a title.

      Parameters:
      doc - The Document this OptionalContentOrderArray is being created in
      title - The string which will appear in the Layer control panel
  • Method Details

    • delete

      public void delete()
      Overrides:
      delete in class OptionalContentOrderNode
    • getTitle

      public String getTitle()
      The title string of this Array. This title will appear next to the expand/collapse control in the 'Layers' panel of a PDF Viewer.

      This field may be set null to remove the title.

      Returns:
      The title string of this OptionalContentOrderArray.
    • setTitle

      public void setTitle(String title)
      The title string of this Array. This title will appear next to the expand/collapse control in the 'Layers' panel of a PDF Viewer.

      This field may be set null to remove the title.

      Parameters:
      title - The title string of this OptionalContentOrderArray.
    • getLength

      public int getLength()
      The number of OptionalContentOrderNodes in this array.
    • get

      public OptionalContentOrderNode get(int index)
      Returns the OptionalContentOrderNode at the given index.

      Parameters:
      index - The index at which to fetch an OptionalContentOrderNode.
      Returns:
      An OptionalContentOrderNode, or null if there is nothing at that index.
    • put

      public void put(int index, OptionalContentOrderNode node)
      Puts an OptionalContentOrderNode at the given index, replacing the existing item. The index can be greater than the current length of the array; the array will be extended and the empty slots filled with null objects.

      Parameters:
      index - The index at which to replace the existing Node
      node - The OptionalContentOrderNode to place in the Array
    • insert

      public void insert(int index, OptionalContentOrderNode node)
      Inserts an OptionalContentOrderNode at the given index, displacing existing objects. All objects following this will have their index increased by one.

      Parameters:
      index - The index at which to insert the Node
      node - The OptionalContentOrderNode to insert in the Array
    • add

      public void add(OptionalContentOrderNode node)
      Adds an OptionalContentOrderNode to the end of the Array.

      Parameters:
      node - The OptionalContentOrderNode to append to the Array
    • removeAt

      public void removeAt(int index)
      Removes the OptionalContentOrderNode at the given index. The length of the array is reduced by 1.

      Parameters:
      index - The index of the OptionalContentOrderNode to remove