org.openstreetmap.josm.tools

Class PlatformHookOsx

java.lang.Object

org.openstreetmap.josm.tools.PlatformHookOsx

All Implemented Interfaces:

java.lang.reflect.InvocationHandler, PlatformHook

public class PlatformHookOsx
extends java.lang.Object
implements PlatformHook, java.lang.reflect.InvocationHandler

PlatformHook implementation for Apple Mac OS X systems.

Since:

1023

Field Summary

Fields

Modifier and Type	Field and Description
private static PlatformHookOsx	ivhandler

Constructor Summary

Constructors

Constructor and Description
PlatformHookOsx()

Method Summary

Modifier and Type	Method and Description
private static void	auto(Shortcut sc)
boolean	canFullscreen() Determines if the platform allows full-screen.
static void	enableOSXFullscreen(java.awt.Window window) Enables fullscreen support for the given window.
protected java.lang.Class<?>	findHandlerClass(java.lang.String className)
java.io.File	getDefaultCacheDirectory() Returns the platform-dependent default cache directory.
java.io.File	getDefaultPrefDirectory() Returns the platform-dependent default preferences directory.
java.lang.String	getDefaultStyle() Returns the default LAF to be used on this platform to look almost as a native application.
java.io.File	getDefaultUserDataDirectory() Returns the platform-dependent default user data directory.
java.lang.String	getOSDescription() Returns a detailed OS description (at least family + version).
void	initSystemShortcuts() The initSystemShortcuts hook will be called by the Shortcut class after the modifier groups have been read from the config, but before any shortcuts are read from it or registered from within the application.
java.lang.Object	invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)
java.lang.String	makeTooltip(java.lang.String name, Shortcut sc) The makeTooltip hook will be called whenever a tooltip for a menu or button is created.
void	openUrl(java.lang.String url) The openURL hook will be used to open an URL in the default web browser.
void	preStartupHook() The preStartupHook will be called extremly early.
protected void	setHandlers(java.lang.Class<?> appClass, java.lang.Class<?> quitHandler, java.lang.Class<?> aboutHandler, java.lang.Class<?> openFilesHandler, java.lang.Class<?> preferencesHandler, java.lang.Object proxy, java.lang.Object appInstance)
void	startupHook() The startupHook will be called early, but after the GUI setup has started.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openstreetmap.josm.tools.PlatformHook

afterPrefStartupHook, rename, setupHttpsCertificate

Field Detail

ivhandler

private static final PlatformHookOsx ivhandler

Constructor Detail

PlatformHookOsx

public PlatformHookOsx()

Method Detail

preStartupHook

public void preStartupHook()

Description copied from interface: PlatformHook

The preStartupHook will be called extremly early. It is guaranteed to be called before the GUI setup has started. Reason: On OSX we need to inform the Swing libraries that we want to be integrated with the OS before we setup our GUI.

Specified by:

preStartupHook in interface PlatformHook

startupHook

public void startupHook()

Description copied from interface: PlatformHook

The startupHook will be called early, but after the GUI setup has started. Reason: On OSX we need to register some callbacks with the OS, so we'll receive events from the system menu.

Specified by:

startupHook in interface PlatformHook

setHandlers

protected void setHandlers(java.lang.Class<?> appClass,
                           java.lang.Class<?> quitHandler,
                           java.lang.Class<?> aboutHandler,
                           java.lang.Class<?> openFilesHandler,
                           java.lang.Class<?> preferencesHandler,
                           java.lang.Object proxy,
                           java.lang.Object appInstance)
                    throws java.lang.IllegalAccessException,
                           java.lang.reflect.InvocationTargetException,
                           java.lang.NoSuchMethodException

Throws:

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.NoSuchMethodException

findHandlerClass

protected java.lang.Class<?> findHandlerClass(java.lang.String className)
                                       throws java.lang.ClassNotFoundException

Throws:

java.lang.ClassNotFoundException

enableOSXFullscreen

public static void enableOSXFullscreen(java.awt.Window window)

Enables fullscreen support for the given window.

Parameters:

window - The window for which full screen will be available

Since:

7482

invoke

public java.lang.Object invoke(java.lang.Object proxy,
                               java.lang.reflect.Method method,
                               java.lang.Object[] args)
                        throws java.lang.Throwable

Specified by:

invoke in interface java.lang.reflect.InvocationHandler

Throws:

java.lang.Throwable

openUrl

public void openUrl(java.lang.String url)
             throws java.io.IOException

Description copied from interface: PlatformHook

The openURL hook will be used to open an URL in the default web browser.

Specified by:

openUrl in interface PlatformHook

Parameters:

url - The URL to open

Throws:

java.io.IOException - if any I/O error occurs

initSystemShortcuts

public void initSystemShortcuts()

Description copied from interface: PlatformHook

The initSystemShortcuts hook will be called by the Shortcut class after the modifier groups have been read from the config, but before any shortcuts are read from it or registered from within the application. Plese note that you are not allowed to register any shortuts from this hook, but only "systemCuts"! BTW: SystemCuts should be named "system:<whatever>", and it'd be best if sou'd recycle the names already used by the Windows and OSX hooks. Especially the later has really many of them. You should also register any and all shortcuts that the operation system handles itself to block JOSM from trying to use them---as that would just not work. Call setAutomatic on them to prevent the keyboard preferences from allowing the user to change them.

Specified by:

initSystemShortcuts in interface PlatformHook

auto

private static void auto(Shortcut sc)

makeTooltip

public java.lang.String makeTooltip(java.lang.String name,
                                    Shortcut sc)

Description copied from interface: PlatformHook

The makeTooltip hook will be called whenever a tooltip for a menu or button is created. Tooltips are usually not system dependent, unless the JVM is too dumb to provide correct names for all the keys. Some LAFs don't understand HTML, such as the OSX LAFs.

Specified by:

makeTooltip in interface PlatformHook

Parameters:

name - Tooltip text to display

sc - Shortcut associated (to display accelerator between parenthesis)

Returns:

Full tooltip text (name + accelerator)

getDefaultStyle

public java.lang.String getDefaultStyle()

Description copied from interface: PlatformHook

Returns the default LAF to be used on this platform to look almost as a native application.

Specified by:

getDefaultStyle in interface PlatformHook

Returns:

The default native LAF for this platform

canFullscreen

public boolean canFullscreen()

Description copied from interface: PlatformHook

Determines if the platform allows full-screen.

Specified by:

canFullscreen in interface PlatformHook

Returns:

true if full screen is allowed, false otherwise

getOSDescription

public java.lang.String getOSDescription()

Description copied from interface: PlatformHook

Returns a detailed OS description (at least family + version).

Specified by:

getOSDescription in interface PlatformHook

Returns:

A detailed OS description.

getDefaultCacheDirectory

public java.io.File getDefaultCacheDirectory()

Description copied from interface: PlatformHook

Returns the platform-dependent default cache directory.

Specified by:

getDefaultCacheDirectory in interface PlatformHook

Returns:

the platform-dependent default cache directory

getDefaultPrefDirectory

public java.io.File getDefaultPrefDirectory()

Description copied from interface: PlatformHook

Returns the platform-dependent default preferences directory.

Specified by:

getDefaultPrefDirectory in interface PlatformHook

Returns:

the platform-dependent default preferences directory

getDefaultUserDataDirectory

public java.io.File getDefaultUserDataDirectory()

Description copied from interface: PlatformHook

Returns the platform-dependent default user data directory.

Specified by:

getDefaultUserDataDirectory in interface PlatformHook

Returns:

the platform-dependent default user data directory