:: 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
::com::sun::star::ucb::HierarchyContentProvider, ::com::sun::star::ucb::HierarchyFolderContent, ::com::sun::star::ucb::HierarchyLinkContent

Exported Interfaces
::com::sun::star::lang::XComponent
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::Content .
::com::sun::star::ucb::XContent
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::Content .
::com::sun::star::ucb::XCommandProcessor
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::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 )

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

Where many existing ::com::sun::star::ucb::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 ::com::sun::star::ucb::Content .
::com::sun::star::beans::XPropertyContainer
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::Content .
::com::sun::star::beans::XPropertySetInfoChangeNotifier
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::Content .
::com::sun::star::ucb::XCommandInfoChangeNotifier
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::Content .
::com::sun::star::container::XChild
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::Content .
::com::sun::star::ucb::XContentCreator
Description
This interface is implemented according to the specification of service ::com::sun::star::ucb::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 ::com::sun::star::ucb::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