# Using the Telemetry Console Extension

# Keyboard Reference

Most of the Telemetry Console Extension documentation tells how to accomplish tasks using the mouse. However, you can accomplish virtually all of those tasks using the keyboard only, as described in the following sections:

- Terms and Conventions
- Navigating and Selecting
- Keyboard Reference
- Selecting Items and Giving Focus to Items Using the Keyboard

## Terms and Conventions

The following terms and conventions are used in Table 6-1:

- Controls are items such as buttons, tabs, text fields, and sliders that you use to perform actions or view information. In some circumstances, a control may be disabled, which means that it is not available in the current context. For example, if no views have unsaved changes, the button for saving all views is disabled, and you are unable to select it using the keyboard. In that case, the appearance of the button is changed; for example it may be all gray, depending on the platform.
- Two key names separated by a + (plus sign), for example Shift+Tab, indicates that you must hold down the first key, then press the second named key, then release both keys.

## Navigating and Selecting

You can use the keyboard to navigate through the Telemetry Console Extension, for example, press the Tab key to move from one control to the other. However, navigating to a control does not initiate an action with the control; it simply makes it available for receiving the next keyboard input. For example, you can press Tab to navigate to a button but you must then press Enter to press the button. In most cases, this is straightforward, and you do not have to be aware of the distinction. A visual cue indicates that an item is selected. For example, a chart is surrounded by a box, or the data points and (legend entry icon) in a scatter plot graph may be displayed as stars. (The visual cues may be different on different platforms.)

The Telemetry Console Extension has two main panels, the Tabs panel and the View panel, and one of those tabs is always active. Keyboard input affects whatever control is selected in the active panel. For example, if an edit field is selected in the active panel, any characters you type on the keyboard are added to that edit field.

Certain actions affect the selected item in the panel that is not active. For example, you can navigate to a chart in the View panel and select the chart. You can then navigate to the Selected Item Properties tab in the Tabs panel and make a change to a property (that is, select the control that sets the property's value, change the value, navigate to the Apply Changes button, and press Enter to push the button). When you apply the changes, the property is changed in the chart selected in the (non-active) View tab.

The (Focus Context) button on the toolbar indicates which panel is active. When the arrow on the button points left, the Tabs panel (on the left) is active. When it points right, the View panel (on the right) is active.

## Keyboard Reference

Table 6-1 describes how to use the keyboard to accomplish tasks in the Telemetry Console Extension.

Table 6-1 Telemetry Console Extension Keyboard Access
Pressing this key or these keys... | When this item is selected... | Does this...
--- | --- | ---
Enter | Any button | Presses the button.
Tab | Tabs panel (the panel on the left side of the page) | Selects the next active control. Repeatedly pressing the Tab key cycles through all active controls in the toolbar and the current tab. (That is, one control after another is selected, while the previously selected control is deselected. After the last control is selected, pressing the Tab key again starts the process again.)
Shift+Tab | Tabs panel | Same as Tab, above, but selects the previous instead of the next active control.
Tab | View panel (the panel on the right side of the page) | Selects the next chart in the view. Repeatedly pressing the Tab key cycles through all the charts.
Shift+Tab | View panel | Same as Tab, above, but selects the previous instead of the next chart.
(Right arrow) | Toolbar | Selects the next active button in the toolbar. Repeatedly pressing the arrows cycles through the active buttons in the toolbar.
(Left arrow) | Toolbar | Same as , above, but selects the previous instead of the next button.
(Right arrow) | Tab controls (labels) in the Tabs panel | Selects the next tab. Repeatedly pressing the arrows cycles through all tabs.
(Left arrow) | Tab controls (labels) in the Tabs panel | Same as , above, but selects the previous instead of the next tab.
(Down arrow) | Tree of view names in the Views tab | Selects the next view or folder.
(Up arrow) | Tree of view names in the Views tab | Selects the previous view or folder.
Shift+ (Right arrow) | View panel | Selects the next chart in the current view. Repeatedly pressing the Shift+ cycles through all the charts in the view.
Note: | If the Tabs panel is active when you click Shift+ , the View panel becomes active, and the next chart is selected.
Shift+ (Left arrow) | View panel | Same as Shift+, above, but selects the previous instead of the next chart.
Shift+ (Down arrow) | View panel | Selects the next graph in the current chart, or if there are no more graphs in the chart, selects the first graph in the next chart. Repeatedly pressing Shift+ cycles through all the graphs in all the charts in the view.
Note: | If the Tabs panel has is active when you click Shift+, the View panel becomes active, and the next graph is selected.
Shift+ (Up arrow) | View panel | Same as Shift+, above, but selects the previous instead of the next graph.
(Down arrow) | View panel | Scrolls the contents of the panel up, if they extend beyond the visible area.
(Up arrow) | View panel | Scrolls the contents of the panel down, if they extend beyond the visible area.
(Right arrow) | Slider control | Moves the slider control to the right.
(Left arrow) | Slider control | Moves the slider control to the left.
Space bar | Check box | Selects or deselects the check box.

## Selecting Items and Giving Focus to Items Using the Keyboard

An item can be selected, have focus, or both at the same time. When you use the mouse to manipulate objects, the distinction may not obvious, nor does it have to be. For example, you can click a chart in the View panel to select it and then click a control in the Selected Item Properties tab to change some property of the selected chart. You do not have to know anything about selection and focus except that you selected the chart and now you are doing something to it.

However, if you use the keyboard, you will sometimes have to make more explicit decisions about selecting and giving focus to objects. The instructions for selecting and giving focus to items are given in Table 6-1. The principles are as follows:

- When an item has the focus, it is available to accept the next input from the keyboard. In most cases, a visual cue indicates that an item has focus. For example, a chart is surrounded by a box, or the data points and (legend entry icon) in a scatter plot graph may be displayed as stars. The visual cues may be different on different platforms.

The (Focus Context) button indicates which panel has focus. When the arrow on the button points left, the Tabs panel (on the left) has focus. When it points right, the View panel (on the right) has focus.

- In certain cases, an item can be selected but not have focus, so that the action initiated with the control that has focus affects the item that is selected. For example, you can select a chart in the View panel, then switch focus to the Selected Properties tab to make changes to the selected chart. The chart remains selected, but the focus switches to whichever control you choose in the Selected Properties tab, for example, the Name field. In most cases, a visual cue indicates that an item is selected. For example, the cursor blinks in a text entry field. The visual cues may be different on different platforms.
- When you select an item using the keyboard or the mouse, you both select it and give it focus. However, if you are working in one panel and then select an item in the other panel, whatever had focus in the original panel remains selected in that panel.