UI/UI_HotkeyHelper.h

Go to the documentation of this file.

/*
 * PROPRIETARY INFORMATION.  This software is proprietary to
 * Side Effects Software Inc., and is not to be reproduced,
 * transmitted, or disclosed in any way without written permission.
 *
 * Produced by:
 *      Edward Lam
 *      Side Effects Software Inc
 *      123 Front Street West, Suite 1401
 *      Toronto, Ontario
 *      Canada   M5J 2M2
 *      416-504-9876
 *
 * NAME:        UI_HotkeyHelper.h (UI Library, C++)
 *
 * COMMENTS:    Helper class for hotkey handling
 */

#ifndef __UI_HOTKEYHELPER_H__
#define __UI_HOTKEYHELPER_H__

#include "UI_API.h"
#include <UT/UT_PtrProxy.h>
#include <UT/UT_SymbolTable.h>
#include "UI_Object.h"

class UI_Event;

/// Hotkey handler method. Returns true if successfully consumed.
typedef bool (UI_Object::*UI_HotkeyMethod)(UI_Event *);


/// The UI_HotkeyHelper class allows one to maintain a table of hotkeys and
/// their associated handler functions (of type UI_HotkeyMethod) so that we
/// can easily perform functions like dispatching hotkey handlers as well as
/// testing to see if a hotkey is going to be handled without invoking the
/// handler.
class UI_API UI_HotkeyHelper
{
public:
    struct Entry
    {
        const char *    mySymbol;
        UI_HotkeyMethod myMethod;
    };

    /// Default constructor
            UI_HotkeyHelper(UI_Object *client);
    /// Construct using an array of hotkey entries terminated by NULL mySymbol.
            UI_HotkeyHelper(UI_Object *client, const Entry *hotkey_entries);
    /// Destructor
    virtual ~UI_HotkeyHelper();
    
    /// Adds an array of hotkey entries terminated by NULL mySymbol.
    void    addHotkeys(const Entry *hotkey_entries);
    /// Add a single hotkey entry
    void    addHotkey(const Entry &entry);
    /// Remove a hotkey entry
    void    removeHotkey(const char *symbol);

    /// Invoke the handler for the given UI hotkey event.
    /// Returns true if consumed, false otherwise.
    bool    processHotkey(UI_Event *event);

    /// Will we handle the given UI hotkey symbol?
    bool    willProcessHotkey(UI_Event *event);

private: // methods

    UI_HotkeyHelper(const UI_HotkeyHelper &copy);               // not yet done
    UI_HotkeyHelper & operator=(const UI_HotkeyHelper &copy);   // not yet done

private: // data

    UT_RefProxy<UI_Object>  myClient;
    UT_SymbolTable          myTable;

};

#endif // __UI_HOTKEYHELPER_H__

---