Q3AccelManager Class Reference

Collaboration diagram for Q3AccelManager:

[legend]List of all members.

---

Detailed Description

Definition at line 154 of file q3accel.cpp.

Public Member Functions
void	registerAccel (Q3AccelPrivate *a)
void	unregisterAccel (Q3AccelPrivate *a)
bool	tryAccelEvent (QWidget *w, QKeyEvent *e)
bool	dispatchAccelEvent (QWidget *w, QKeyEvent *e)
bool	tryComposeUnicode (QWidget *w, QKeyEvent *e)
Static Public Member Functions
static Q3AccelManager *	self ()
Private Member Functions
	Q3AccelManager ()
	~Q3AccelManager ()
void	setFuncPtr ()
bool	correctSubWindow (QWidget *w, Q3AccelPrivate *d)
QKeySequence::SequenceMatch	match (QKeyEvent *e, Q3AccelItem *item, QKeySequence &temp)
int	translateModifiers (ButtonState state)
Private Attributes
Q3PtrList< Q3AccelPrivate >	accels
QKeySequence::SequenceMatch	currentState
QKeySequence	intermediate
int	clash
bool	metaComposeUnicode
int	composedUnicode
Static Private Attributes
static Q3AccelManager *	self_ptr

---

Constructor & Destructor Documentation

Q3AccelManager::Q3AccelManager

(

)

[inline, private]

Definition at line 164 of file q3accel.cpp.

References self_ptr, and setFuncPtr().

        : currentState(QKeySequence::NoMatch), clash(-1), metaComposeUnicode(false),composedUnicode(0)
        { setFuncPtr(); self_ptr = this; }

Here is the call graph for this function:

Q3AccelManager::~Q3AccelManager

(

)

[inline, private]

Definition at line 167 of file q3accel.cpp.

References self_ptr.

{ self_ptr = 0; }

---

Member Function Documentation

static Q3AccelManager* Q3AccelManager::self

(

)

[inline, static]

Definition at line 156 of file q3accel.cpp.

References self_ptr.

Referenced by Q3AccelPrivate::Q3AccelPrivate(), qt_dispatchAccelEvent(), qt_tryAccelEvent(), qt_tryComposeUnicode(), and Q3AccelPrivate::~Q3AccelPrivate().

{ return self_ptr ? self_ptr : new Q3AccelManager; }

void Q3AccelManager::registerAccel

(

Q3AccelPrivate *

a

)

[inline]

Definition at line 157 of file q3accel.cpp.

References a, accels, and Q3PtrList< type >::append().

Referenced by Q3AccelPrivate::Q3AccelPrivate().

{ accels.append(a); }

Here is the call graph for this function:

void Q3AccelManager::unregisterAccel

(

Q3AccelPrivate *

a

)

[inline]

Definition at line 158 of file q3accel.cpp.

References a, accels, Q3PtrList< type >::isEmpty(), and Q3PtrList< type >::removeRef().

Referenced by Q3AccelPrivate::~Q3AccelPrivate().

{ accels.removeRef(a); if (accels.isEmpty()) delete this; }

Here is the call graph for this function:

bool Q3AccelManager::tryAccelEvent	(	QWidget *	w,
		QKeyEvent *	e
	)

Definition at line 320 of file q3accel.cpp.

References currentState, QEvent::ignore(), QEvent::isAccepted(), QKeySequence::NoMatch, QCoreApplication::sendSpontaneousEvent(), QEvent::t, and w.

Referenced by qt_tryAccelEvent().

{
    if (QKeySequence::NoMatch == currentState) {
        e->t = QEvent::AccelOverride;
        e->ignore();
        QApplication::sendSpontaneousEvent(w, e);
        if (e->isAccepted())
            return false;
    }
    e->t = QEvent::Accel;
    e->ignore();
    QApplication::sendSpontaneousEvent(w, e);
    return e->isAccepted();
}

