public class PreRenderViewEvent extends ComponentSystemEvent
When an instance of this event is passed
to SystemEventListener.processEvent(javax.faces.event.SystemEvent)
or ComponentSystemEventListener.processEvent(javax.faces.event.ComponentSystemEvent)
, the listener
implementation may assume that the source
of this event
instance is the UIViewRoot
instance that is about to be
rendered.
It is valid for a listener for this event to change the UIViewRoot
in the current FacesContext
,
but the listener must ensure that the new UIViewRoot
was
created with a call to ViewHandler.createView(javax.faces.context.FacesContext, java.lang.String)
, and that the view is
fully populated with the children to be traversed during render. The
listener implementation may call ViewDeclarationLanguage.buildView(javax.faces.context.FacesContext, javax.faces.component.UIViewRoot)
to populate
the UIViewRoot
.
source
Constructor and Description |
---|
PreRenderViewEvent(UIViewRoot root)
Instantiate a new
|
getComponent, isAppropriateListener, processListener
getSource, toString
public PreRenderViewEvent(UIViewRoot root)
Instantiate a new
PreRenderViewEvent
that indicates the argument
root
is about to be rendered.
root
- the UIViewRoot
that is about to be
rendered.IllegalArgumentException
- if the argument is null
.Copyright © 1996-2013, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.