berry::IIntroManager Struct Reference

#include <berryIIntroManager.h>

Public Member Functions
virtual	~IIntroManager ()
virtual bool	CloseIntro (IIntroPart::Pointer part)=0
virtual IIntroPart::Pointer	GetIntro () const =0
virtual bool	HasIntro () const =0
virtual bool	IsIntroStandby (IIntroPart::Pointer part) const =0
virtual void	SetIntroStandby (IIntroPart::Pointer part, bool standby)=0
virtual IIntroPart::Pointer	ShowIntro (IWorkbenchWindow::Pointer preferredWindow, bool standby)=0
virtual bool	IsNewContentAvailable ()=0

Detailed Description

Manages the intro part that introduces the product to new users. The intro part is typically shown the first time a product is started up.

The initial behavior of the intro part is controlled by the application from via the org.eclipse.ui.application.WorkbenchWindowAdvisor#openIntro() method.

See org.eclipse.ui.intro.IIntroPart for details on where intro parts come from.

This interface is not intended to be extended or implemented by clients.

See also

org.eclipse.ui.IWorkbench::getIntroManager()

Since

3.0 This interface is not intended to be implemented by clients.

Definition at line 47 of file berryIIntroManager.h.

Constructor & Destructor Documentation

berry::IIntroManager::~IIntroManager ( )

virtual

Definition at line 22 of file berryIIntroManager.cpp.

Member Function Documentation

virtual bool berry::IIntroManager::CloseIntro ( IIntroPart::Pointer  part )

pure virtual

Closes the given intro part.

Parameters

part	the intro part

Returns

true if the intro part was closed, and false otherwise. false is returned if part is null or it is not the intro part returned by getIntro().

virtual IIntroPart::Pointer berry::IIntroManager::GetIntro ( ) const

pure virtual

Returns the intro part. Returns null if there is no intro part, if it has been previously closed via closeIntro(IIntroPart) or if there is an intro part but showIntro(IWorkbenchWindow, boolean) has not yet been called to create it.

Returns

the intro part, or null if none is available

virtual bool berry::IIntroManager::HasIntro ( ) const

pure virtual

Return whether an intro is available. Note that this checks whether there is an applicable intro part that could be instantiated and shown to the user. Use getIntro() to discover whether an intro part has already been created.

Returns

true if there is an intro that could be shown, and false if there is no intro

Referenced by berry::WorkbenchWindowAdvisor::OpenIntro().

virtual bool berry::IIntroManager::IsIntroStandby ( IIntroPart::Pointer  part ) const

pure virtual

Return the standby state of the given intro part.

Parameters

part	the intro part

Returns

true if the part in its partially visible standy mode, and false if in its fully visible state. false is returned if part is null or it is not the intro part returned by getIntro().

virtual bool berry::IIntroManager::IsNewContentAvailable ( )

pure virtual

Returns true if there is an intro content detector and it reports that new intro content is available.

Returns

true if new intro content is available

Since

3.3

Referenced by berry::WorkbenchWindowAdvisor::OpenIntro().

virtual void berry::IIntroManager::SetIntroStandby ( IIntroPart::Pointer  part, bool  standby  )

pure virtual

Sets the standby state of the given intro part. Intro part usually should render themselves differently in the full and standby modes. In standby mode, the part should be partially visible to the user but otherwise allow them to work. In full mode, the part should be fully visible and be the center of the user's attention.

This method does nothing if the part is null or is not the intro part returned by getIntro().

Parameters

part	the intro part, or null
standby	true to put the part in its partially visible standy mode, and false to make it fully visible.

virtual IIntroPart::Pointer berry::IIntroManager::ShowIntro ( IWorkbenchWindow::Pointer  preferredWindow, bool  standby  )

pure virtual

Shows the intro part in the given workbench window. If the intro part has not been created yet, one will be created. If the intro part is currently being shown in some workbench window, that other window is made active.

Parameters

preferredWindow	the preferred workbench window, or null to indicate the currently active workbench window
standby	true to put the intro part in its partially visible standy mode, and false to make it fully visible

Returns

the newly-created or existing intro part, or null if no intro part is available or if preferredWindow is null and there is no currently active workbench window

Referenced by berry::WorkbenchWindowAdvisor::OpenIntro().

---

The documentation for this struct was generated from the following files:

• berryIIntroManager.h
• berryIIntroManager.cpp