oracle.adfnmc.component.ui
Class Container

java.lang.Object
  oracle.adfnmc.component.Component
      oracle.adfnmc.component.ui.RenderableComponent
          oracle.adfnmc.component.ui.Control
              oracle.adfnmc.component.ui.Container

All Implemented Interfaces:

RefreshablePropertyObjectOwner, ITestableComponent

Direct Known Subclasses:

BasicContainer, Form, PanelGroupLayout, RootComponent, TableColumn, View

public abstract class Container
extends Control

Author:

terrykan

Field Summary

protected java.util.Vector	m_children
protected java.util.Hashtable	m_childrenById

Fields inherited from class oracle.adfnmc.component.ui.Control

bound, cloned, container, DEFAULT_BACKGROUNDCOLOR, DEFAULT_BOTTOM, DEFAULT_FOCUSED, DEFAULT_HEIGHT, DEFAULT_HEIGHT_STRING, DEFAULT_LEFT, DEFAULT_RIGHT, DEFAULT_TOP, DEFAULT_WIDTH, DEFAULT_WIDTH_STRING, embedded, has_x, has_y, m_alignProperty, m_availableHeight, m_availableWidth, m_backgroundColorProperty, m_cmpImpl, m_cookie, m_hasAlign, m_hasBackgroundColor, m_hasHeight, m_hasVerticalAlign, m_hasWidth, m_heightProperty, m_isClipped, m_isDirty, m_isHeightPercentage, m_isWidthPercentage, m_menuControls, m_multiRowContainerParent, m_tabstop, m_verticalAlignProperty, m_widthProperty, m_x, m_y, rownum

Fields inherited from class oracle.adfnmc.component.ui.RenderableComponent

DEFAULT_RENDERED, m_cachedRendered, m_cacheIsValid, m_renderedProperty, unregisterPropertiesOnly

Fields inherited from class oracle.adfnmc.component.Component

CLASS_INSTANCE, m_attributes, m_elContext, m_exprfactory, m_formatMethod, m_id, m_initialized, m_parent, m_pattern, m_props, m_screen, m_theApp, refreshableProperties

Constructor Summary

Container()

Method Summary

void	_addChild(Component child, boolean storeChild)
void	_removeChild(Component child)
void	addChild(Control child)
void	addChild(NonrenderableComponent child)
protected void	bindMenus()
boolean	containsId(java.lang.String id)
void	dump(java.lang.String indent)
void	dump(java.lang.String indent, java.util.Vector contents)
void	dumpAllData(java.lang.StringBuffer buffer)
void	endInit()
protected void	endInitChildren()
protected void	endInitRenderableProperties(boolean isRendered)
void	getAllDataValues(java.lang.StringBuffer buffer) Writes data values of this component and its m_children into the given buffer.
Component	getChildById(java.lang.String id)
java.util.Vector	getChildren()
Component	getComponentById(java.lang.String id)
Control	getCurrentFocus() Convenience method for getCurrentFocus(String).
Control	getCurrentFocus(java.lang.String id) Returns the control with given id from currently focused container or null if this container is not a parent of the focused control.
int	getDecorationHeight() Override for containers that apply spacing between controls or have scrollbars that consume height.
int	getDecorationWidth() Override for containers that apply spacing between controls or have scrollbars that consume width.
protected int	getIntraFieldSpacing() Override for containers that apply spacing between controls.
protected void	handleRenderedChange()
void	refreshProperties() Force any properties registered via propertyInstanceCreated to refresh themselves
void	removeChild(Control child)
void	removeChild(NonrenderableComponent child)
void	renderChildren(java.lang.Object uiparent)
protected void	renderedChangedNative()
void	setEmbedded(boolean value)
void	setMultiRowContainerParent(IMultiRowContainer parent)
void	setRowNum(int row)
void	shiftRowNum(int amount)
protected Control	UICloneImpl(java.lang.Class c)

Methods inherited from class oracle.adfnmc.component.ui.Control

addChild, addPropertyList, backgroundColorChanged, clipHeight, clipWidth, determineAvailableSpace, disposeProperties, endInitRendered, focusableChanged, gainedFocus, getAlign, getAlignNative, getAvailableHeight, getAvailableWidth, getBackgroundColor, getBackgroundColorNative, getBottom, getBottomNative, getControlDepth, getCookie, getDefaultFontFamily, getDefaultFontSize, getDefaultFontStyle, getEmbedded, getFocused, getFocusedNative, getHeight, getHeightNative, getLeft, getLeftNative, getMultiRowContainer, getNativeUiComponent, getParentHeightRecursively, getParentWidthRecursively, getRight, getRightNative, getRowNum, getTop, getTopNative, getVerticalAlign, getVerticalAlignNative, getWidth, getWidthNative, hasAlign, hasBackgroundColor, hasForegroundColor, hasHeight, hasLocation, hasVerticalAlign, hasWidth, inheritBackgroundColor, initCoreUIData, initGeometryData, isAllowedToReceiveFocus, isEmbeddedAndSelected, isLabeled, isNativeUiComponent, isNotRenderable, isWidthPercentage, markDirty, refreshUI, removeFromNativeParent, render, renderNative, setAlign, setAlign, setAlignNative, setBackgroundColor, setBackgroundColor, setBackgroundColorNative, setContainer, setCookie, setFocus, setHeight, setHeight, setHeightNative, setParent, setRenderProperties, setVerticalAlign, setVerticalAlign, setVerticalAlignNative, setWidth, setWidth, setWidthNative, shouldUseParentBackgroundColor, toString, UIClone, updateBackgroundColorNative

