Test conversion to TQt3 from Qt3 8c6fc1f8e35fd264dd01c582ca5e7549b32ab731

1 files changed, 169 insertions, 0 deletions

diff --git a/doc/man/man3/qkeysequence.3qt b/doc/man/man3/qkeysequence.3qt
new file mode 100644
index 000000000..e09b3cded
--- /dev/null
+++ b/doc/man/man3/qkeysequence.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 <qkeysequence.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 qnamespace.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 qnamespace.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 qnamespace.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/qkeysequence.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).