org.arakhne.neteditor.android.activity

Class AbstractEditorActivity<G extends Graph<?,?,?,?>>

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.view.ContextThemeWrapper

android.app.Activity

org.arakhne.neteditor.android.activity.AbstractEditorActivity<G>

Type Parameters:

G - is the type of the graph supported by this editor.

All Implemented Interfaces:

android.content.ComponentCallbacks, android.content.ComponentCallbacks2, android.view.KeyEvent.Callback, android.view.LayoutInflater.Factory, android.view.LayoutInflater.Factory2, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback

public abstract class AbstractEditorActivity<G extends Graph<?,?,?,?>>
extends android.app.Activity

This abstract activity permits to edit an document with the NetEditor API.

Version:

NetEditor Android Panel $Revision$ 2013-10-23 21:06:37

Author:

Stéphane GALLAND

Maven Group Id:

org.arakhne.neteditor

Maven Artifact Id:

neteditor-androidpanel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	AbstractEditorActivity.DifferedActionType Type of differed action that may be run by the function runDifferedActionAfterSaving(DifferedActionType).

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	TAG Tag for logs.

Fields inherited from class android.app.Activity

DEFAULT_KEYS_DIALER, DEFAULT_KEYS_DISABLE, DEFAULT_KEYS_SEARCH_GLOBAL, DEFAULT_KEYS_SEARCH_LOCAL, DEFAULT_KEYS_SHORTCUT, FOCUSED_STATE_SET, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, AUDIO_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, KEYGUARD_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_ROUTER_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, STORAGE_SERVICE, TELEPHONY_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, UI_MODE_SERVICE, USB_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_P2P_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Fields inherited from interface android.content.ComponentCallbacks2

TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Constructor Summary

Constructors

Constructor and Description
AbstractEditorActivity()

Method Summary

Methods

Modifier and Type	Method and Description
protected static NetEditorContentType	decode(File file) Detect the type of the given file.
File	getCurrentDocument() Replies the filename of the current document.
NetEditorContentType	getCurrentDocumentType() Replies the encoding type of the current document.
FigureView<G>	getFigureView() Replies the viewer of figures.
protected abstract Class<? extends FigureFactory<G>>	getPreferredFigureFactory() Replies the type of the figure factory supported by this editor.
protected abstract Class<? extends FileFilter>	getPreferredFileFilter() Replies the type of the preferred file filter for this activity.
protected abstract Class<G>	getPreferredGraphType() Replies the type of the graph supported by this editor.
boolean	hasChanged() Replies if the current document has been changed since its last loading.
boolean	isSelectionEnabled() Replies if the selection manager is enabled.
boolean	isSelectionMode() Replies if the activity is in selection mode.
protected void	killApplication() Kill the application.
protected void	onActionPerformed(boolean isEditionEnabled, Point2D hitPoint, Figure... figures) Invoked when the user want to perform the standard action on the given figures.
protected void	onActivityResult(int requestCode, int resultCode, android.content.Intent data)
void	onBackPressed()
void	onCreate(android.os.Bundle savedInstanceState)
boolean	onCreateThumbnail(android.graphics.Bitmap outBitmap, android.graphics.Canvas canvas)
protected void	onDestroy()
protected void	onRegisterPropertyEditors() Invoked to register the property editors that are known by the activity.
protected void	onRestoreInstanceState(android.os.Bundle savedInstanceState)
protected void	onSaveInstanceState(android.os.Bundle outState)
protected void	onSecondaryActionPerformed(boolean isEditionEnabled, Figure... figures) Invoked when the user want to perform the standard secondary action on the given figures.
protected void	runDifferedActionAfterSaving(AbstractEditorActivity.DifferedActionType action) Ask the user if he wants to save its document and run the specified action if a positive answer if given.
protected void	runLoadAction(boolean askToSave) Run the loading action.
protected void	runNewDocumentAction(boolean askToSave) Run the new action.
protected void	runSaveAction() Run the saving action.
protected void	runSaveAsAction() Run the save-as action.
(package private) void	setFileSelectionCallback(ActionModeOwner.Callback callback) Set the callback that may be invoked by the mode's file selector.
void	setSelectionEnabled(boolean enable) Set if the selection manager is enabled.
protected void	showError(Throwable e) Show an error dialog box.

