BlocklySectionsActivity

public abstract class BlocklySectionsActivity extends AbstractBlocklyActivity
implements AdapterView.OnItemClickListener

Activity holding a full-screen Blockly workspace with multiple sections in the navigation menu.

Field Summary

protected int	mCurrentSection
protected ListAdapter	mListAdapter
protected ListView	mSectionsListView

Inherited Field Summary

From class com.google.blockly.android.AbstractBlocklyActivity

protected ActionBar	mActionBar
protected BlocklyActivityHelper	mBlocklyActivityHelper
protected DrawerLayout	mDrawerLayout
protected ActionBarDrawerToggle	mDrawerToggle
protected View	mNavigationDrawer

Public Constructor Summary

BlocklySectionsActivity()

Public Method Summary

final int	getCurrentSectionIndex()
void	onItemClick(AdapterView<?> parent, View view, int position, long id) Handles clicks to mSectionsListView by calling onSectionItemClicked(int) with the selected position.
void	onSectionItemClicked(int sectionIndex) Handles the selection of a section, including closing the navigation drawer.

Protected Method Summary

int	getSectionCount()
CharSequence	getWorkspaceTitle()
void	onCreate(Bundle savedInstanceState) Creates the activity's views and fragments (via onCreateActivityRootView(), and then initializes Blockly via onCreateActivityHelper(), using the values from getBlockDefinitionsJsonPaths() and getToolboxContentsXmlPath().
View	onCreateAppNavigationDrawer() Creates mSectionsListView and configures it with onCreateSectionsListAdapter() to use as the activity's navigation menu.
abstract ListAdapter	onCreateSectionsListAdapter() Populate the navigation menu with the list of available sections.
abstract boolean	onSectionChanged(int oldSection, int newSection) Called to load a new Section.

Inherited Method Summary

From class com.google.blockly.android.AbstractBlocklyActivity

boolean	checkAllowRestoreBlocklyState(Bundle savedInstanceState) Returns true if the app should proceed to restore the blockly state from the savedInstanceState Bundle or the auto save file.
void	configureBlockExtensions() This method provides a hook to register BlockExtensions that support the block definitions in this activity.
void	configureCategoryFactories() This method provides a hook to register custom CustomCategorys that support the toolboxes in this activity.
void	configureMutators() This method provides a hook to register Mutator.Factorys and MutatorFragment.Factorys that support the block definitions in this activity.
int	getActionBarMenuResId()
abstract List<String>	getBlockDefinitionsJsonPaths()
LanguageDefinition	getBlockGeneratorLanguage()
abstract CodeGenerationRequest.CodeGeneratorCallback	getCodeGenerationCallback() Returns a generation callback to use for the most recently requested "Run" action.
final BlocklyController	getController()
abstract List<String>	getGeneratorsJsPaths() Returns the asset file paths to the generators (JS files) to use for the most recently requested "Run" action.
abstract String	getToolboxContentsXmlPath()
String	getWorkspaceAutosavePath()
String	getWorkspaceSavePath()
CharSequence	getWorkspaceTitle()
boolean	isNavDrawerOpen()
boolean	onAutoload() Called when the activity tries to restore the autosaved workspace, typically by onCreate(Bundle) if there was no workspace data in the bundle.
void	onAutosave() Called when an autosave of the workspace is triggered, typically by onPause().
void	onBackPressed() Handles the back button.
boolean	onBackToCloseNavMenu()
void	onClearWorkspace() Called when the user clicks the clear action.
void	onCreate(Bundle savedInstanceState) Creates the activity's views and fragments (via onCreateActivityRootView(), and then initializes Blockly via onCreateActivityHelper(), using the values from getBlockDefinitionsJsonPaths() and getToolboxContentsXmlPath().
BlocklyActivityHelper	onCreateActivityHelper() Create a BlocklyActivityHelper to use for this Activity.
void	onCreateActivityRootView() Creates or loads the root content view (by default, drawers_and_action_bar) for the Activity.
View	onCreateAppNavigationDrawer()
View	onCreateContentView(int containerId) Constructs (or inflates) the primary content view of the Activity.
boolean	onCreateOptionsMenu(Menu menu)
void	onInitBlankWorkspace() Hook for subclasses to initialize a new blank workspace.
void	onLoadInitialWorkspace() Hook for subclasses to load an initial workspace.
void	onLoadWorkspace() Called when the user clicks the load action.
boolean	onOptionsItemSelected(MenuItem item)
void	onPause() Propagate lifecycle event to BlocklyActivityHelper.
void	onRestart() Propagate lifecycle event to BlocklyActivityHelper.
void	onResume() Propagate lifecycle event to BlocklyActivityHelper.
void	onRunCode() Runs the code generator.
void	onSaveInstanceState(Bundle outState) Saves a snapshot of the workspace to outState.
void	onSaveWorkspace() Called when the user clicks the save action.
void	onStart() Propagate lifecycle event to BlocklyActivityHelper.
void	onStop() Propagate lifecycle event to BlocklyActivityHelper.
void	reloadToolbox() Reloads the toolbox contents using the path provided by getToolboxContentsXmlPath().
void	resetBlockFactory() Reloads the block definitions, including extensions and mutators.
void	restoreActionBar() Restores the ERROR(/ActionBar) contents when the navigation window closes, per Material design guidelines.
void	setNavDrawerOpened(boolean open) Opens or closes the navigation drawer.
void	setupAppNaviagtionDrawer() Configures the activity to support a navigation menu and drawer provided by onCreateAppNavigationDrawer().