Here is the call graph for this function:

bool Q3AccelManager::dispatchAccelEvent	(	QWidget *	w,
		QKeyEvent *	e
	)

Definition at line 390 of file q3accel.cpp.

References accels, QEvent::accept(), Q3AccelPrivate::activate(), Q3AccelPrivate::activateAmbiguously(), Q3AccelPrivate::aitems, clash, QStatusBar::clearMessage(), correctSubWindow(), QKeySequence::count(), currentState, Q3AccelPrivate::enabled, Q3AccelItem::enabled, QKeySequence::encodeString(), Q3PtrList< type >::first(), intermediate, QKeyEvent::key(), Qt::Key_Alt, Qt::Key_Shift, Q3PtrList< type >::last(), match(), message, n, Q3PtrList< type >::next(), QKeySequence::NoMatch, Q3AccelPrivate::parent, QKeySequence::PartialMatch, Q3PtrList< type >::prev(), QObject::receivers(), QStatusBar::showMessage(), Q3AccelItem::signal, SIGNAL, QKeyEvent::text(), translateModifiers(), and w.

Referenced by qt_dispatchAccelEvent().

{
#ifndef QT_NO_STATUSBAR
    // Needs to be declared and used here because of "goto doclash"
    QStatusBar* mainStatusBar = 0;
#endif

    // Modifiers can NOT be accelerators...
    if (e->key() >= Key_Shift &&
         e->key() <= Key_Alt)
         return false;

    QKeySequence::SequenceMatch result = QKeySequence::NoMatch;
    QKeySequence tocheck, partial;
    Q3AccelPrivate* accel = 0;
    Q3AccelItem* item = 0;
    Q3AccelPrivate* firstaccel = 0;
    Q3AccelItem* firstitem = 0;
    Q3AccelPrivate* lastaccel = 0;
    Q3AccelItem* lastitem = 0;

    QKeyEvent pe = *e;
    int n = -1;
    int hasShift = (e->state()&Qt::ShiftButton)?1:0;
    bool identicalDisabled = false;
    bool matchFound = false;
    do {
        accel = accels.first();
        matchFound = false;
        while (accel) {
            if (correctSubWindow(w, accel)) {
                if (accel->enabled) {
                    item = accel->aitems.last();
                    while(item) {
                        if (QKeySequence::Identical == (result = match(&pe, item, tocheck))) {
                            if (item->enabled) {
                                if (!firstaccel) {
                                    firstaccel = accel;
                                    firstitem = item;
                                }
                                lastaccel = accel;
                                lastitem = item;
                                n++;
                                matchFound = true;
                                if (n > QMAX(clash,0))
                                    goto doclash;
                            } else {
                                identicalDisabled = true;
                            }
                        }
                        if (item->enabled && QKeySequence::PartialMatch == result) {
                            partial = tocheck;
                            matchFound = true;
                        }
                        item = accel->aitems.prev();
                    }
                } else {
                    item = accel->aitems.last();
                    while(item) {
                        if (QKeySequence::Identical == match(&pe, item, tocheck))
                            identicalDisabled = true;
                        item = accel->aitems.prev();
                    }
                }
            }
            accel = accels.next();
        }
        pe = QKeyEvent(QEvent::Accel, pe.key(), pe.ascii(), pe.state()&~Qt::ShiftButton, pe.text());
    } while (hasShift-- && !matchFound && !identicalDisabled);

#ifndef QT_NO_STATUSBAR
    mainStatusBar = (QStatusBar*) w->window()->child(0, "QStatusBar");
#endif
    if (n < 0) { // no match found
        currentState = partial.count() ? QKeySequence::PartialMatch : QKeySequence::NoMatch;
#ifndef QT_NO_STATUSBAR
        // Only display message if we are, or were, in a partial match
        if (mainStatusBar && (QKeySequence::PartialMatch == currentState || intermediate.count())) {
            if (currentState == QKeySequence::PartialMatch) {
                mainStatusBar->showMessage((QString)partial + ", ...");
            } else if (!identicalDisabled) {
                QString message = Q3Accel::tr("%1, %2 not defined").
                    arg((QString)intermediate).
                    arg(QKeySequence::encodeString(e->key() | translateModifiers(e->state())));
                mainStatusBar->showMessage(message, 2000);
                // Since we're a NoMatch, reset the clash count
                clash = -1;
            } else {
              mainStatusBar->clearMessage();
            }
        }
#endif

        bool eatKey = (QKeySequence::PartialMatch == currentState || intermediate.count());
        intermediate = partial;
        if (eatKey)
            e->accept();
        return eatKey;
    } else if (n == 0) { // found exactly one match
        clash = -1; // reset
#ifndef QT_NO_STATUSBAR
        if (currentState == QKeySequence::PartialMatch && mainStatusBar)
                mainStatusBar->clearMessage();
#endif
        currentState = QKeySequence::NoMatch; // Free sequence keylock
        intermediate = QKeySequence();
        lastaccel->activate(lastitem);
        e->accept();
        return true;
    }

 doclash: // found more than one match
#ifndef QT_NO_STATUSBAR
    if (!mainStatusBar) // if "goto doclash", we need to get statusbar again.
        mainStatusBar = (QStatusBar*) w->window()->child(0, "QStatusBar");
#endif

    QString message = Q3Accel::tr("Ambiguous %1 not handled").arg((QString)tocheck);
    if (clash >= 0 && n > clash) { // pick next  match
        intermediate = QKeySequence();
        currentState = QKeySequence::NoMatch; // Free sequence keylock
        clash++;
#ifndef QT_NO_STATUSBAR
        if (mainStatusBar &&
             !lastitem->signal &&
             !(lastaccel->parent->receivers(SIGNAL(activatedAmbiguously(int)))))
            mainStatusBar->showMessage(message, 2000);
#endif
        lastaccel->activateAmbiguously(lastitem);
    } else { // start (or wrap) with the first matching
        intermediate = QKeySequence();
        currentState = QKeySequence::NoMatch; // Free sequence keylock
        clash = 0;
#ifndef QT_NO_STATUSBAR
        if (mainStatusBar &&
             !firstitem->signal &&
             !(firstaccel->parent->receivers(SIGNAL(activatedAmbiguously(int)))))
            mainStatusBar->showMessage(message, 2000);
#endif
        firstaccel->activateAmbiguously(firstitem);
    }
    e->accept();
    return true;
}

