org.openstreetmap.josm.tools

Class PlatformHookOsx

java.lang.Object

org.openstreetmap.josm.tools.PlatformHookUnixoid

org.openstreetmap.josm.tools.PlatformHookOsx

All Implemented Interfaces:

java.lang.reflect.InvocationHandler, PlatformHook

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

PlatformHook implementation for Apple Mac OS X systems.

Since:

1023

Nested Class Summary

Nested classes/interfaces inherited from class org.openstreetmap.josm.tools.PlatformHookUnixoid

PlatformHookUnixoid.FontEntry, PlatformHookUnixoid.LinuxReleaseInfo

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
boolean	canFullscreen() Determines if the platform allows full-screen.
static void	enableOSXFullscreen(java.awt.Window window) Enables fullscreen support for the given window.
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) This should work for all platforms.
static void	migrateOldDirectory() Prior to r7834, JOSM used the same Unix directory ~/.josm for all local files (preferences, caches, user data).
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.
void	startupHook() The startupHook will be called early, but after the GUI setup has started.

Methods inherited from class org.openstreetmap.josm.tools.PlatformHookUnixoid

afterPrefStartupHook, askUpdateJava, askUpdateJava, buildOSDescription, extendFontconfig, getAdditionalFonts, getInstalledFonts, getJavaPackageDetails, getPackageDetails, getWebStartPackageDetails, isOpenJDK, rename, setupHttpsCertificate

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 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

Overrides:

preStartupHook in class PlatformHookUnixoid

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

Overrides:

startupHook in class PlatformHookUnixoid

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

Overrides:

openUrl in class PlatformHookUnixoid

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

Overrides:

initSystemShortcuts in class PlatformHookUnixoid

makeTooltip

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

Description copied from class: PlatformHookUnixoid

This should work for all platforms. Yeah, should. See PlatformHook.java for a list of reasons why this is implemented here...

Specified by:

makeTooltip in interface PlatformHook

Overrides:

makeTooltip in class PlatformHookUnixoid

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

Overrides:

getDefaultStyle in class PlatformHookUnixoid

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

Overrides:

canFullscreen in class PlatformHookUnixoid

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

Overrides:

getOSDescription in class PlatformHookUnixoid

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

Overrides:

getDefaultCacheDirectory in class PlatformHookUnixoid

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

Overrides:

getDefaultPrefDirectory in class PlatformHookUnixoid

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

Overrides:

getDefaultUserDataDirectory in class PlatformHookUnixoid

Returns:

the platform-dependent default user data directory

migrateOldDirectory

public static void migrateOldDirectory()

Prior to r7834, JOSM used the same Unix directory ~/.josm for all local files (preferences, caches, user data). This method migrates the existing preferences and plugins to new directories if applicable. Old directory, including cache, is deleted. Method to remove end of 2015.

Since:

7835