## javax.help
Class WindowPresentation

    java.lang.Object
      javax.help.Presentation
          javax.help.WindowPresentation

Direct Known Subclasses:
  MainWindow, SecondaryWindow

public abstract class WindowPresentation
extends Presentation

Window Presentation is an abstract class providing a generic interface for the development of Window Presentations. Each implementation of Presentation will need to override the static method getPresentation according to it's own needs. WindowPresentation implements several generic methods required in all window presentations. Includes the ability to handle modal and non-modal activation of the help window.

Since:
  2.0
See Also:
  `HelpSet`, `JHelpNavigator`, `javax.help.HelpVisitListener`

Constructor Summary
`WindowPresentation(HelpSet hs)`

Method Summary
`void` `createHelpWindow()`
`void` `destroy()` Destroy this object.
`java.awt.Window` `getActivationWindow()` Get the activation window.
`java.lang.String` `getCurrentView()` Determines the current navigator.
`java.awt.Font` `getFont()` Gets the font for this WindowPresentation
`HelpSet.Presentation` `getHelpSetPresentation()` Return the HelpSet.Presentation if one was set
`java.awt.Window` `getHelpWindow()` Get the current window that help is displayed in
`java.awt.Point` `getLocation()` Requests the location of the presentation.
`int` `getScreen()` Requests the screen of the presentation
`java.awt.Dimension` `getSize()` Requests the size of the presentation.
`java.lang.String` `getTitle()`
`boolean` `isDestroyedOnExit()` Determines if the presentation should be distroyed on exit
`boolean` `isDisplayed()` Determines if the presentation is displayed.
`boolean` `isTitleSetFromDocument()` Is the title set from the Document.
`boolean` `isToolbarDisplayed()` Determines if the toolbar is visible.
`boolean` `isViewDisplayed()` Determines if the current view is visible.
`void` `setActivationObject(java.lang.Object comp)` Set the activation window from given Component or MenuItem.
`void` `setActivationWindow(java.awt.Window window)` Set the activation window.
`void` `setCurrentView(java.lang.String name)` Set the currentView to the navigator with the same name as the `name` parameter.
`void` `setDestroyOnExit(boolean destroy)` Destory the window on exit
`void` `setDisplayed(boolean b)` Displays the presentation to the user.
`void` `setFont(java.awt.Font f)` Sets the font for this this WindowPresentation.
`void` `setHelpSet(HelpSet hs)` Changes the HelpSet for this presentation.
`void` `setHelpSetPresentation(HelpSet.Presentation hsPres)` Set the Presentation attributes specific to WindowPresentations from a named presentation in a HelpSet.
`void` `setLocale(java.util.Locale l)` Sets the locale of this Presentation.
`void` `setLocation(java.awt.Point p)` Requests the presentation be located at a given position.
`void` `setScreen(int screen)` Sets the screen of the presentation
`void` `setSize(java.awt.Dimension d)` Requests the presentation be set to a given size.
`void` `setTitle(java.lang.String title)`
`void` `setTitleFromDocument(boolean b)` Set the title from the Document.
`void` `setToolbarDisplayed(boolean displayed)` Hides/Shows Toolbar
`void` `setViewDisplayed(boolean displayed)` Hides/Shows view.

Methods inherited from class javax.help.Presentation
`getCurrentID, getCurrentURL, getHelpSet, getLocale, getPresentation, setCurrentID, setCurrentID, setCurrentURL`

Methods inherited from class java.lang.Object
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### WindowPresentation

    public WindowPresentation(HelpSet hs)

Method Detail

### setHelpSetPresentation

    public void setHelpSetPresentation(HelpSet.Presentation hsPres)

  Set the Presentation attributes specific to WindowPresentations from a named presentation in a HelpSet.

  Overrides:
    `setHelpSetPresentation` in class `Presentation`
  See Also:
    `HelpSet.Presentation`

### getHelpSetPresentation

    public HelpSet.Presentation getHelpSetPresentation()

  Return the HelpSet.Presentation if one was set

  See Also:
    `HelpSet.Presentation`

### getActivationWindow

    public java.awt.Window getActivationWindow()

  Get the activation window.

### setActivationWindow

    public void setActivationWindow(java.awt.Window window)

  Set the activation window. If the window is an instance of a Dialog and the is modal, modallyActivated help is set to true and ownerDialog is set to the window. In all other instances modallyActivated is set to false and ownerDialog is set to null.

  Parameters:
    `window` - the activating window