Here is the call graph for this function:

bool Q3AccelManager::tryComposeUnicode	(	QWidget *	w,
		QKeyEvent *	e
	)

Definition at line 335 of file q3accel.cpp.

References QEvent::accept(), QChar::cell(), composedUnicode, QKeyEvent::key(), Qt::Key_0, Qt::Key_Meta, QEvent::KeyPress, QEvent::KeyRelease, metaComposeUnicode, QChar::row(), s, QCoreApplication::sendEvent(), QEvent::type(), value, and w.

Referenced by qt_tryComposeUnicode().

{
    if (metaComposeUnicode) {
        int value = e->key() - Key_0;
        // Ignore acceloverrides so we don't trigger
        // accels on keypad when Meta compose is on
        if ((e->type() == QEvent::AccelOverride) &&
             (e->state() == Qt::Keypad + Qt::MetaButton)) {
            e->accept();
        // Meta compose start/continue
        } else if ((e->type() == QEvent::KeyPress) &&
             (e->state() == Qt::Keypad + Qt::MetaButton)) {
            if (value >= 0 && value <= 9) {
                composedUnicode *= 10;
                composedUnicode += value;
                return true;
            } else {
                // Composing interrupted, dispatch!
                if (composedUnicode) {
                    QChar ch(composedUnicode);
                    QString s(ch);
                    QKeyEvent kep(QEvent::KeyPress, 0, ch.row() ? 0 : ch.cell(), 0, s);
                    QKeyEvent ker(QEvent::KeyRelease, 0, ch.row() ? 0 : ch.cell(), 0, s);
                    QApplication::sendEvent(w, &kep);
                    QApplication::sendEvent(w, &ker);
                }
                composedUnicode = 0;
                return true;
            }
        // Meta compose end, dispatch
        } else if ((e->type() == QEvent::KeyRelease) &&
                    (e->key() == Key_Meta) &&
                    (composedUnicode != 0)) {
            if ((composedUnicode > 0) &&
                 (composedUnicode < 0xFFFE)) {
                QChar ch(composedUnicode);
                QString s(ch);
                QKeyEvent kep(QEvent::KeyPress, 0, ch.row() ? 0 : ch.cell(), 0, s);
                QKeyEvent ker(QEvent::KeyRelease, 0, ch.row() ? 0 : ch.cell(), 0, s);
                QApplication::sendEvent(w, &kep);
                QApplication::sendEvent(w, &ker);
            }
            composedUnicode = 0;
            return true;
        }
    }
    return false;
}

