com.webrenderer.swing

Interface IOptionsService

public interface IOptionsService

Companion interface to IBrowserCanvas that exposes various browser options and preferences.

See Also:

IBrowserCanvas, IMozillaBrowserCanvas, BrowserFactory

Method Summary

Methods

Modifier and Type	Method and Description
String	getSaveDialogDirectory() Returns the directory that will be shown by default when the user is next prompted by a web page to save or download a file.
boolean	isLoadInterceptEventsEnabled() Returns true if setLoadInterceptEventsEnabled(boolean) is enabled.
boolean	isSaveDialogsEnabled() Returns true if setSaveDialogsEnabled(boolean) is enabled.
boolean	isSuppressSecondClickEvent() Returns true if setSuppressSecondClickEvent(boolean) is enabled.
boolean	isSuppressTooltips() Returns true if setSuppressTooltips(boolean) is enabled.
void	setLoadInterceptEventsEnabled(boolean enabled) Enables or disables the delivery of BrowserListener.onLoadIntercept(BrowserEvent) events (default: true).
void	setSaveDialogDirectory(String directory) Sets the directory that will be shown by default when the user is next prompted by a web page to save or download a file.
void	setSaveDialogsEnabled(boolean enabled) Enables or disables save dialogs (default: true).
void	setSuppressSecondClickEvent(boolean suppress) Deprecated. This functionality is no longer available.
void	setSuppressTooltips(boolean suppress) Toggles whether tooltips are shown or suppressed.

Method Detail

getSaveDialogDirectory

String getSaveDialogDirectory()

Returns the directory that will be shown by default when the user is next prompted by a web page to save or download a file. This will correspond to either the last directory chosen by the user, or the last call to setSaveDialogDirectory(String) (whichever was more recent).

This method can return null, indicating that no save directory has been explicitly set.

Returns:

the most recently-set save directory, or null

setSaveDialogDirectory

void setSaveDialogDirectory(String directory)

Sets the directory that will be shown by default when the user is next prompted by a web page to save or download a file. If the user chooses to save in a different directory, future save dialogs within the same browser session will respect the user's choice until this method is called again.

See Also:

getSaveDialogDirectory()

isSuppressSecondClickEvent

boolean isSuppressSecondClickEvent()

Returns true if setSuppressSecondClickEvent(boolean) is enabled.

setSuppressSecondClickEvent

void setSuppressSecondClickEvent(boolean suppress)

Deprecated. This functionality is no longer available.

This option is obsolete and no longer has any effect.

isSuppressTooltips

boolean isSuppressTooltips()

Returns true if setSuppressTooltips(boolean) is enabled.

setSuppressTooltips

void setSuppressTooltips(boolean suppress)

Toggles whether tooltips are shown or suppressed. When false (default), tooltips will appear normally. When true, no tooltips will be shown.

Parameters:

suppress - true if tooltips should not be shown

isLoadInterceptEventsEnabled

boolean isLoadInterceptEventsEnabled()

Returns true if setLoadInterceptEventsEnabled(boolean) is enabled.

setLoadInterceptEventsEnabled

void setLoadInterceptEventsEnabled(boolean enabled)

Enables or disables the delivery of BrowserListener.onLoadIntercept(BrowserEvent) events (default: true).

Parameters:

enabled - true to enable load-intercept events, or false to disable them

isSaveDialogsEnabled

boolean isSaveDialogsEnabled()

Returns true if setSaveDialogsEnabled(boolean) is enabled.

setSaveDialogsEnabled

void setSaveDialogsEnabled(boolean enabled)

Enables or disables save dialogs (default: true). If disabled, save dialogs will be silently cancelled.

Parameters:

enabled - true to enable save dialogs, or false to disable them