Methods inherited from class oracle.adfnmc.component.ui.RenderableComponent

execute, Focus, getRendered, isParentRendered, isRendered, isRenderedChanged, setRendered, setRendered, setUnregisterPropertiesOnly

Methods inherited from class oracle.adfnmc.component.Component

addChild, addChild, beginInit, buildValueExpression, dump, dumpProps, dumpProps, dumpPropsBuffer, getDataValues, getId, getParent, getProps, getScreen, propertyInstanceCreated, setChild, setChild, setId, setProp, setScreen, toFormattedString, updateRenderer

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

m_children

protected java.util.Vector m_children

m_childrenById

protected java.util.Hashtable m_childrenById

Constructor Detail

Container

public Container()

Method Detail

refreshProperties

public void refreshProperties()

Description copied from interface: RefreshablePropertyObjectOwner

Force any properties registered via propertyInstanceCreated to refresh themselves

Specified by:

refreshProperties in interface RefreshablePropertyObjectOwner

Overrides:

refreshProperties in class Component

renderChildren

public void renderChildren(java.lang.Object uiparent)

addChild

public void addChild(Control child)

addChild

public void addChild(NonrenderableComponent child)

_addChild

public void _addChild(Component child,
                      boolean storeChild)

removeChild

public void removeChild(NonrenderableComponent child)

Parameters:

child -

removeChild

public void removeChild(Control child)

Parameters:

child -

_removeChild

public void _removeChild(Component child)

Parameters:

child - - Must only be of class type Control or NonrenderableComponent, which are both based on class Component.

containsId

public boolean containsId(java.lang.String id)

getComponentById

public Component getComponentById(java.lang.String id)

dump

public void dump(java.lang.String indent)

Overrides:

dump in class Component

dump

public void dump(java.lang.String indent,
                 java.util.Vector contents)

handleRenderedChange

protected void handleRenderedChange()

Overrides:

handleRenderedChange in class RenderableComponent

renderedChangedNative

protected void renderedChangedNative()

Overrides:

renderedChangedNative in class RenderableComponent

endInitRenderableProperties

protected void endInitRenderableProperties(boolean isRendered)

Overrides:

endInitRenderableProperties in class Control

endInit

public void endInit()

Overrides:

endInit in class Control

endInitChildren

protected void endInitChildren()

bindMenus

protected void bindMenus()

Overrides:

bindMenus in class Control

setMultiRowContainerParent

public void setMultiRowContainerParent(IMultiRowContainer parent)

Overrides:

setMultiRowContainerParent in class Control

shiftRowNum

public void shiftRowNum(int amount)

Overrides:

shiftRowNum in class Control

setEmbedded

public void setEmbedded(boolean value)

Overrides:

setEmbedded in class Control

setRowNum

public void setRowNum(int row)

Overrides:

setRowNum in class Control

UICloneImpl

protected Control UICloneImpl(java.lang.Class c)

Overrides:

UICloneImpl in class Control

getChildById

public Component getChildById(java.lang.String id)

dumpAllData

public void dumpAllData(java.lang.StringBuffer buffer)

getChildren

public java.util.Vector getChildren()

getIntraFieldSpacing

protected int getIntraFieldSpacing()

Override for containers that apply spacing between controls.

Returns:

the spacing in pixels between controls

getDecorationWidth

public int getDecorationWidth()

Override for containers that apply spacing between controls or have scrollbars that consume width.

Returns:

the total horizontal spacing between all controls

getDecorationHeight

public int getDecorationHeight()

Override for containers that apply spacing between controls or have scrollbars that consume height.

Returns:

the total vertical spacing between all controls

getCurrentFocus

public Control getCurrentFocus()

Convenience method for getCurrentFocus(String).

Returns:

getCurrentFocus("")

getCurrentFocus

public Control getCurrentFocus(java.lang.String id)

Returns the control with given id from currently focused container or null if this container is not a parent of the focused control. Child classes should override this method since the default returns null.

Parameters:

id - requested control's id

Returns:

currently focused control or null

getAllDataValues

public void getAllDataValues(java.lang.StringBuffer buffer)

Writes data values of this component and its m_children into the given buffer. This is the recursive implementation of getDataValues().

Parameters:

buffer -