Here is the call graph for this function:

void Q3AccelManager::setFuncPtr

(

)

[private]

Definition at line 196 of file q3accel.cpp.

References data, qApp, qt_dispatchAccelEvent(), qt_tryAccelEvent(), and qt_tryComposeUnicode().

Referenced by Q3AccelManager().

                                {
    if (qApp->d_func()->qt_compat_used)
        return;
    QApplicationPrivate *data = static_cast<QApplicationPrivate*>(qApp->d_ptr);
    data->qt_tryAccelEvent = qt_tryAccelEvent;
    data->qt_tryComposeUnicode = qt_tryComposeUnicode;
    data->qt_dispatchAccelEvent = qt_dispatchAccelEvent;
    data->qt_compat_used = true;
}

Here is the call graph for this function:

bool Q3AccelManager::correctSubWindow	(	QWidget *	w,
		Q3AccelPrivate *	d
	)			[private]

Definition at line 217 of file q3accel.cpp.

References d, Qt::Dialog, QWidget::parentWidget(), Qt::SubWindow, w, QWidget::window(), and QWidget::windowType().

Referenced by dispatchAccelEvent().

                                                                   {
#if !defined (Q_OS_MACX)
     if (!d->watch || !d->watch->isVisible() || !d->watch->isEnabled())
#else
    if (!d->watch || (!d->watch->isVisible() && !d->watch->inherits("QMenuBar")) || !d->watch->isEnabled())
#endif
        return false;
    QWidget* tlw = w->window();
    QWidget* wtlw = d->watch->window();

    /* if we live in a floating dock window, keep our parent's
     * accelerators working */
#ifndef QT_NO_MAINWINDOW
    if ((tlw->windowType() == Qt::Dialog) && tlw->parentWidget() && ::qobject_cast<QDockWidget*>(tlw))
        return tlw->parentWidget()->window() == wtlw;

    if (wtlw  != tlw)
        return false;
#endif
    /* if we live in a MDI subwindow, ignore the event if we are
       not the active document window */
    QWidget* sw = d->watch;
    while (sw && sw->windowType() != Qt::SubWindow)
        sw = sw->parentWidget(true);
    if (sw)  { // we are in a subwindow indeed
        QWidget* fw = w;
        while (fw && fw != sw)
            fw = fw->parentWidget(true);
        if (fw != sw) // focus widget not in our subwindow
            return false;
    }
    return true;
}

Here is the call graph for this function:

QKeySequence::SequenceMatch Q3AccelManager::match	(	QKeyEvent *	e,
		Q3AccelItem *	item,
		QKeySequence &	temp
	)			[private]

Definition at line 272 of file q3accel.cpp.

