org.apache.tapestry.components
Class RenderBlock
java.lang.Object
org.apache.hivemind.impl.BaseLocatable
org.apache.tapestry.AbstractComponent
org.apache.tapestry.components.RenderBlock
- All Implemented Interfaces:
- org.apache.hivemind.Locatable, org.apache.hivemind.LocationHolder, IComponent, IRender
public abstract class RenderBlock
- extends AbstractComponent
Renders the text and components wrapped by a Block
component. [ Component Reference ]
It is possible for an RenderBlock to obtain a Block from a page other than the render
page. This works, even when the Block contains links, forms and form components. The action and
direct services will create URLs that properly address this situation.
However, because the rendering page can't know ahead of time about these foreign Blocks,
PageBeginRenderListener
and
PageEndRenderListener
methods (for components and objects of the
foreign page) via RenderBlock will not be executed. This specifically affects the
methods of the PageBeginRenderListener
and
PageEndRenderListener
interfaces.
Before rendering its Block
, RenderBlock will set itself as the Block's inserter, and
will reset the inserter after the Block
is rendered. This gives the components contained
in the Block
access to its inserted environment via the RenderBlock. In particular this
allows the contained components to access the informal parameters of the RenderBlock which
effectively allows parameters to be passed to the components contained in a Block.
- Author:
- Howard Lewis Ship
Methods inherited from class org.apache.tapestry.AbstractComponent |
addAsset, addBody, addComponent, checkActiveLock, cleanupAfterRender, enterActiveState, finishLoad, finishLoad, format, format, format, format, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getBody, getBodyCount, getComponent, getComponents, getContainedComponent, getContainer, getExtendedId, getId, getIdPath, getListeners, getMessage, getMessages, getNamespace, getPage, getProperty, getSpecification, isInActiveState, isParameterBound, isRendering, pageEndRender, prepareForRender, render, renderBody, renderInformalParameters, setBinding, setContainedComponent, setContainer, setId, setNamespace, setPage, setProperty, toString |
Methods inherited from class org.apache.hivemind.impl.BaseLocatable |
getLocation, setLocation |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.apache.hivemind.LocationHolder |
setLocation |
Methods inherited from interface org.apache.hivemind.Locatable |
getLocation |
RenderBlock
public RenderBlock()
renderComponent
protected void renderComponent(IMarkupWriter writer,
IRequestCycle cycle)
- If block is not null, then
Block.renderForComponent(IMarkupWriter, IRequestCycle, IComponent)
is invoked.
- Specified by:
renderComponent
in class AbstractComponent
getBlock
public abstract Block getBlock()