StructTreeRoot

Struct StructTreeRoot 

Source
pub struct StructTreeRoot<'a> { /* private fields */ }
Expand description

Writer for a structure tree root dictionary. PDF 1.3+

This struct is created by Catalog::struct_tree_root.

Implementations§

Source§

impl StructTreeRoot<'_>

Source

pub fn child(&mut self, id: Ref) -> &mut Self

Write the /K attribute to reference the immediate child of this element.

Source

pub fn children(&mut self) -> TypedArray<'_, Ref>

Start writing the /K attribute to reference the immediate children of this element.

Source

pub fn id_tree(&mut self) -> NameTree<'_, Ref>

Start writing the /IDTree attribute to map element identifiers to their corresponding structure element objects. Required if any elements have element identifiers.

Source

pub fn parent_tree(&mut self) -> NumberTree<'_, Ref>

Start writing the /ParentTree attribute to maps structure elements to the content items they belong to. Required if any structure elements contain content items.

Source

pub fn parent_tree_next_key(&mut self, key: i32) -> &mut Self

Write the /ParentTreeNextKey attribute to specify the next available key for the /ParentTree dictionary.

Source

pub fn role_map(&mut self) -> RoleMap<'_>

Start writing the /RoleMap attribute to map structure element names to their approximate equivalents from the standard set of types. PDF 1.4+.

For PDF 2.0 documents, note that this mapping maps to the PDF 1.7 roles. For a namespace-aware role-mapping mechanism, see Namespace::role_map_ns.

Source

pub fn class_map(&mut self) -> ClassMap<'_>

Start writing the /ClassMap attribute to map objects designating attribute classes to their corresponding attribute objects or arrays thereof.

Source

pub fn namespaces(&mut self) -> TypedArray<'_, Ref>

Start writing the /Namespaces attribute to specify the namespaces occurring in the document. Required if namespaced structure types or attributes, including the standard namespace for PDF 2.0, are used. Create these dictionaries with Chunk::namespace PDF 2.0+.

Source

pub fn pronunciation_lexicon(&mut self) -> TypedArray<'_, Ref>

Start writing the PronunciationLexicon attribute to specify one or multiple pronunciation lexicons for the document. PDF 2.0+.

The lexicons shall be XML files conforming to the Pronunciation Lexicon Specification (PLS) Version 1.0. Each entry in the array is an indirect reference to a FileSpec dictionary for a lexicon file.

Source

pub fn associated_files(&mut self) -> TypedArray<'_, FileSpec<'_>>

Start writing the /AF attribute to specify one or multiple files associated with the entire structure tree. PDF 2.0+.

Methods from Deref<Target = Dict<'a>>§

Source

pub fn len(&self) -> i32

The number of written pairs.

Source

pub fn is_empty(&self) -> bool

Whether no pairs have been written so far.

Source

pub fn insert(&mut self, key: Name<'_>) -> Obj<'_>

Start writing a pair with an arbitrary value.

Source

pub fn pair<T: Primitive>(&mut self, key: Name<'_>, value: T) -> &mut Self

Write a pair with a primitive value.

This is a shorthand for dict.insert(key).primitive(value).

Source

pub fn pairs<'n, T: Primitive>( &mut self, pairs: impl IntoIterator<Item = (Name<'n>, T)>, ) -> &mut Self

Write a sequence of pairs with primitive values.

Trait Implementations§

Source§

impl<'a> Deref for StructTreeRoot<'a>

Source§

type Target = Dict<'a>

The resulting type after dereferencing.
Source§

fn deref(&self) -> &Self::Target

Dereferences the value.
Source§

impl<'a> DerefMut for StructTreeRoot<'a>

Source§

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.
Source§

impl<'a, 'any> Rewrite<'a> for StructTreeRoot<'any>

Source§

type Output = StructTreeRoot<'a>

The writer with the rewritten lifetime.
Source§

impl<'a> Writer<'a> for StructTreeRoot<'a>

Source§

fn start(obj: Obj<'a>) -> Self

Start writing the object.

Auto Trait Implementations§

§

impl<'a> Freeze for StructTreeRoot<'a>

§

impl<'a> RefUnwindSafe for StructTreeRoot<'a>

§

impl<'a> Send for StructTreeRoot<'a>

§

impl<'a> Sync for StructTreeRoot<'a>

§

impl<'a> Unpin for StructTreeRoot<'a>

§

impl<'a> !UnwindSafe for StructTreeRoot<'a>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> Finish for T

Source§

fn finish(self)

Does nothing but move self, equivalent to drop.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.