Referencia de la Clase QKeySequence

The QKeySequence class encapsulates a key sequence as used by accelerators. Más...

#include <qkeysequence.h>

Diagrama de herencias de QKeySequence

Lista de todos los miembros.

Métodos públicos
	QKeySequence ()
	QKeySequence (const QString &key)
	QKeySequence (int key)
	QKeySequence (int k1, int k2, int k3=0, int k4=0)
	QKeySequence (const QKeySequence &)
	~QKeySequence ()
uint	count () const
bool	isEmpty () const
Qt::SequenceMatch	matches (const QKeySequence &) const
	operator QString () const
	operator int () const
int	operator[] (uint) const
QKeySequence &	operator= (const QKeySequence &)
bool	operator== (const QKeySequence &) const
bool	operator!= (const QKeySequence &) const
	QKeySequence ()
	QKeySequence (const QString &key)
	QKeySequence (int key)
	QKeySequence (int k1, int k2, int k3=0, int k4=0)
	QKeySequence (const QKeySequence &)
	~QKeySequence ()
uint	count () const
bool	isEmpty () const
Qt::SequenceMatch	matches (const QKeySequence &) const
	operator QString () const
	operator int () const
int	operator[] (uint) const
QKeySequence &	operator= (const QKeySequence &)
bool	operator== (const QKeySequence &) const
bool	operator!= (const QKeySequence &) const
Amigas
class	QAccelManager
Q_EXPORT QDataStream &	operator<< (QDataStream &, const QKeySequence &)
Q_EXPORT QDataStream &	operator>> (QDataStream &, QKeySequence &)
Q_EXPORT QDataStream &	operator<< (QDataStream &, const QKeySequence &)
Q_EXPORT QDataStream &	operator>> (QDataStream &, QKeySequence &)

---

Descripción detallada

The QKeySequence class encapsulates a key sequence as used by accelerators.

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, {CTRL + Key_P} 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, {UNICODE_ACCEL + 'A'} gives the same key sequence as Key_A.

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.

Ver también:

QAccel

---

Documentación del constructor y destructor

QKeySequence::QKeySequence

(

)

Constructs an empty key sequence.

QKeySequence::QKeySequence

(

const QString &

key

)

Creates a key sequence from the string key. 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()).

Multiple key codes (up to four) may be entered by separating them with commas, e.g. "Alt+X,Ctrl+S,Q".

This contructor is typically used with tr (), so that accelerator keys can be replaced in translations:

        QPopupMenu *file = new QPopupMenu( this );
        file->insertItem( tr("&Open..."), this, SLOT(open()),
                          QKeySequence( tr("Ctrl+O", "File|Open") ) );

Note the "File|Open" translator comment. It is by no means necessary, but it provides some context for the human translator.

QKeySequence::QKeySequence

(

int

key

)

Constructs a key sequence that has a single key.

The key codes are listed in {qnamespace.h} and can be combined with modifiers, e.g. with SHIFT, CTRL, ALT, META or UNICODE_ACCEL.

QKeySequence::QKeySequence	(	int	k1,
		int	k2,
		int	k3 = 0,
		int	k4 = 0
	)

Constructs a key sequence with up to 4 keys k1, k2, k3 and k4.

The key codes are listed in {qnamespace.h} and can be combined with modifiers, e.g. with SHIFT, CTRL, ALT, META or UNICODE_ACCEL.

QKeySequence::QKeySequence

(

const QKeySequence &

keysequence

)

Copy constructor. Makes a copy of keysequence.

QKeySequence::~QKeySequence

(

)

Destroys the key sequence.

QKeySequence::QKeySequence

(

)

QKeySequence::QKeySequence

(

const QString &

key

)

QKeySequence::QKeySequence

(

int

key

)

QKeySequence::QKeySequence	(	int	k1,
		int	k2,
		int	k3 = 0,
		int	k4 = 0
	)

QKeySequence::QKeySequence

(

const QKeySequence &

)

QKeySequence::~QKeySequence

(

)

---

Documentación de las funciones miembro

uint QKeySequence::count

(

)

const

Returns the number of keys in the key sequence. The maximum is 4.

uint QKeySequence::count

(

)

const

bool QKeySequence::isEmpty

(

void

)

const

Returns TRUE if the key sequence is empty; otherwise returns FALSE.

bool QKeySequence::isEmpty

(

)

const

Qt::SequenceMatch QKeySequence::matches

(

const QKeySequence &

seq

)

const

Matches the sequence with seq. Returns Qt::Identical if successful, Qt::PartialMatch for matching but incomplete seq, and Qt::NoMatch if the sequences have nothing in common. Returns Qt::NoMatch if seq is shorter.

Qt::SequenceMatch QKeySequence::matches

(

const QKeySequence &

)

const

QKeySequence::operator int

(

)

const

For backward compatibility: returns the first keycode as integer. If the key sequence is empty, 0 is returned.

QKeySequence::operator int

(

)

const

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.

On Mac OS X, the string returned resembles the sequence that is shown in the menubar.

QKeySequence::operator QString

(

)

const

bool QKeySequence::operator!=

(

const QKeySequence &

keysequence

)

const

Returns TRUE if keysequence is not equal to this key sequence; otherwise returns FALSE.

bool QKeySequence::operator!=

(

const QKeySequence &

)

const

QKeySequence& QKeySequence::operator=

(

const QKeySequence &

)

QKeySequence & QKeySequence::operator=

(

const QKeySequence &

keysequence

)

Assignment operator. Assigns keysequence to this object.

bool QKeySequence::operator==

(

const QKeySequence &

)

const

bool QKeySequence::operator==

(

const QKeySequence &

keysequence

)

const

Returns TRUE if keysequence is equal to this key sequence; otherwise returns FALSE.

int QKeySequence::operator[]

(

uint

index

)

const

Returns a reference to the element at position index in the key sequence. This can only be used to read an element.

int QKeySequence::operator[]

(

uint

)

const

---

Documentación de las funciones relacionadas y clases amigas

QDataStream & operator<<	(	QDataStream &	s,
		const QKeySequence &	keysequence
	)		[friend]

Writes the key sequence keysequence to the stream s.

Ver también:

Format of the QDataStream operators

Q_EXPORT QDataStream& operator<<	(	QDataStream &	,
		const QKeySequence &
	)		[friend]

Q_EXPORT QDataStream& operator>>	(	QDataStream &	,
		QKeySequence &
	)		[friend]

QDataStream & operator>>	(	QDataStream &	s,
		QKeySequence &	keysequence
	)		[friend]

Reads a key sequence from the stream s into the key sequence keysequence.

Ver también:

Format of the QDataStream operators

QAccelManager [friend]

---

La documentación para esta clase fue generada a partir de los siguientes ficheros:

• src/qt/include/qkeysequence.h
• src/qt/src/kernel/qkeysequence.h
• src/qt/src/kernel/qkeysequence.cpp