ListTbl Users Guide
Doug Lee
Last Revised July, 2023

This short document explains how to use the ListTbl scripts for navigating supported controls with JAWS in any application. These scripts require JAWS version 15.0 or later.

Table of Contents

What Is ListTbl?

These scripts make standard HTML table navigation commands (Ctrl+Alt with arrows, Home, End, etc.) apply to various types of controls. This facilitates scanning down columns other than column 1 without having to type numerous or difficult key sequences. There are also a few added commands for clicking cells and column headers without having to use the JAWS cursor. The JAWS Table Layer commands also work on supported controls.

The types of controls supported by these scripts are

Script Installation Instructions

To install these scripts on a new system:

  1. Load JAWS if this has not already been done. This will require administrative privileges on the computer.
  2. Run JAWS as the user for whom the scripts are to be installed. This and the following steps must be performed for each user of the computer who will be using JAWS with these scripts.
  3. Download and run, or run directly, the installer for these scripts; and follow the on-screen directions. Be sure to install the scripts in the currently running JAWS version if a JAWS version list is presented.

Commands and Features

The primary feature of these scripts is to make the standard JAWS table navigation commands work in supported controls. This works in all supported JAWS keyboard layouts and uses the same keystrokes in each as appear in HTML environments. The Table Layer commands also work on supported controls.

In addition to the standard table navigation commands though, these scripts add a few commands for left-clicking and right-clicking "cells" and column headers in supported controls. These added commands work only in supported controls and do not carry over to HTML environments. The following table lists the available functions with the commands for each supported keyboard layout:

Added Click Support Commands
Function Common/Desktop Layout Laptop and Classic Laptop Layouts Kinesis Layout Table Layer Description
Left-click cell Ctrl+Alt+NumPad / Ctrl+Alt+8 Ctrl+Alt+I NumPad / Left-clicks The Current Cell In The ListView.
Right-click cell Ctrl+Alt+NumPad * Ctrl+Alt+9 Ctrl+Alt+O NumPad * Right-clicks The Current Cell In The ListView.
Left-click header Ctrl+Shift+Alt+NumPad / Ctrl+Shift+Alt+8 Ctrl+Shift+Alt+I Shift+NumPad / Left-clicks The Column Header Above The Current Cell In The ListView.
Right-click header Ctrl+Shift+Alt+NumPad * Ctrl+Shift+Alt+9 Ctrl+Shift+Alt+O Shift+NumPad * Right-clicks The Column Header Above The Current Cell In The ListView.

Note: Though standard JAWS Table Layer commands do not exit the Table Layer, the above Table Layer commands will do so. This is because clicking cells and headers usually causes new or reorganized screens to appear, whereas the standard JAWS Table Layer commands simply navigate among cells. As a side effect, it will be necessary to use commands outside of the Table Layer in order to double-click cells.

Usage Examples

In the following examples, the Common/Desktop layout is assumed. For other layouts or the Table Layer, substitute appropriate keystrokes as necessary.

ListTbl usage examples
Task Action(s)
Read each cell in the current row with its header. Use Ctrl+Alt+Right to move one cell at a time to the right across the row, Ctrl+Alt+Left to move left, and Ctrl+Alt+NumPad 5 to announce the current cell with header and position information.. The normal JAWS ListView commands for reading cells (JAWSKey+Ctrl+1-9/0) also work for ListView controls but do not provide a means for examining more than the first ten columns of a wide list. These native JAWS commands also will not work in Windows 10 Task Manager TreeView controls unless JAWS begins natively to support this.
Find the largest file in a Windows Explorer file list Either use Ctrl+Alt+Left/right to move to the Size column and then scan through sizes manually with Ctrl+Alt+Up/down, or
  • Find the Size column using Ctrl+Alt+Left/right.
  • Left-click the Size column header twice with Ctrl+Shift+Alt+NumPad /, once to sort the list by ascending size, and once to reverse the sort and place the largest file at the top of the list.
  • Use any desired means to move to the top row, a good one being Ctrl+Alt+Home to move to column 1 of the top row.
Find out which process is using the most CPU time. In the Processes tab of the Task Manager, sort the list by CPU, just as was done for Size in the previous example; then check the top row. The same approach also works for finding the process that is consuming the most memory. Beware, though, that this list is very dynamic when sorted by CPU or memory usage and can reorder frequently as process resource utilization changes.
Add or remove columns in Windows Explorer file lists (Windows 7 and older) From any row, type Ctrl+Shift+Alt+NumPad * to right-click a column header. In the Context menu that appears, column names appear, checked if displayed and not checked if not displayed. Press Enter on a checked column to remove it or on an unchecked column to add it.

Revision History

Here is the revision history of these scripts, most recent revision first. Note that revision numbers for these scripts are artificially high because these scripts were initially part of BX.

Revision 2392, released July 10, 2023

Revision 2387, released September 08, 2020

Revision 2119, April 9, 2019

Revision 1878, September 11, 2017

Revision 1691, July 22, 2016

Revision 1689, July 19, 2016

Revision 1600, January 19, 2016

Revision 57, January 7, 2014