llfocusmgr.h

Go to the documentation of this file.

// Singleton that manages keyboard and mouse focus

#ifndef LL_LLFOCUSMGR_H
#define LL_LLFOCUSMGR_H

#include "llstring.h"
#include "llframetimer.h"
#include "llview.h"

class LLUICtrl;
class LLMouseHandler;

class LLFocusMgr
{
public:
        LLFocusMgr();
        ~LLFocusMgr() { mFocusHistory.clear(); }

        // Mouse Captor
        void                    setMouseCapture(LLMouseHandler* new_captor);    // new_captor = NULL to release the mouse.
        LLMouseHandler* getMouseCapture() const { return mMouseCaptor; } 
        void                    removeMouseCaptureWithoutCallback( const LLMouseHandler* captor );
        BOOL                    childHasMouseCapture( const LLView* parent ) const;

        // Keyboard Focus
        void                    setKeyboardFocus(LLUICtrl* new_focus, BOOL lock = FALSE, BOOL keystrokes_only = FALSE);         // new_focus = NULL to release the focus.
        LLUICtrl*               getKeyboardFocus() const { return mKeyboardFocus; }  
        LLUICtrl*               getLastKeyboardFocus() const { return mLastKeyboardFocus; }  
        BOOL                    childHasKeyboardFocus( const LLView* parent ) const;
        void                    removeKeyboardFocusWithoutCallback( const LLView* focus );
        BOOL                    getKeystrokesOnly() { return mKeystrokesOnly; }
        void                    setKeystrokesOnly(BOOL keystrokes_only) { mKeystrokesOnly = keystrokes_only; }

        F32                             getFocusTime() const { return mFocusTimer.getElapsedTimeF32(); }
        F32                             getFocusFlashAmt() const;
        S32                             getFocusFlashWidth() const { return llround(lerp(1.f, 3.f, getFocusFlashAmt())); }
        LLColor4                getFocusColor() const;
        void                    triggerFocusFlash();
        BOOL                    getAppHasFocus() const { return mAppHasFocus; }
        void                    setAppHasFocus(BOOL focus);
        LLUICtrl*               getLastFocusForGroup(LLView* subtree_root) const;
        void                    clearLastFocusForGroup(LLView* subtree_root);

        // If setKeyboardFocus(NULL) is called, and there is a non-NULL default
        // keyboard focus view, focus goes there. JC
        void                    setDefaultKeyboardFocus(LLUICtrl* default_focus) { mDefaultKeyboardFocus = default_focus; }
        LLUICtrl*               getDefaultKeyboardFocus() const { return mDefaultKeyboardFocus; }

        
        // Top View
        void                    setTopCtrl(LLUICtrl* new_top);
        LLUICtrl*               getTopCtrl() const                                      { return mTopCtrl; }
        void                    removeTopCtrlWithoutCallback( const LLUICtrl* top_view );
        BOOL                    childIsTopCtrl( const LLView* parent ) const;

        // All Three
        void                    releaseFocusIfNeeded( const LLView* top_view );
        void                    lockFocus();
        void                    unlockFocus();
        BOOL                    focusLocked() const { return mLockedView != NULL; }

private:
        LLUICtrl*                       mLockedView;

        // Mouse Captor
        LLMouseHandler*         mMouseCaptor;                           // Mouse events are premptively routed to this object

        // Keyboard Focus
        LLUICtrl*                       mKeyboardFocus;                         // Keyboard events are preemptively routed to this object
        LLUICtrl*                       mLastKeyboardFocus;                     // who last had focus
        LLUICtrl*                       mDefaultKeyboardFocus;
        BOOL                            mKeystrokesOnly;

        // Top View
        LLUICtrl*                       mTopCtrl;

        LLFrameTimer            mFocusTimer;
        F32                                     mFocusWeight;

        BOOL                            mAppHasFocus;

        typedef std::map<LLHandle<LLView>, LLHandle<LLView> > focus_history_map_t;
        focus_history_map_t mFocusHistory;

        #ifdef _DEBUG
                LLString                mMouseCaptorName;
                LLString                mKeyboardFocusName;
                LLString                mTopCtrlName;
        #endif
};

extern LLFocusMgr gFocusMgr;

#endif  // LL_LLFOCUSMGR_H

---