Difference between revisions of "Treecontrol"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (Using the DefaultTreeCellRenderer)
m
Line 1: Line 1:
 
API Preview: file://x|/cl/awt/com/sun/star/awt/tree/module-ix.html
 
API Preview: file://x|/cl/awt/com/sun/star/awt/tree/module-ix.html
  
 +
See also an other documentation [[Going_further_with_Dialog_and_Component#The_New_Tree_Control|here]].
 
=== The tree control ===
 
=== The tree control ===
  

Revision as of 10:09, 14 July 2009

API Preview: file://x|/cl/awt/com/sun/star/awt/tree/module-ix.html

See also an other documentation here.

The tree control

The tree control model

The tree model

The tree control needs a tree model that stores the model information of the entries in the tree. You can provide your own mode which must at least support the interface com.sun.star.awt.XTreeModel. Or you can use the service DefaultTreeModel which manages a hirarchie of MutableTreeModels.

XTreeNode

Using the DefaultTreeModel

#define O(x) ::rtl::OUString( RTL_CONSTASCII_USTRINGPARAM( x ) )
 
Reference< ComponentContext > xCC(...);
Reference< XTreeControlModel > xTreeControlModel(...);
 
// create the root node with the text value "root node text"
 
Reference< XMutableTreeNode > xRootNode( MutableTreeNode::create2( xCC, Any( O( "root node text" ) ) ) );
 
// add two child nodes with text
xRootNode.appendChild( MutableTreeNode::create2( xCC, Any( O( "child 1" ) ) ) );
xRootNode.appendChild( MutableTreeNode::create2( xCC, Any( O( "child 2" ) ) ) );
 
// create the default tree model with the root node
Reference< XTreeModel > xDefaultTreeModel( DefaultTreeModel::create2( xCC, xRootNode ), UNO_QUERY );
 
// set the default model at the tree control model
xTreeControlModel->setTreeModel( xDefaultTreeModel );

The tree cell renderer

The DefaultTreeCellRenderer renders values with the following types:

  1. OUString
  2. sal_Int32, sal_Int16, double, sal_Bool
  3.  ::com::sun::star::awt::XBitmap
  4.  ::com::sun::star::graphics::XGraphic
  5.  ::com::sun::star::awt::XControlModel
  6. Sequence< T > where T is one of the supported types

Using the DefaultTreeCellRenderer

#define O(x) ::rtl::OUString( RTL_CONSTASCII_USTRINGPARAM( x ) )
 
Reference< ComponentContext > xCC(...);
Reference< XTreeControlModel > xTreeControlModel(...);
 
// create the default tree cell renderer and tell him to use images before nodes
Reference< XDefaultTreeCellRenderer > xDefaultRenderer( DefaultTreeCellRenderer::create( xCC ) );
xDefaultRenderer->setExpandedImageURL( O( "expand.png" ) );
xDefaultRenderer->setCollapsedImageURL( O( "collapsed.png" ) );
xDefaultRenderer->setLeafNodeImageURL( O( "leaf.png" ) );
 
// set the default cell renderer at the tree control model
xTreeControlModel->setCellRenderer( Reference< XTreeCellRenderer >( xDefaultTreeModel, UNO_QUERY ) );

The tree cell editor

The listeners

XTreeModelListener

XTreeSelectionListener

XTreeExpandListener

XTreeWillExpandListener

Personal tools