Package com.studentgui.apppages

Class BrailleNote

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

com.studentgui.apppages.BrailleNote

All Implemented Interfaces:

DateChangeListener, StudentChangeListener, ImageObserver, MenuContainer, Serializable, Accessible

public class BrailleNote
extends JPanel
implements DateChangeListener, StudentChangeListener

HumanWare BrailleNote Touch Plus (BNT+) proficiency assessment page.

Evaluates student competency with the BrailleNote Touch Plus refreshable braille notetaker and productivity device across 52 skills organized into 12 functional domains:

• Phase 1 (P1_1–P1_9): Device Fundamentals and Core Applications
  • Physical layout (braille keyboard, navigation keys, touchscreen, ports)
  • Setup procedures and universal commands (power, mode switching, context menus)
  • BNT+ navigation paradigm (gestures, quick keys, braille commands)
  • File management (folders, copy/paste, rename, delete)
  • Word processor (KeyWord): document creation, editing, formatting
  • Email (KeyMail): compose, send, receive, attachments
  • Internet browsing (KeyWeb): navigation, bookmarks, forms
  • Calculator and KeyMath (arithmetic, scientific functions)
• Phase 2 (P2_1–P2_7): Productivity Suite Applications
  • Calendar management (appointments, reminders, recurring events)
  • KeyBRF (Braille file viewer/editor)
  • KeyFiles (file explorer and organizer)
  • KeyMail (advanced email features)
  • KeyWeb (advanced browsing, accessibility modes)
  • KeyCalc (spreadsheet concepts)
  • KeyWord (advanced formatting, styles, tables)
• Phase 3 (P3_1–P3_7): Advanced Applications and Accessibility
  • KeySlides (presentation creation and delivery)
  • KeyCode (text editor with syntax highlighting for programming)
  • Third-party app integration (Dropbox, Google Drive, OneDrive)
  • Braille input configuration (computer braille, contracted, literary)
  • Braille output settings (display mode, translation tables)
  • Device settings and preferences
  • Accessibility features (speech output, magnification, contrast)
• Phase 4 (P4_1–P4_3): Advanced File and Cloud Management
• Phase 5 (P5_1–P5_4): Collaboration and Export Workflows
• Phase 6 (P6_1–P6_3): App Ecosystem and Troubleshooting
• Phase 7 (P7_1–P7_4): Automation and Customization
• Phase 8 (P8_1–P8_5): Peripheral Integration (Bluetooth/USB devices, displays, audio/video)
• Phase 9 (P9_1–P9_4): Security and Network Configuration
• Phase 10 (P10_1–P10_3): Speech Engine Customization
• Phase 11 (P11_1–P11_5): Maintenance and Support (firmware, diagnostics, warranty)
• Phase 12 (P12_1–P12_4): Community and Online Resources

Data Management and Artifacts:

• Scores captured via PhaseScoreField (integer 0–4 typical)
• Persisted to normalized schema via Database.insertAssessmentResults(int, int, java.lang.String[], int[])
• JSON export: StudentDataFiles/<student>/Sessions/BrailleNote/BrailleNote-<sessionId>-<timestamp>.json
• Phase-grouped time-series plots: plots/BrailleNote-<sessionId>-<date>-P<N>.png (12 phase groups)
• Markdown and HTML reports with embedded plots and color-coded legends

The shared JLineGraph visualizes recent session trends grouped by phase prefix. Implements DateChangeListener and StudentChangeListener for dynamic updates when global student/date selections change.

See Also:

• Database
• JLineGraph
• PhaseScoreField
• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
BrailleNote(String studentName, LocalDate date, JLineGraph lineGraph)	Create the BrailleNote page for a specific student and date.

Method Summary

Modifier and Type	Method	Description
void	dateChanged(LocalDate newDate)	Called when the application date has been changed by the user.
void	studentChanged(String newStudent)	Called when the application selected student has changed.

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Details

BrailleNote

public BrailleNote(String studentName,
 LocalDate date,
 JLineGraph lineGraph)

Create the BrailleNote page for a specific student and date.

Parameters:

studentName - the selected student name (may be null until a student is chosen)

date - the date for the session (used when creating a progress session)

lineGraph - shared graph component used to display recent results

Method Details

dateChanged

public void dateChanged(LocalDate newDate)

Description copied from interface: DateChangeListener

Called when the application date has been changed by the user.

Specified by:

dateChanged in interface DateChangeListener

Parameters:

newDate - the newly selected date

studentChanged

public void studentChanged(String newStudent)

Description copied from interface: StudentChangeListener

Called when the application selected student has changed.

Specified by:

studentChanged in interface StudentChangeListener

Parameters:

newStudent - the newly selected student's display name (may be null)