Oracle Blog

Tips and Tricks from Oracle's JDeveloper & ADF QA

Tuesday Jan 31, 2012

Panel Collection in ADF (af:panelCollection) has an attribute - featureOff, which manages the visibility of certain controls / features of panelCollection to the end user.

As per the doc guide, here are the list of valid values for this attribute.

Value

Turns off

statusBar

Status bar

viewMenu

'View' menu

formatMenu

'Format' menu

columnsMenuItem

'Columns' sub-menu item

columnsMenuItem:col1,col20

Columns with column ID: 'col1' and 'col20' inside 'Columns' sub-menu

freezeMenuItem

'Freeze' menu item

detachMenuItem

'Detach' menu item

sortMenuItem

'Sort' menu item

reorderColumnsMenuItem

'Reorder Columns' menu item

resizeColumnsMenuItem

'Resize Columns' menu item

wrapMenuItem

'Wrap' menu item

showAsTopMenuItem

Tree/TreeTable 'Show As Top' menu item

scrollToFirstMenuItem

Tree/TreeTable 'Scroll To First' menu item

scrollToLastMenuItem

Tree/TreeTable 'Scroll To Last' menu item

freezeToolbarItem

'Freeze' toolbar item

detachToolbarItem

'Detach' toolbar item

wrapToolbarItem

'Wrap' toolbar item

showAsTopToolbarItem

Tree/TreeTable 'Show As Top' toolbar item

wrap

'Wrap' menu and toolbar items

freeze

'Freeze' menu and toolbar items

detach

'Detach' menu and toolbar items

In this
article, we will find out what happens at runtime when different values
are specified for this attribute (Note : This attribute takes a
space-separated list of default features to be turned off for the
panelCollection - as mentioned above)

1. statusBar

<af:panelCollection id="pc1" featuresOff="statusBar">

When we set statusBar to the featuresOff attribute, it hides panelCollection's status bar.

2. viewMenu

<af:panelCollection id="pc1" featuresOff="viewMenu">

When we set viewMenu to the featuresOff attribute, it completely removes the View Menu.

3. formatMenu

<af:panelCollection id="pc1" featuresOff="formatMenu">

When we set formatMenu to the featuresOff attribute, it completely removes the Format Menu.

4. columnsMenuItem

<af:panelCollection id="pc1" featuresOff="columnsMenuItem">

When we set columnsMenuItem to the featuresOff attribute, it removes the
Columns menu item under View menu. Check the next option to hide
specific columns.

5. columnsMenuItem:col1,col20

<af:panelCollection id="pc1" featuresOff="columnsMenuItem:col1,col2">

When we set columnsMenuItem:.. to the featuresOff attribute, it removes
the specified columns from the Columns menu item under View menu. If you
want to hide the entire Columns menu item, check the previous option.

In the above example image, columns c3 and c4 belong to the columns Empno and Ename.

6. freezeMenuItem

<af:panelCollection id="pc1" featuresOff="freezeMenuItem">

When we set freezeMenuItem to the featuresOff attribute, it removes Freeze menu item under View menu .

7. detachMenuItem

<af:panelCollection id="pc1" featuresOff="detachMenuItem">

When we set detachMenuItem to the featuresOff attribute, it removes Detach menu item under View menu .

8. sortMenuItem

<af:panelCollection id="pc1" featuresOff="sortMenuItem">

When we set sortMenuItem to the featuresOff attribute, it removes entire Sort menu item under View menu .

9. reorderColumnsMenuItem

<af:panelCollection id="pc1" featuresOff="reorderColumnsMenuItem">

When we set reorderColumnsMenuItem to the featuresOff attribute, it removes Reorder Columns... menu item under View menu .

10. resizeColumnsMenuItem

<af:panelCollection id="pc1" featuresOff="resizeColumnsMenuItem">

When we set resizeColumnsMenuItem to the featuresOff attribute, it removes Resize Columns... menu item under Format menu .

11. wrapMenuItem

<af:panelCollection id="pc1" featuresOff="wrapMenuItem">

When we set wrapMenuItem to the featuresOff attribute, it removes Wrap menu item under Format menu .

12. showAsTopMenuItem

<af:panelCollection id="pc1" featuresOff="showAsTopMenuItem">

When we set showAsTopMenuItem to the featuresOff attribute, it removes
Show as Top and Go to Top menu items under View menu (Applicable for the
tree/treeTable) .

13. scrollToFirstMenuItem

<af:panelCollection id="pc1" featuresOff="scrollToFirstMenuItem">

When we set scrollToFirstMenuItem to the featuresOff attribute, it
removes Scroll to First menu item under View menu (Applicable for the
tree/treeTable) .

14. scrollToLastMenuItem

<af:panelCollection id="pc1" featuresOff="scrollToLastMenuItem">

When we set scrollToLastMenuItem to the featuresOff attribute, it
removes Scroll to Last menu item under View menu (Applicable for the
tree/treeTable) .

15. freezeToolbarItem

<af:panelCollection id="pc1" featuresOff="freezeToolbarItem">

When we set freezeToolbarItem to the featuresOff attribute, it
removes Freeze button from the Toolbar.

16. detachToolbarItem

<af:panelCollection id="pc1" featuresOff="detachToolbarItem">

When we set detachToolbarItem to the featuresOff attribute, it
removes Detach button from the Toolbar.

17. wrapToolbarItem

<af:panelCollection id="pc1" featuresOff="wrapToolbarItem">

When we set wrapToolbarItem to the featuresOff attribute, it
removes Wrap button from the Toolbar.

18. showAsTopToolbarItem

<af:panelCollection id="pc1" featuresOff="showAsTopToolbarItem">

When we set showAsTopToolbarItem to the featuresOff attribute, it
removes Go Up, Go to Top and Show as Top buttons from the Toolbar (Applicable for tree/treeTable).

19. wrap

<af:panelCollection id="pc1" featuresOff="wrap">

When we set wrap to the featuresOff attribute, it
removes Wrap menu item from Format Menu as well as from the Toolbar. Equivalent to featuresOff="wrapMenuItem wrapToolbarItem".

20. freeze

<af:panelCollection id="pc1" featuresOff="freeze">

When we set freeze to the featuresOff attribute, it
removes Freeze menu item from View Menu as well as from the Toolbar.
Equivalent to featuresOff="freezeMenuItem freezeToolbarItem".

21. detach

<af:panelCollection id="pc1" featuresOff="detach">

When we set detach to the featuresOff attribute, it
removes Detach menu item from View Menu as well as from the Toolbar.
Equivalent to featuresOff="detachMenuItem detachToolbarItem".

These options would be useful when using a panelCollection for
customizing at end user. A separate options could be provided using
these, so that end user can customize the LAF of the panelCollection.