### setActivationObject

    public void setActivationObject(java.lang.Object comp)

  Set the activation window from given Component or MenuItem. It find Window component in the component tree from given Component or MenuItem end call

      setActivationWindow

  .

  Since:
    2.0
  See Also:
    `setActivationWindow`

### getCurrentView

    public java.lang.String getCurrentView()

  Determines the current navigator.

### setCurrentView

    public void setCurrentView(java.lang.String name)

  Set the currentView to the navigator with the same name as the `name` parameter.

  Parameters:
    `name` - The name of the navigator to set as the current view. If nav is null or not a valid Navigator in this WindowPresentation then an IllegalArgumentException is thrown.
  Throws:
    `java.lang.IllegalArgumentException` - if nav is null or not a valid Navigator.

### isDestroyedOnExit

    public boolean isDestroyedOnExit()

  Determines if the presentation should be distroyed on exit

### setDestroyOnExit

    public void setDestroyOnExit(boolean destroy)

  Destory the window on exit

### destroy

    public void destroy()

  Destroy this object. Implementation of WindowPresentation that maintian a list of objects should override this method and call super.destroy to clear up the WindowPresentation internal fields.

### setHelpSet

    public void setHelpSet(HelpSet hs)

  Changes the HelpSet for this presentation.

  Overrides:
    `setHelpSet` in class `Presentation`
  Parameters:
    `hs` - The HelpSet to set for this presentation. A null hs is valid parameter.

### setDisplayed

    public void setDisplayed(boolean b)

  Displays the presentation to the user.

  Specified by:
    `setDisplayed` in class `Presentation`

### isDisplayed

    public boolean isDisplayed()

  Determines if the presentation is displayed.

  Specified by:
    `isDisplayed` in class `Presentation`

### setFont

    public void setFont(java.awt.Font f)

  Sets the font for this this WindowPresentation.

  Overrides:
    `setFont` in class `Presentation`
  Parameters:
    `f` - The font.

### getFont

    public java.awt.Font getFont()

  Gets the font for this WindowPresentation

  Overrides:
    `getFont` in class `Presentation`

### setLocale

    public void setLocale(java.util.Locale l)

  Sets the locale of this Presentation. The locale is propagated to the presentation.

  Overrides:
    `setLocale` in class `Presentation`
  Parameters:
    `l` - The locale to become this component's locale. A null locale is the same as the defaultLocale.
  See Also:
    `Presentation.getLocale()`

### getLocation

    public java.awt.Point getLocation()

  Requests the location of the presentation.

### setLocation

    public void setLocation(java.awt.Point p)

  Requests the presentation be located at a given position.

### getScreen

    public int getScreen()

  Requests the screen of the presentation

### setScreen

    public void setScreen(int screen)

  Sets the screen of the presentation

  Parameters:
    `screen` - the screen number
  Throws:
    `java.lang.IllegalArgumentException` - if the screen is invalid

### getSize

    public java.awt.Dimension getSize()

  Requests the size of the presentation.

  Overrides:
    `getSize` in class `Presentation`

### setSize

    public void setSize(java.awt.Dimension d)

  Requests the presentation be set to a given size. Updates the the presentation on the fly. This is an override of Presentation.SetSize.

  Overrides:
    `setSize` in class `Presentation`
  Parameters:
    `d` - - a Dimension to set the size to.

### getTitle

    public java.lang.String getTitle()

### setTitle

    public void setTitle(java.lang.String title)

### isTitleSetFromDocument

    public boolean isTitleSetFromDocument()

  Is the title set from the Document. This is generally useful in SecondaryWindows.

  Returns:
    boolean True if title is set from the Document, false otherwise.

### setTitleFromDocument

    public void setTitleFromDocument(boolean b)

  Set the title from the Document.

  Parameters:
    `b` - if true will set the title form the document, otherwise will set the title from the HelpSet.

### isViewDisplayed

    public boolean isViewDisplayed()

  Determines if the current view is visible.

### setViewDisplayed

    public void setViewDisplayed(boolean displayed)

  Hides/Shows view.

### isToolbarDisplayed

    public boolean isToolbarDisplayed()

  Determines if the toolbar is visible.

### setToolbarDisplayed

    public void setToolbarDisplayed(boolean displayed)

  Hides/Shows Toolbar

### createHelpWindow

    public void createHelpWindow()

### getHelpWindow

    public java.awt.Window getHelpWindow()

  Get the current window that help is displayed in