References QKeySequence::count(), index, intermediate, QString::isEmpty(), QKeyEvent::key(), key, Q3AccelItem::key, Qt::Key_Tab, Qt::Key_unknown, QKeySequence::matches(), Qt::MODIFIER_MASK, QKeySequence::NoMatch, QKeySequence::setKey(), Qt::SHIFT, QKeyEvent::text(), translateModifiers(), QString::unicode(), and Qt::UNICODE_ACCEL.

Referenced by dispatchAccelEvent().

{
    QKeySequence::SequenceMatch result = QKeySequence::NoMatch;
    int index = intermediate.count();
    temp = intermediate;

    int modifier = translateModifiers(e->state());

    if (e->key() && e->key() != Key_unknown) {
        int key = e->key()  | modifier;
        if (e->key() == Key_BackTab) {
            /*
            In QApplication, we map shift+tab to shift+backtab.
            This code here reverts the mapping in a way that keeps
            backtab and shift+tab accelerators working, in that
            order, meaning backtab has priority.*/
            key &= ~SHIFT;

            temp.setKey(key, index);
            if (QKeySequence::NoMatch != (result = temp.matches(item->key)))
                return result;
            if (e->state() & ShiftButton)
                key |= SHIFT;
            key = Key_Tab | (key & MODIFIER_MASK);
            temp.setKey(key, index);
            if (QKeySequence::NoMatch != (result = temp.matches(item->key)))
                return result;
        } else {
            temp.setKey(key, index);
            if (QKeySequence::NoMatch != (result = temp.matches(item->key)))
                return result;
        }

        if (key == Key_BackTab) {
            if (e->state() & ShiftButton)
                key |= SHIFT;
            temp.setKey(key, index);
            if (QKeySequence::NoMatch != (result = temp.matches(item->key)))
                return result;
        }
    }
    if (!e->text().isEmpty()) {
        temp.setKey((int)e->text()[0].unicode() | UNICODE_ACCEL | modifier, index);
        result = temp.matches(item->key);
    }
    return result;
}

Here is the call graph for this function:

int Q3AccelManager::translateModifiers

(

ButtonState

state

)

[inline, private]

Definition at line 251 of file q3accel.cpp.

References Qt::ALT, Qt::CTRL, Qt::META, and Qt::SHIFT.

Referenced by dispatchAccelEvent(), and match().

{
    int result = 0;
    if (state & ShiftButton)
        result |= SHIFT;
    if (state & ControlButton)
        result |= CTRL;
    if (state & MetaButton)
        result |= META;
    if (state & AltButton)
        result |= ALT;
    return result;
}

---

Member Data Documentation

Q3PtrList<Q3AccelPrivate> Q3AccelManager::accels [private]

Definition at line 174 of file q3accel.cpp.

Referenced by dispatchAccelEvent(), registerAccel(), and unregisterAccel().

Q3AccelManager * Q3AccelManager::self_ptr [static, private]

Definition at line 175 of file q3accel.cpp.

Referenced by Q3AccelManager(), self(), and ~Q3AccelManager().

QKeySequence::SequenceMatch Q3AccelManager::currentState [private]

Definition at line 176 of file q3accel.cpp.

Referenced by dispatchAccelEvent(), and tryAccelEvent().

QKeySequence Q3AccelManager::intermediate [private]

Definition at line 177 of file q3accel.cpp.

Referenced by dispatchAccelEvent(), and match().

int Q3AccelManager::clash [private]

Definition at line 178 of file q3accel.cpp.

Referenced by dispatchAccelEvent().

bool Q3AccelManager::metaComposeUnicode [private]

Definition at line 179 of file q3accel.cpp.

Referenced by tryComposeUnicode().

int Q3AccelManager::composedUnicode [private]

Definition at line 180 of file q3accel.cpp.

Referenced by tryComposeUnicode().

---

The documentation for this class was generated from the following file:

• src/qt3support/other/q3accel.cpp

---