:: 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
- 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
Copyright © 2011 Sun Microsystems, Inc.