Applies to
Controls that accept user input, including list boxes, MultiLineEdit, SingleLineEdit, ListView, EditMask, and TreeView
Description
Accelerator keys allow users to select an item (that is, change focus) with a keystroke rather than the mouse. An underlined character in the item's name or label tells the user what key to press. The user presses it in combination with the Alt key. If the currently selected control is not an editable control (such as a SingleLineEdit, MultiLineEdit, ListBox, or DropDownListBox), you need only press the accelerator key.
Accelerator keys are different from shortcut keys, which are defined key combinations that provide a quick way to accomplish certain tasks.
|
PowerBuilder term |
Windows term |
|---|---|
|
accelerator key |
mnemonic access character |
|
shortcut key |
shortcut key or accelerator key |
Usage
In a painter
To select a character as an accelerator key
-
Type the character into the Accelerator box on the General page of the control's Properties view.
For example, to set m as the accelerator, type m in the box.
Accelerators for unlabeled controls
To show the user what accelerator key to use for an unlabeled control or box, define StaticText to act as a label. Include an ampersand (&) before the character you want underlined. For example, in the StaticText control's General page, set the Text property to a value like Edit &Maintenance Data for a drop-down list that has m as an accelerator key. If you want an ampersand to display in the text, type two ampersands, and if you want an ampersand to display and serve as the accelerator key, type three ampersands.
In scripts
The Accelerator property is an integer consisting of the ASCII value of the accelerator key. Both of the following lines set m as the accelerator character for a MultiLineEdit control:
mle_1.Accelerator=77
mle_1.Accelerator = ASC("M")