Package org.eclipse.ui.intro.contentproviders

Class AlwaysWelcomeCheckbox

java.lang.Object

org.eclipse.ui.intro.contentproviders.AlwaysWelcomeCheckbox

All Implemented Interfaces:

IIntroAction, IIntroContentProvider

public class AlwaysWelcomeCheckbox
extends Object
implements IIntroContentProvider, IIntroAction

Class which contributes a checkbox to an intro page which allows welcome to show on startup. If the checkbox is checked the home page of intro will be shown the next time the Eclipse application starts up. This class may be subclassed to override the text for the checkbox label. Implements the IIntroContentProvider to create the checkbox ui, and the org.eclipse.ui.intro.config.IIntroAction interface for handling checkbox click events.

Since:

3.3

Field Summary

Fields

Modifier and Type	Field	Description
static final String	ALWAYS_SHOW_INTRO

Constructor Summary

Constructors

Constructor	Description
AlwaysWelcomeCheckbox()

Method Summary

Modifier and Type	Method	Description
void	createContent(String id, PrintWriter out)	Creates HTML content in the provided PrintWriter.
void	createContent(String id, Composite parent, FormToolkit toolkit)	Creates SWT content in the provided Composite.
void	dispose()	Dispose of the ContentProvider.
boolean	getAlwaysShowIntroPref()
protected String	getText()	Override this method to change the default text used for the checkbox
void	init(IIntroContentProviderSite site)	Initializes the content provider.
void	run(IIntroSite site, Properties params)	Method called when box is clicked in html (swt is handled with a SelectionAdapter - both methods call reverseShowIntroState())
void	setAlwaysShowIntroPref(boolean val)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ALWAYS_SHOW_INTRO

public static final String ALWAYS_SHOW_INTRO

See Also:

• Constant Field Values

Constructor Details

AlwaysWelcomeCheckbox

public AlwaysWelcomeCheckbox()

Method Details

getText

protected String getText()

Override this method to change the default text used for the checkbox

Returns:

String label for the checkbox

Since:

3.3

createContent

public void createContent(String id,
 PrintWriter out)

Description copied from interface: IIntroContentProvider

Creates HTML content in the provided PrintWriter. This content will be included in the generated HTML page when embedded HTML widget is used to render intro content.

Specified by:

createContent in interface IIntroContentProvider

Parameters:

id - the unique identifier of the content element. The same content provider class can be reused for several elements and the id can be used to tell them apart.

out - the output print writer to generate HTML content into

createContent

public void createContent(String id,
 Composite parent,
 FormToolkit toolkit)

Description copied from interface: IIntroContentProvider

Creates SWT content in the provided Composite. This method is called when Eclipse Forms are used to render intro content.

Specified by:

createContent in interface IIntroContentProvider

Parameters:

id - the unique identifier of the content element

parent - the parent composite that should be used when creating SWT widgets

toolkit - the form toolkit that should be used when creating new widgets

dispose

public void dispose()

Description copied from interface: IIntroContentProvider

Dispose of the ContentProvider. This will only be called when the Intro view is closed. In other words, the content provider will not be disposed of until the last possible minute. This gives the implementor the chance to cache content and avoid regenerating content on every page switch.

Specified by:

dispose in interface IIntroContentProvider

init

public void init(IIntroContentProviderSite site)

Description copied from interface: IIntroContentProvider

Initializes the content provider. An IIntroContentProviderSite is passed, which will be called on to recompute or layout the content when the content becomes stale.

Specified by:

init in interface IIntroContentProvider

Parameters:

site - the site of this IIntroContentProvider

run

public void run(IIntroSite site,
 Properties params)

Method called when box is clicked in html (swt is handled with a SelectionAdapter - both methods call reverseShowIntroState())

Specified by:

run in interface IIntroAction

Parameters:

site - The part to execute the command on.

params - Parameters for the command as extracted from the URL.

getAlwaysShowIntroPref

public boolean getAlwaysShowIntroPref()

setAlwaysShowIntroPref

public void setAlwaysShowIntroPref(boolean val)