:: com :: sun :: star :: ucb ::

service HierarchyRootFolderContent
Description
A HCP Root Folder is the root container for all other HCP Folders and HCP Links.

It always has the URL "vnd.sun.star.hier:/". A HCP Root Folder neither can't be created nor deleted by a UCB client.

See also
HierarchyContentProvider, HierarchyFolderContent, HierarchyLinkContent

Exported Interfaces
::com::sun::star::lang::XComponent
Description
This interface is implemented according to the specification of service Content .
XContent
Description
This interface is implemented according to the specification of service Content .
XCommandProcessor
Description
This interface is implemented according to the specification of service Content .

Supported Commands

  • getCommandInfo
  • getPropertySetInfo
  • getPropertyValues
  • setPropertyValues
  • open
  • transfer ( only transfers from one hierarchy folder to another supported )
Supported Properties
  • string ContentType ( read-only, always "application/vnd.sun.star.hier-folder" )
  • boolean IsDocument ( read-only, always false )
  • boolean IsFolder ( read-only, always true )
  • string Title ( read-only, always an empty string )

XCommandProcessor2
Usage Restrictions
optional
Description
is an enhanced version of XCommandProcessor that has an additional method for releasing command identifiers obtained via XCommandProcessor::createCommandIdentifier to avoid resource leaks. For a detailed description of the problem refer to XCommandProcessor2::releaseCommandIdentifier .

Where many existing Content implementations do not (yet), every new implementation should support this interface.

::com::sun::star::beans::XPropertiesChangeNotifier
Description
This interface is implemented according to the specification of service Content .
::com::sun::star::beans::XPropertyContainer
Description
This interface is implemented according to the specification of service Content .
::com::sun::star::beans::XPropertySetInfoChangeNotifier
Description
This interface is implemented according to the specification of service Content .
XCommandInfoChangeNotifier
Description
This interface is implemented according to the specification of service Content .
::com::sun::star::container::XChild
Description
This interface is implemented according to the specification of service Content .
XContentCreator
Description
This interface is implemented according to the specification of service Content .

A HCP Root Folder can create HCP Folders and HCP Links. To create a new child of a HCP Root Folder:

  1. Let the parent folder create a new content by calling XContentCreator::createNewContent on it. The content type to use for new folders is "application/vnd.sun.star.hier-folder". To create a new link, use the type "application/vnd.sun.star.hier-link".
  2. Set a title at the new folder / link. ( Let the new child execute the command "setPropertyValues", which sets at least the property "Title" to a non-empty value ). For a link, you need to set the property "TargetURL" as well to a non-empty value.
  3. Let the new child ( not the parent! ) execute the command "insert". This will commit the creation process.


 
Top of Page