will/thechart
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a521ed6e9aca68077428be0f692ae07938a04ba0
thechart/docs_backup_20250805_145312/docs/KEYBOARD_SHORTCUTS.md
William Valentin a521ed6e9a
Some checks failed
Build and Push Docker Image / build-and-push (push) Has been cancelled
Details
Add quick test runner and enhance run_tests script 
- Introduced `quick_test.py` for running specific test categories (unit, integration, theme, all).
- Updated `run_tests.py` to improve test execution and reporting, including coverage.
- Removed outdated test scripts for keyboard shortcuts, menu theming, note saving, and entry updating.
- Added new test script `test_theme_changing.py` to verify theme changing functionality.
- Consolidated integration tests into `test_integration.py` for comprehensive testing of TheChart application.
- Updated theme manager to ensure color retrieval works correctly.
- Modified test constants to import from the correct module path.
2025-08-05 15:09:13 -07:00

2.7 KiB
Raw Blame History

Keyboard Shortcuts

TheChart application supports comprehensive keyboard shortcuts for improved productivity and efficient navigation.

File Operations

  • Ctrl+S: Save/Add new entry - Saves the current entry data to the database
  • Ctrl+Q: Quit application - Exits the application (with confirmation dialog)
  • Ctrl+E: Export data - Opens the export dialog window

Data Management

  • Ctrl+N: Clear entries - Clears all input fields to start a new entry
  • Ctrl+R or F5: Refresh data - Reloads data from the CSV file and updates the display

Window Management

  • Ctrl+M: Manage medicines - Opens the medicine management window
  • Ctrl+P: Manage pathologies - Opens the pathology management window

Table Operations

  • Delete: Delete selected entry - Deletes the currently selected entry in the table (with confirmation)
  • Escape: Clear selection - Clears the current selection in the table
  • Double-click: Edit entry - Opens the edit dialog for the selected entry

Help

  • F1: Show keyboard shortcuts help - Displays a dialog with all available keyboard shortcuts

Implementation Details

Menu Integration

All keyboard shortcuts are displayed in the menu bar next to their corresponding menu items for easy reference.

Button Labels

Primary action buttons show their keyboard shortcuts in the button text (e.g., "Add Entry (Ctrl+S)").

Case Sensitivity

  • Shortcuts are case-insensitive
  • Both Ctrl+S and Ctrl+Shift+S work
  • Uppercase and lowercase variants are supported

Focus Requirements

  • Keyboard shortcuts work when the main window has focus
  • Focus is automatically set to the main window on startup
  • Shortcuts work across all tabs and interface elements

Feedback System

  • All operations provide feedback through the status bar
  • Success and error messages are displayed
  • Confirmation dialogs are shown for destructive operations (quit, delete)

Usage Tips

Quick Workflow

  1. Ctrl+N - Clear fields for new entry
  2. Enter data in the form
  3. Ctrl+S - Save the entry
  4. F5 - Refresh to see updated data

Navigation

  • Use Ctrl+M and Ctrl+P to quickly access management windows
  • Use Delete to remove unwanted entries from the table
  • Use Escape to clear selections when needed

Getting Help

  • Press F1 anytime to see the keyboard shortcuts help dialog
  • All shortcuts are also visible in the menu bar
  • Button tooltips show additional keyboard shortcut information

Accessibility

  • Keyboard shortcuts provide full application functionality without mouse use
  • All critical operations have keyboard equivalents
  • Shortcuts follow standard application conventions (Ctrl+S for save, Ctrl+Q for quit)
  • Help system is easily accessible via F1