:: com :: sun :: star :: frame ::

unpublished interface XModel2
Base Interfaces
XModel2XModel
   ┗ ::com::sun::star::lang::XComponent

XModel
(referenced interface's summary:)
represents a component which is created from an URL and arguments.
Description
extends interface XModel. The foloowing functions are added: - enumeration of all currently connected controller objects. (not getCurrentController() only, which depends on focus) - establish new view controller factory methods, which will make it possible to create new views for this model.

Methods' Summary
getControllers provides list of all currently connected controller objects.  
getAvailableViewControllerNames provides the available names of the factory to be used to create views.  
createDefaultViewController creates the default view instance for this model.  
createViewController creates a new view instance classified by the specified name and arguments.  
Methods' Details
getControllers
::com::sun::star::container::XEnumeration
getControllers();

Description
provides list of all currently connected controller objects.

Please note: Because this interface will might be used inside multi threaded environments those list can contain still disposed items or it new added controller will be missing (if they was added after this enumeration was created).

Returns
list of controller objects. Enumeration can be empty but not NULL.
getAvailableViewControllerNames
sequence< string >
getAvailableViewControllerNames();

Description
provides the available names of the factory to be used to create views.
Returns
sequence of all view names
See also
createView()
createDefaultViewController
XController
createDefaultViewController( [in] XFrame  Frame,
[out] ::com::sun::star::awt::XWindow  ComponentWindow )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::uno::Exception );

Description
creates the default view instance for this model.
Parameter Frame
used to place the new created view there
Parameter ComponentWindow
returns a suitable component window for the new created view controller
Returns
the new view controller instance @throw IllegalArgumentException if one of the given parameter was wrong @throw Exception if creation of a new view failed by other reasons
createViewController
XController
createViewController( [in] string  ViewName,
[in] sequence< ::com::sun::star::beans::PropertyValue >  Arguments,
[in] XFrame  Frame,
[out] ::com::sun::star::awt::XWindow  ComponentWindow )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::uno::Exception );

Description
creates a new view instance classified by the specified name and arguments.
Parameter ViewName
classified name of instance
Parameter Arguments
arguments used for creation
Parameter Frame
used to place the new created view there
Parameter ComponentWindow
returns a suitable component window for the new created view controller
Returns
the new view controller instance @throw IllegalArgumentException if one of the given parameter was wrong @throw Exception if creation of a new view failed by other reasons
Top of Page