The Q3Accel 类处理键盘加速键和快捷键。 更多...
| 头： | #include <Q3Accel> |
| 继承： | QObject |
| Q3Accel (QWidget * parent , const char * name = 0) | |
| Q3Accel (QWidget * watch , QObject * parent , const char * name = 0) | |
| ~Q3Accel () | |
| void | clear () |
| bool | connectItem (int id , const QObject * receiver , const char * member ) |
| uint | count () const |
| bool | disconnectItem (int id , const QObject * receiver , const char * member ) |
| int | findKey (const QKeySequence & key ) const |
| int | insertItem (const QKeySequence & key , int id = -1) |
| bool | isEnabled () const |
| bool | isItemEnabled (int id ) const |
| QKeySequence | key (int id ) |
| void | removeItem (int id ) |
| void | setEnabled (bool enable ) |
| void | setItemEnabled (int id , bool enable ) |
| void | setWhatsThis (int id , const QString & text ) |
| QString | whatsThis (int id ) const |
| void | activated (int id ) |
| void | activatedAmbiguously (int id ) |
| QKeySequence | shortcutKey (const QString & str ) |
The Q3Accel 类处理键盘加速键和快捷键。
A keyboard accelerator triggers an action when a certain key combination is pressed. The accelerator handles all keyboard activity for all the children of one top-level widget, so it is not affected by the keyboard focus.
In most cases, you will not need to use this class directly. Use the QAction class to create actions with accelerators that can be used in both menus and toolbars. If you're only interested in menus use Q3MenuData::insertItem() or Q3MenuData::setAccel() to make accelerators for operations that are also available on menus. Many widgets automatically generate accelerators, such as QAbstractButton , QGroupBox , QLabel (with QLabel::setBuddy ()), QMenuBar ，和 QTabBar 。范例：
QPushButton p("&Exit", parent); // automatic shortcut Alt+E Q3PopupMenu *fileMenu = new fileMenu(parent); fileMenu->insertItem("Undo", parent, SLOT(undo()), Qt::CTRL + Qt::Key_Z);
A Q3Accel contains a list of accelerator items that can be manipulated using insertItem (), removeItem (), clear (), key () 和 findKey ().
Each accelerator item consists of an identifier and a QKeySequence . A single key sequence consists of a keyboard code combined with modifiers ( Qt::SHIFT , Qt::CTRL , Qt::ALT ，或 Qt::UNICODE_ACCEL ). For example, Qt::CTRL + Qt::Key_P could be a shortcut for printing a document. As an alternative, use Qt::UNICODE_ACCEL with the unicode code point of the character. For example, Qt::UNICODE_ACCEL + 'A' gives the same accelerator as Qt::Key_A .
When an accelerator key is pressed, the accelerator sends out the signal activated () with a number that identifies this particular accelerator item. Accelerator items can also be individually connected, so that two different keys will activate two different slots (see connectItem () 和 disconnectItem ()).
The activated () signal is not emitted when two or more accelerators match the same key. Instead, the first matching accelerator sends out the activatedAmbiguously () signal. By pressing the key multiple times, users can navigate between all matching accelerators. Some standard controls like QPushButton and QCheckBox connect the activatedAmbiguously () signal to the harmless setFocus() slot, whereas activated () is connected to a slot invoking the button's action. Most controls, like QLabel and QTabBar , treat activated () 和 activatedAmbiguously () as equivalent.
使用 setEnabled () to enable or disable all the items in an accelerator, or setItemEnabled () to enable or disable individual items. An item is active only when both the Q3Accel and the item itself are enabled.
函数 setWhatsThis () specifies a help text that appears when the user presses an accelerator key in What's This mode.
The accelerator will be deleted when parent is deleted, and will consume relevant key events until then.
Please note that the accelerator
accelerator->insertItem(QKeySequence("M"));
can be triggered with both the 'M' key, and with Shift+M, unless a second accelerator is defined for the Shift+M combination.
范例：
Q3Accel *a = new Q3Accel(myWindow); a->connectItem(a->insertItem(Qt::CTRL + Qt::Key_P), myWindow, SLOT(printDoc()));
QAbstractButton::setAccel () QLabel::setBuddy () QKeySequence
另请参阅 QKeyEvent and QWidget::keyPressEvent ().
构造 Q3Accel 对象称为 name ，采用父级 parent . The accelerator operates on parent .
构造 Q3Accel 对象称为 name , that operates on watch , and is a child of parent .
This constructor is not needed for normal application programming.
Destroys the accelerator object and frees all allocated resources.
[signal]
void
Q3Accel::
activated
(
int
id
)
此信号被发射，当用户键入快捷方式的键序列时。 id is a number that identifies this particular accelerator item.
另请参阅 activatedAmbiguously ().
[signal]
void
Q3Accel::
activatedAmbiguously
(
int
id
)
This signal is emitted when the user types a shortcut key sequence that is ambiguous. For example, if one key sequence is a "prefix" for another and the user types these keys it isn't clear if they want the shorter key sequence, or if they're about to type more to complete the longer key sequence. id is a number that identifies this particular accelerator item.
另请参阅 activated ().
Removes all accelerator items.
Connects the accelerator item id to the slot member of receiver . Returns true if the connection is successful.
a->connectItem(201, mainView, SLOT(quit()));
Of course, you can also send a signal as member .
Normally accelerators are connected to slots which then receive the
activated(int id)
signal with the id of the accelerator item that was activated. If you choose to connect a specific accelerator item using this function, the
activated()
signal is emitted if the associated key sequence is pressed but no
activated(int id)
信号发射。
另请参阅 disconnectItem () 和 QObject::connect ().
Returns the number of accelerator items in this accelerator.
Disconnects the accelerator item identified by id from the function called member 在 receiver object. Returns true if the connection existed and the disconnect was successful.
另请参阅 connectItem () 和 QObject::disconnect ().
Returns the identifier of the accelerator item with the key code key ，或 -1 若找不到项。
Inserts an accelerator item and returns the item's identifier.
key is a key code and an optional combination of SHIFT, CTRL and ALT. id is the accelerator item id.
若 id is negative, then the item will be assigned a unique negative identifier less than -1.
Q3Accel *a = new Q3Accel(myWindow); // create accels for myWindow a->insertItem(CTRL + Key_P, 200); // Ctrl+P, e.g. to print document a->insertItem(ALT + Key_X, 201); // Alt+X, e.g. to quit a->insertItem(UNICODE_ACCEL + 'q', 202); // Unicode 'q', e.g. to quit a->insertItem(Key_D); // gets a unique negative id < -1 a->insertItem(CTRL + SHIFT + Key_P); // gets a unique negative id < -1
Returns true if the accelerator is enabled; otherwise returns false.
另请参阅 setEnabled () 和 isItemEnabled ().
Returns true if the accelerator item with the identifier id is enabled. Returns false if the item is disabled or cannot be found.
另请参阅 setItemEnabled () 和 isEnabled ().
Returns the key sequence of the accelerator item with identifier id , or an invalid key sequence (0) if the id cannot be found.
Removes the accelerator item with the identifier id .
Enables the accelerator if enable is true, or disables it if enable 为 false。
Individual keys can also be enabled or disabled using setItemEnabled (). To work, a key must be an enabled item in an enabled Q3Accel .
另请参阅 isEnabled () 和 setItemEnabled ().
Enables the accelerator item with the identifier id if enable is true, and disables item id if enable 为 false。
To work, an item must be enabled and be in an enabled Q3Accel .
另请参阅 isItemEnabled () 和 isEnabled ().
Sets a What's This help text for the accelerator item id to text .
The text will be shown when the application is in What's This mode and the user hits the accelerator key.
To set What's This help on a menu item (with or without an accelerator key), use Q3MenuData::setWhatsThis().
另请参阅 whatsThis (), QWhatsThis::inWhatsThisMode ()，和 QAction::setWhatsThis ().
[static]
QKeySequence
Q3Accel::
shortcutKey
(const
QString
&
str
)
Returns the shortcut key sequence for str , or an invalid key sequence (0) if str has no shortcut sequence.
For example, shortcutKey("E&xit") returns QKeySequence ( Qt::ALT + Qt::Key_X ), shortcutKey("&Quit") returns QKeySequence ( Qt::ALT + Qt::Key_Q ), and shortcutKey("Quit") returns QKeySequence().
Returns the What's This help text for the specified item id or an empty string if no text has been specified.
另请参阅 setWhatsThis ().