diff options
Diffstat (limited to 'doc/man/man3/tqkeysequence.3qt')
-rw-r--r-- | doc/man/man3/tqkeysequence.3qt | 169 |
1 files changed, 169 insertions, 0 deletions
diff --git a/doc/man/man3/tqkeysequence.3qt b/doc/man/man3/tqkeysequence.3qt new file mode 100644 index 000000000..b93c22f65 --- /dev/null +++ b/doc/man/man3/tqkeysequence.3qt @@ -0,0 +1,169 @@ +'\" 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 (tqkeysequence.3qt) and the Qt +version (3.3.8). |