From class java.lang.Object

Object	clone()
boolean	equals(Object arg0)
void	finalize()
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

From interface android.widget.AdapterView.OnItemClickListener

abstract void

onItemClick(AdapterView<?> arg0, View arg1, int arg2, long arg3)

Fields

protected int mCurrentSection

protected ListAdapter mListAdapter

protected ListView mSectionsListView

Public Constructors

public BlocklySectionsActivity ()

Public Methods

public final int getCurrentSectionIndex ()

Returns

• The section that is currently displayed.

public void onItemClick (AdapterView<?> parent, View view, int position, long id)

Handles clicks to mSectionsListView by calling onSectionItemClicked(int) with the selected position.

Parameters

parent	The ListView.
view	The selected item view.
position	The position in the list.
id	The id of the list item.

public void onSectionItemClicked (int sectionIndex)

Handles the selection of a section, including closing the navigation drawer.

Protected Methods

protected int getSectionCount ()

Returns

• The number of sections in this activity.

protected CharSequence getWorkspaceTitle ()

Returns

• The title of the current workspace / section.

protected void onCreate (Bundle savedInstanceState)

Creates the activity's views and fragments (via onCreateActivityRootView(), and then initializes Blockly via onCreateActivityHelper(), using the values from getBlockDefinitionsJsonPaths() and getToolboxContentsXmlPath(). Subclasses should override those methods to configure the Blockly environment.

Once the controller and fragments are configured, if checkAllowRestoreBlocklyState(Bundle) returns true, the activity will attempt to load a prior workspace from the instance state bundle. If no workspace is loaded, it defers to onLoadInitialWorkspace().

Parameters

savedInstanceState

protected View onCreateAppNavigationDrawer ()

Creates mSectionsListView and configures it with onCreateSectionsListAdapter() to use as the activity's navigation menu.

Returns

• mSectionsListView for the navigation menu.

protected abstract ListAdapter onCreateSectionsListAdapter ()

Populate the navigation menu with the list of available sections.

Returns

• An adapter of sections for the navigation menu.

protected abstract boolean onSectionChanged (int oldSection, int newSection)

Called to load a new Section. If you don't want to re-use the previous section's code loadWorkspaceContents(InputStream) should be called here.

Parameters

oldSection	The previous level.
newSection	The level that was just configured.

Returns

• True if the new section was successfully loaded. Otherwise false.