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