:: com :: sun :: star :: drawing :: framework ::

unpublished interface XViewFactory
Description
Factory for creating and destroying views.

A factory may implement a cache for views as well.


Methods' Summary
createView Create a view for the given ResourceId that is to be displayed in the given pane. When the view is not used anymore then call releaseView() to release it.  
releaseView Call this method when a view is not in use anymore.  
Methods' Details
createView
XView
createView( [in] XResourceId  xViewId,
[in] ::com::sun::star::frame::XController  xController );

Description
Create a view for the given ResourceId that is to be displayed in the given pane. When the view is not used anymore then call releaseView() to release it.
Parameter xViewId
The resource URL specifies the type of view to create. Valid values are those for which the factory has previously been registered at the XViewController . The anchor specifies the pane in which to display the new view.
Parameter xController
The controller to which this view will be connected.
Returns
Returns a view object that has been newly created or was taken from a cache. When the requested view can not be created (or taken from a cache) then an empty reference is returned.
Throws
InvalidArgumentException when the given ResourceId is not supported by the factory or the reference to the XController is empty.
releaseView
void
releaseView( [in] XView  xView );

Description
Call this method when a view is not in use anymore.

The factory can decide whether to destroy the view object or to keep it in a cache for later reuse.

Parameter xView
The given view should be one created by the same factory. Providing another view object is an error.
Throws
InvalidArgumentException when the given view was not created by the same factory.
Top of Page