All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface com.sgi.sysadm.ui.ItemViewAdditionalInfoRenderer

public interface ItemViewAdditionalInfoRenderer
An interface that describes how to render the additional information about an Item for an ItemView. The sequence that the methods will be called in is as follows:
  1. initializeAdditionalInfoRenderer
  2. renderInfo
  3. renderInfoAgain (zero or more times)
  4. renderInfoBlank
  5. repeat from step 2 (only if ItemView is used to display another Item)

This class is used by ItemViewController to display the section of the ItemView known as the "Additional Info" section. To use a ItemViewAdditionalInfodRenderer, the programmer should set the ADDITIONAL_INFO_RENDERER property to a class that implements this interface. See the ItemView and ItemViewController documentation for more information about how to use this class.

See Also:
ItemView, ItemViewController, ADDITIONAL_INFO_RENDERER

Method Index

 o initializeAdditionalInfoRenderer(LabelComponentPanel, ItemViewContext, ItemViewController)
Initializes the AdditionalInfoRenderer.
 o renderInfo(Item)
Updates the additional info panel.
 o renderInfoAgain(Item)
Updates the additional info panel after the Item has changed.
 o renderInfoBlank()
Updates the additional info panel to be blank.

Methods

 o initializeAdditionalInfoRenderer
 public abstract void initializeAdditionalInfoRenderer(LabelComponentPanel panel,
                                                       ItemViewContext ivc,
                                                       ItemViewController controller)
Initializes the AdditionalInfoRenderer. The renderer need take no action, but can initialize variables, etc. It is also customary to use this method to create components and add them to panel To add values that look like the values that the infrastructure uses in the "fields" section of the ItemView, use an RLabel and pass VALUE_RLABEL_NAME as the name of the RLabel to the RLabel constructor.

Parameters:
panel - The LabelComponentPanel on which to draw.
ivc - The ItemViewContext to use
controller - The ItemViewController using the renderer
See Also:
VALUE_RLABEL_NAME, RLabel
 o renderInfo
 public abstract void renderInfo(Item item)
Updates the additional info panel. This will be called the first time the Item arrives in the ItemView. The Renderer should setup anything that depends on the Item's selector, and update the components on the panel as needed. If the panel changes after this method returns then you should call the validate method on the panel that was passed to initializeAdditionalInfoRenderer.

Parameters:
item - The Item to render
 o renderInfoAgain
 public abstract void renderInfoAgain(Item item)
Updates the additional info panel after the Item has changed. This gets called if the Item changes after renderInfo has been called. You know that the Item has the same selector as the Item as the previous renderInfo call; only the Attributes have changed. If the panel changes after this method returns then you should call the validate method on the panel that was passed to initializeAdditionalInfoRenderer.

Parameters:
item - The item to draw
 o renderInfoBlank
 public abstract void renderInfoBlank()
Updates the additional info panel to be blank. This will be called when an item is deleted, or the item panel otherwise needs to be blank. You can still show components when blank, but don't show any state for the Item. The renderer should forget all about the Item that it learned about in renderInfo, and it's also the appropriate time to undo any actions that have been done in the rendererInfo method so that this object can be garbage collected. This may be the last call to the renderer, but if it's not, then it's guarenteed that the next call will be to the renderInfo method.


All Packages  Class Hierarchy  This Package  Previous  Next  Index