Methods inherited from class android.app.Activity

addContentView, closeContextMenu, closeOptionsMenu, createPendingResult, dismissDialog, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, dump, findViewById, finish, finishActivity, finishActivityFromChild, finishAffinity, finishFromChild, getActionBar, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getCurrentFocus, getFragmentManager, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLoaderManager, getLocalClassName, getMenuInflater, getParent, getParentActivityIntent, getPreferences, getRequestedOrientation, getSystemService, getTaskId, getTitle, getTitleColor, getVolumeControlStream, getWindow, getWindowManager, hasWindowFocus, invalidateOptionsMenu, isChangingConfigurations, isChild, isFinishing, isTaskRoot, managedQuery, moveTaskToBack, navigateUpTo, navigateUpToFromChild, onActionModeFinished, onActionModeStarted, onApplyThemeResource, onAttachedToWindow, onAttachFragment, onChildTitleChanged, onConfigurationChanged, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreateContextMenu, onCreateDescription, onCreateDialog, onCreateDialog, onCreateNavigateUpTaskStack, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateView, onCreateView, onDetachedFromWindow, onGenericMotionEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyShortcut, onKeyUp, onLowMemory, onMenuItemSelected, onMenuOpened, onNavigateUp, onNavigateUpFromChild, onNewIntent, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPause, onPostCreate, onPostResume, onPrepareDialog, onPrepareDialog, onPrepareNavigateUpTaskStack, onPrepareOptionsMenu, onPreparePanel, onRestart, onResume, onRetainNonConfigurationInstance, onSearchRequested, onStart, onStop, onTitleChanged, onTouchEvent, onTrackballEvent, onTrimMemory, onUserInteraction, onUserLeaveHint, onWindowAttributesChanged, onWindowFocusChanged, onWindowStartingActionMode, openContextMenu, openOptionsMenu, overridePendingTransition, recreate, registerForContextMenu, removeDialog, requestWindowFeature, runOnUiThread, setContentView, setContentView, setContentView, setDefaultKeyMode, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setFinishOnTouchOutside, setIntent, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTitle, setTitle, setTitleColor, setVisible, setVolumeControlStream, shouldUpRecreateTask, showDialog, showDialog, startActionMode, startActivities, startActivities, startActivity, startActivity, startActivityForResult, startActivityForResult, startActivityFromChild, startActivityFromChild, startActivityFromFragment, startActivityFromFragment, startActivityIfNeeded, startActivityIfNeeded, startIntentSender, startIntentSender, startIntentSenderForResult, startIntentSenderForResult, startIntentSenderFromChild, startIntentSenderFromChild, startManagingCursor, startNextMatchingActivity, startNextMatchingActivity, startSearch, stopManagingCursor, takeKeyEvents, triggerSearch, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper

attachBaseContext, getTheme, setTheme

Methods inherited from class android.content.ContextWrapper

bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getContentResolver, getDatabasePath, getDir, getExternalCacheDir, getExternalFilesDir, getFilesDir, getFileStreamPath, getMainLooper, getObbDir, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getResources, getSharedPreferences, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isRestricted, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, revokeUriPermission, sendBroadcast, sendBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendStickyBroadcast, sendStickyOrderedBroadcast, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getString, getString, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, registerComponentCallbacks, unregisterComponentCallbacks

Methods inherited from class java.lang.Object

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

Field Detail

TAG

protected static final String TAG

Tag for logs.

See Also:

Constant Field Values

Constructor Detail

AbstractEditorActivity

public AbstractEditorActivity()

Method Detail

decode

protected static NetEditorContentType decode(File file)

Detect the type of the given file.

Parameters:

file -

Returns:

the type of the given file or null if it is a NGR file.

setFileSelectionCallback

void setFileSelectionCallback(ActionModeOwner.Callback callback)

Set the callback that may be invoked by the mode's file selector.

Parameters:

callback -

runDifferedActionAfterSaving

protected void runDifferedActionAfterSaving(AbstractEditorActivity.DifferedActionType action)

Ask the user if he wants to save its document and run the specified action if a positive answer if given.

The user may answer in following ways:

• POSITIVE; the user clicks on the "Yes" button; then the document is saved and the action is run.
• NEGATIVE; the user clicks on the "No" button; then the document is not saved and the action is run.
• CANCEL; the user clicks outside the dialog box or on the back button; then the document is not saved and the action is not run.

Parameters:

action - is the action to run.

onRegisterPropertyEditors

protected void onRegisterPropertyEditors()

Invoked to register the property editors that are known by the activity.

isSelectionEnabled

public boolean isSelectionEnabled()

Replies if the selection manager is enabled.

Returns:

true if the selection manager is enabled.

setSelectionEnabled

public void setSelectionEnabled(boolean enable)

Set if the selection manager is enabled.

Parameters:

enable - is true if the selection manager is enabled.

getCurrentDocument

public File getCurrentDocument()

Replies the filename of the current document.

Returns:

the filename of the current document.

getCurrentDocumentType

public NetEditorContentType getCurrentDocumentType()

Replies the encoding type of the current document.

Returns:

the encoding type of the current document.

hasChanged

public boolean hasChanged()

Replies if the current document has been changed since its last loading.

Returns:

true if the document has changed since the last loading; false if the document remains the same.

showError

protected void showError(Throwable e)

Show an error dialog box.

Parameters:

e -

onCreate

public void onCreate(android.os.Bundle savedInstanceState)

Overrides:

onCreate in class android.app.Activity

onSaveInstanceState

protected void onSaveInstanceState(android.os.Bundle outState)

Overrides:

onSaveInstanceState in class android.app.Activity

onRestoreInstanceState

protected void onRestoreInstanceState(android.os.Bundle savedInstanceState)

Overrides:

onRestoreInstanceState in class android.app.Activity

getFigureView

public FigureView<G> getFigureView()

Replies the viewer of figures.

Returns:

the viewer of figures.

onCreateThumbnail

public boolean onCreateThumbnail(android.graphics.Bitmap outBitmap,
                        android.graphics.Canvas canvas)

Overrides:

onCreateThumbnail in class android.app.Activity

onBackPressed

public void onBackPressed()

Overrides:

onBackPressed in class android.app.Activity

killApplication

protected void killApplication()

Kill the application.

onDestroy

protected void onDestroy()

Overrides:

onDestroy in class android.app.Activity

onActionPerformed

protected void onActionPerformed(boolean isEditionEnabled,
                     Point2D hitPoint,
                     Figure... figures)

Invoked when the user want to perform the standard action on the given figures.

By default this function does nothing.

Parameters:

isEditionEnabled - indicates if the figures can be edited.

hitPoint - is the point where the action is performed. It may be null if the position is unknown.

figures - are the figures on which the action must be performed

onSecondaryActionPerformed

protected void onSecondaryActionPerformed(boolean isEditionEnabled,
                              Figure... figures)

Invoked when the user want to perform the standard secondary action on the given figures.

By default this function open the property editor for the figures.

Parameters:

isEditionEnabled - indicates if the figures can be edited.

figures -

isSelectionMode

public boolean isSelectionMode()

Replies if the activity is in selection mode.

Returns:

true if in selection mode.

onActivityResult

protected void onActivityResult(int requestCode,
                    int resultCode,
                    android.content.Intent data)

Overrides:

onActivityResult in class android.app.Activity

runNewDocumentAction

protected void runNewDocumentAction(boolean askToSave)

Run the new action.

Parameters:

askToSave - is true if the user must answer to "Want to save?".

runLoadAction

protected void runLoadAction(boolean askToSave)

Run the loading action.

Parameters:

askToSave - is true if the user must answer to "Want to save?".

getPreferredFileFilter

protected abstract Class<? extends FileFilter> getPreferredFileFilter()

Replies the type of the preferred file filter for this activity.

Returns:

the file filter type of null for the default type.

See Also:

OpenableDocumentFileFilter

getPreferredGraphType

protected abstract Class<G> getPreferredGraphType()

Replies the type of the graph supported by this editor.

Returns:

the type of the graph.

getPreferredFigureFactory

protected abstract Class<? extends FigureFactory<G>> getPreferredFigureFactory()

Replies the type of the figure factory supported by this editor.

Returns:

the type of the figure factory.

runSaveAction

protected void runSaveAction()

Run the saving action. The user is not asked prior saving.

runSaveAsAction

protected void runSaveAsAction()

Run the save-as action.