You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
170 lines
7.4 KiB
170 lines
7.4 KiB
'\" t
|
|
.TH QKeySequence 3qt "2 February 2007" "Trolltech AS" \" -*- nroff -*-
|
|
.\" Copyright 1992-2007 Trolltech ASA. All rights reserved. See the
|
|
.\" license file included in the distribution for a complete license
|
|
.\" statement.
|
|
.\"
|
|
.ad l
|
|
.nh
|
|
.SH NAME
|
|
QKeySequence \- Encapsulates a key sequence as used by accelerators
|
|
.SH SYNOPSIS
|
|
\fC#include <ntqkeysequence.h>\fR
|
|
.PP
|
|
Inherits Qt.
|
|
.PP
|
|
.SS "Public Members"
|
|
.in +1c
|
|
.ti -1c
|
|
.BI "\fBQKeySequence\fR ()"
|
|
.br
|
|
.ti -1c
|
|
.BI "\fBQKeySequence\fR ( const QString & key )"
|
|
.br
|
|
.ti -1c
|
|
.BI "\fBQKeySequence\fR ( int key )"
|
|
.br
|
|
.ti -1c
|
|
.BI "\fBQKeySequence\fR ( int k1, int k2, int k3 = 0, int k4 = 0 )"
|
|
.br
|
|
.ti -1c
|
|
.BI "\fBQKeySequence\fR ( const QKeySequence & keysequence )"
|
|
.br
|
|
.ti -1c
|
|
.BI "\fB~QKeySequence\fR ()"
|
|
.br
|
|
.ti -1c
|
|
.BI "uint \fBcount\fR () const"
|
|
.br
|
|
.ti -1c
|
|
.BI "bool \fBisEmpty\fR () const"
|
|
.br
|
|
.ti -1c
|
|
.BI "Qt::SequenceMatch \fBmatches\fR ( const QKeySequence & seq ) const"
|
|
.br
|
|
.ti -1c
|
|
.BI "\fBoperator QString\fR () const"
|
|
.br
|
|
.ti -1c
|
|
.BI "operator int () const \fI(obsolete)\fR"
|
|
.br
|
|
.ti -1c
|
|
.BI "int \fBoperator[]\fR ( uint index ) const"
|
|
.br
|
|
.ti -1c
|
|
.BI "QKeySequence & \fBoperator=\fR ( const QKeySequence & keysequence )"
|
|
.br
|
|
.ti -1c
|
|
.BI "bool \fBoperator==\fR ( const QKeySequence & keysequence ) const"
|
|
.br
|
|
.ti -1c
|
|
.BI "bool \fBoperator!=\fR ( const QKeySequence & keysequence ) const"
|
|
.br
|
|
.in -1c
|
|
.SH RELATED FUNCTION DOCUMENTATION
|
|
.in +1c
|
|
.ti -1c
|
|
.BI "QDataStream & \fBoperator<<\fR ( QDataStream & s, const QKeySequence & keysequence )"
|
|
.br
|
|
.ti -1c
|
|
.BI "QDataStream & \fBoperator>>\fR ( QDataStream & s, QKeySequence & keysequence )"
|
|
.br
|
|
.in -1c
|
|
.SH DESCRIPTION
|
|
The QKeySequence class encapsulates a key sequence as used by accelerators.
|
|
.PP
|
|
A key sequence consists of up to four keyboard codes, each optionally combined with modifiers, e.g. SHIFT, CTRL, ALT, META, or UNICODE_ACCEL. For example, \fCCTRL + Key_P\fR might be a sequence used as a shortcut for printing a document. The key codes are listed in ntqnamespace.h. As an alternative, use UNICODE_ACCEL with the unicode code point of the character. For example, \fCUNICODE_ACCEL + 'A'\fR gives the same key sequence as Key_A.
|
|
.PP
|
|
Key sequences can be constructed either from an integer key code, or from a human readable translatable string such as" Ctrl+X,Alt+Space". A key sequence can be cast to a QString to obtain a human readable translated version of the sequence. Translations are done in the "QAccel" context.
|
|
.PP
|
|
See also QAccel and Miscellaneous Classes.
|
|
.SH MEMBER FUNCTION DOCUMENTATION
|
|
.SH "QKeySequence::QKeySequence ()"
|
|
Constructs an empty key sequence.
|
|
.SH "QKeySequence::QKeySequence ( const QString & key )"
|
|
Creates a key sequence from the string \fIkey\fR. For example" Ctrl+O" gives CTRL+UNICODE_ACCEL+'O'. The strings "Ctrl"," Shift", "Alt" and "Meta" are recognized, as well as their translated equivalents in the "QAccel" context (using QObject::tr()).
|
|
.PP
|
|
Multiple key codes (up to four) may be entered by separating them with commas, e.g. "Alt+X,Ctrl+S,Q".
|
|
.PP
|
|
This contructor is typically used with tr(), so that accelerator keys can be replaced in translations:
|
|
.PP
|
|
.nf
|
|
.br
|
|
QPopupMenu *file = new QPopupMenu( this );
|
|
.br
|
|
file->insertItem( tr("&Open..."), this, SLOT(open()),
|
|
.br
|
|
QKeySequence( tr("Ctrl+O", "File|Open") ) );
|
|
.br
|
|
.fi
|
|
.PP
|
|
Note the \fC"File|Open"\fR translator comment. It is by no means necessary, but it provides some context for the human translator.
|
|
.SH "QKeySequence::QKeySequence ( int key )"
|
|
Constructs a key sequence that has a single \fIkey\fR.
|
|
.PP
|
|
The key codes are listed in ntqnamespace.h and can be combined with modifiers, e.g. with SHIFT, CTRL, ALT, META or UNICODE_ACCEL.
|
|
.SH "QKeySequence::QKeySequence ( int k1, int k2, int k3 = 0, int k4 = 0 )"
|
|
Constructs a key sequence with up to 4 keys \fIk1\fR, \fIk2\fR, \fIk3\fR and \fIk4\fR.
|
|
.PP
|
|
The key codes are listed in ntqnamespace.h and can be combined with modifiers, e.g. with SHIFT, CTRL, ALT, META or UNICODE_ACCEL.
|
|
.SH "QKeySequence::QKeySequence ( const QKeySequence & keysequence )"
|
|
Copy constructor. Makes a copy of \fIkeysequence\fR.
|
|
.SH "QKeySequence::~QKeySequence ()"
|
|
Destroys the key sequence.
|
|
.SH "uint QKeySequence::count () const"
|
|
Returns the number of keys in the key sequence. The maximum is 4.
|
|
.SH "bool QKeySequence::isEmpty () const"
|
|
Returns TRUE if the key sequence is empty; otherwise returns FALSE.
|
|
.SH "Qt::SequenceMatch QKeySequence::matches ( const QKeySequence & seq ) const"
|
|
Matches the sequence with \fIseq\fR. Returns Qt::Identical if successful, Qt::PartialMatch for matching but incomplete \fIseq\fR, and Qt::NoMatch if the sequences have nothing in common. Returns Qt::NoMatch if \fIseq\fR is shorter.
|
|
.SH "QKeySequence::operator QString () const"
|
|
Creates an accelerator string for the key sequence. For instance CTRL+Key_O gives "Ctrl+O". If the key sequence has multiple key codes they are returned comma-separated, e.g." Alt+X, Ctrl+Y, Z". The strings, "Ctrl", "Shift", etc. are translated (using QObject::tr()) in the "QAccel" scope. If the key sequence has no keys, QString::null is returned.
|
|
.PP
|
|
On Mac OS X, the string returned resembles the sequence that is shown in the menubar.
|
|
.SH "QKeySequence::operator int () const"
|
|
\fBThis function is obsolete.\fR It is provided to keep old source working. We strongly advise against using it in new code.
|
|
.PP
|
|
For backward compatibility: returns the first keycode as integer. If the key sequence is empty, 0 is returned.
|
|
.SH "bool QKeySequence::operator!= ( const QKeySequence & keysequence ) const"
|
|
Returns TRUE if \fIkeysequence\fR is not equal to this key sequence; otherwise returns FALSE.
|
|
.SH "QKeySequence & QKeySequence::operator= ( const QKeySequence & keysequence )"
|
|
Assignment operator. Assigns \fIkeysequence\fR to this object.
|
|
.SH "bool QKeySequence::operator== ( const QKeySequence & keysequence ) const"
|
|
Returns TRUE if \fIkeysequence\fR is equal to this key sequence; otherwise returns FALSE.
|
|
.SH "int QKeySequence::operator[] ( uint index ) const"
|
|
Returns a reference to the element at position \fIindex\fR in the key sequence. This can only be used to read an element.
|
|
.SH RELATED FUNCTION DOCUMENTATION
|
|
.SH "QDataStream & operator<< ( QDataStream & s, const QKeySequence & keysequence )"
|
|
Writes the key sequence \fIkeysequence\fR to the stream \fIs\fR.
|
|
.PP
|
|
See also Format of the QDataStream operators.
|
|
.SH "QDataStream & operator>> ( QDataStream & s, QKeySequence & keysequence )"
|
|
Reads a key sequence from the stream \fIs\fR into the key sequence \fIkeysequence\fR.
|
|
.PP
|
|
See also Format of the QDataStream operators.
|
|
|
|
.SH "SEE ALSO"
|
|
.BR http://doc.trolltech.com/ntqkeysequence.html
|
|
.BR http://www.trolltech.com/faq/tech.html
|
|
.SH COPYRIGHT
|
|
Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
|
|
license file included in the distribution for a complete license
|
|
statement.
|
|
.SH AUTHOR
|
|
Generated automatically from the source code.
|
|
.SH BUGS
|
|
If you find a bug in Qt, please report it as described in
|
|
.BR http://doc.trolltech.com/bughowto.html .
|
|
Good bug reports help us to help you. Thank you.
|
|
.P
|
|
The definitive Qt documentation is provided in HTML format; it is
|
|
located at $QTDIR/doc/html and can be read using Qt Assistant or with
|
|
a web browser. This man page is provided as a convenience for those
|
|
users who prefer man pages, although this format is not officially
|
|
supported by Trolltech.
|
|
.P
|
|
If you find errors in this manual page, please report them to
|
|
.BR qt-bugs@trolltech.com .
|
|
Please include the name of the manual page (qkeysequence.3qt) and the Qt
|
|
version (3.3.8).
|