LibreOffice Module slideshow (master) 1
Public Member Functions | Protected Member Functions | List of all members
slideshow::internal::DocTreeNodeSupplier Class Referenceabstract

Interface to retrieve DocTreeNodes from subsettable shapes. More...

#include <doctreenodesupplier.hxx>

Inheritance diagram for slideshow::internal::DocTreeNodeSupplier:
[legend]

Public Member Functions

virtual sal_Int32 getNumberOfTreeNodes (DocTreeNode::NodeType eNodeType) const =0
 Query number of tree nodes of the given type this shape contains. More...
 
virtual DocTreeNode getTreeNode (sal_Int32 nNodeIndex, DocTreeNode::NodeType eNodeType) const =0
 Create DocTreeNode from shape. More...
 
virtual sal_Int32 getNumberOfSubsetTreeNodes (const DocTreeNode &rParentNode, DocTreeNode::NodeType eNodeType) const =0
 Query number of tree nodes of the given type this subset contains. More...
 
virtual DocTreeNode getSubsetTreeNode (const DocTreeNode &rParentNode, sal_Int32 nNodeIndex, DocTreeNode::NodeType eNodeType) const =0
 Create DocTreeNode from shape subset. More...
 

Protected Member Functions

 ~DocTreeNodeSupplier ()
 

Detailed Description

Interface to retrieve DocTreeNodes from subsettable shapes.

Shapes which implement the AttributableShape interface also provides this interface, providing methods to retrieve specific DocTreeNode objects from the shape. The methods mainly distinguish various ways on how to specify the actual DocTreeNode to return.

If a requested DocTreeNode is not available when one of the methods below is called, an empty DocTreeNode will be returned (the predicate DocTreeNode::isEmpty() will return true). If, on the other hand, the shape cannot determine, for internal reasons, the internal tree node structure, all those methods will throw an ShapeLoadFailedException. This is, in fact, a delayed error that could also have been reported during shape construction, but might be postponed until the missing information is actually requested.

Definition at line 50 of file doctreenodesupplier.hxx.

Constructor & Destructor Documentation

◆ ~DocTreeNodeSupplier()

slideshow::internal::DocTreeNodeSupplier::~DocTreeNodeSupplier ( )
inlineprotected

Definition at line 138 of file doctreenodesupplier.hxx.

Member Function Documentation

◆ getNumberOfSubsetTreeNodes()

virtual sal_Int32 slideshow::internal::DocTreeNodeSupplier::getNumberOfSubsetTreeNodes ( const DocTreeNode rParentNode,
DocTreeNode::NodeType  eNodeType 
) const
pure virtual

Query number of tree nodes of the given type this subset contains.

The value returned by this method minus one is the maximum value permissible at the getSubsetTreeNode() method, for the given node type.

Parameters
rParentNodeThe parent node, below which the number of tree nodes of the given type shall be counted.
eNodeTypeNode type to count.
Exceptions
ShapeLoadFailedException,iftree node structure cannot be determined.

Implemented in slideshow::internal::DrawShape.

◆ getNumberOfTreeNodes()

virtual sal_Int32 slideshow::internal::DocTreeNodeSupplier::getNumberOfTreeNodes ( DocTreeNode::NodeType  eNodeType) const
pure virtual

Query number of tree nodes of the given type this shape contains.

The value returned by this method minus one is the maximum value permissible at the getTreeNode() method, for the given node type.

Exceptions
ShapeLoadFailedException,iftree node structure cannot be determined.

Implemented in slideshow::internal::DrawShape.

◆ getSubsetTreeNode()

virtual DocTreeNode slideshow::internal::DocTreeNodeSupplier::getSubsetTreeNode ( const DocTreeNode rParentNode,
sal_Int32  nNodeIndex,
DocTreeNode::NodeType  eNodeType 
) const
pure virtual

Create DocTreeNode from shape subset.

This method creates a DocTreeNode from a shape, a parent tree node, a given node type and a running index into the shape's DocTreeNodes of the given type.

Parameters
rParentNodeParent node, below which the tree node with the given type shall be selected.
nNodeIndexStarting with 0, every DocTreeNode of the shape that has type eNodeType is indexed. The DocTreeNode whose index equals nNodeIndex will be returned.
eNodeTypeType of the node to return
Returns
the DocTreeNode found, or the empty DocTreeNode, if nothing was found.
Exceptions
ShapeLoadFailedException,iftree node structure cannot be determined.

Implemented in slideshow::internal::DrawShape.

◆ getTreeNode()

virtual DocTreeNode slideshow::internal::DocTreeNodeSupplier::getTreeNode ( sal_Int32  nNodeIndex,
DocTreeNode::NodeType  eNodeType 
) const
pure virtual

Create DocTreeNode from shape.

This method creates a DocTreeNode from a shape, a given node type and a running index into the shape's DocTreeNodes of the given type.

Parameters
nNodeIndexStarting with 0, every DocTreeNode of the shape that has type eNodeType is indexed. The DocTreeNode whose index equals nNodeIndex will be returned.
eNodeTypeType of the node to return
Returns
the DocTreeNode found, or the empty DocTreeNode, if nothing was found.
Exceptions
ShapeLoadFailedException,iftree node structure cannot be determined.

Implemented in slideshow::internal::DrawShape.


The documentation for this class was generated from the following file: