xav_Listener.h

Go to the documentation of this file.

/* AbiSource Application Framework
 * Copyright (C) 1998-2000 AbiSource, Inc.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301 USA.
 */


#ifndef AV_LISTENER_H
#define AV_LISTENER_H

/* pre-emptive dismissal; ut_types.h is needed by just about everything,
 * so even if it's commented out in-file that's still a lot of work for
 * the preprocessor to do...
 */
#ifndef UT_TYPES_H
#include "ut_types.h"
#endif

class AV_View;

typedef UT_uint32 AV_ListenerId;


typedef enum _AV_ListenerType
{
    AV_LISTENER_MENU,
    AV_LISTENER_TOOLBAR,
    AV_LISTENER_LEFTRULER,
    AV_LISTENER_TOPRULER,
    AV_LISTENER_SCROLLBAR,
    AV_LISTENER_VIEW,
    AV_LISTENER_STATUSBAR,
    AV_LISTENER_CARET,
    AV_LISTENER_PLUGIN,
    AV_LISTENER_PLUGIN_EXTRA

} AV_ListenerType;

// TODO how did we fill this mask so fast?
// TODO next it'll need to become a 32-bit mask. YEP done! MES 2/10/2004
typedef UT_uint32 AV_ChangeMask;
#define AV_CHG_NONE         (static_cast<AV_ChangeMask>(0x0000))
#define AV_CHG_DO           (static_cast<AV_ChangeMask>(0x0001))        // canDo
#define AV_CHG_DIRTY        (static_cast<AV_ChangeMask>(0x0002))        // isDirty
#define AV_CHG_EMPTYSEL     (static_cast<AV_ChangeMask>(0x0004))        // isSelectionEmpty
#define AV_CHG_FILENAME     (static_cast<AV_ChangeMask>(0x0008))        // getFilename
#define AV_CHG_FMTBLOCK     (static_cast<AV_ChangeMask>(0x0010))        // getBlockFormat
#define AV_CHG_FMTCHAR      (static_cast<AV_ChangeMask>(0x0020))        // getCharFormat
#define AV_CHG_CLIPBOARD    (static_cast<AV_ChangeMask>(0x0040))
#define AV_CHG_PAGECOUNT    (static_cast<AV_ChangeMask>(0x0080))        // number of pages
#define AV_CHG_WINDOWSIZE   (static_cast<AV_ChangeMask>(0x0100))
#define AV_CHG_FMTSECTION   (static_cast<AV_ChangeMask>(0x0200))
#define AV_CHG_COLUMN       (static_cast<AV_ChangeMask>(0x0400))
#define AV_CHG_INPUTMODE    (static_cast<AV_ChangeMask>(0x0800))
#define AV_CHG_FMTSTYLE     (static_cast<AV_ChangeMask>(0x1000))        // getStyle
#define AV_CHG_INSERTMODE   (static_cast<AV_ChangeMask>(0x2000))
#define AV_CHG_HDRFTR       (static_cast<AV_ChangeMask>(0x4000))
#define AV_CHG_DIRECTIONMODE (static_cast<AV_ChangeMask>(0x4000))
#define AV_CHG_FRAMEDATA    (static_cast<AV_ChangeMask>(0x8000))        // frame-level preferences (pFrameData)
#define AV_CHG_KEYPRESSED   (static_cast<AV_ChangeMask>(0x10000))       // A key was pressed
#define AV_CHG_BLOCKCHECK   (static_cast<AV_ChangeMask>(0x20000))       // Checking a block in background
#define AV_CHG_FOCUS        (static_cast<AV_ChangeMask>(0x40000))       // Change of focus
#define AV_CHG_MOUSEPOS     (static_cast<AV_ChangeMask>(0x80000))       // Change of mouse position
#define AV_CHG_CELL         (static_cast<AV_ChangeMask>(0x100000))      // Change of active cell/caret moved out of table
#define AV_CHG_ALL          (static_cast<AV_ChangeMask>(0xFFFFFFFF))

#define AV_CHG_SAVE         (static_cast<AV_ChangeMask>(AV_CHG_DO | AV_CHG_DIRTY | AV_CHG_FILENAME))
#define AV_CHG_TYPING       (static_cast<AV_ChangeMask>(AV_CHG_DO | AV_CHG_DIRTY | AV_CHG_EMPTYSEL | AV_CHG_COLUMN))
#define AV_CHG_MOTION       (static_cast<AV_ChangeMask>(AV_CHG_EMPTYSEL | AV_CHG_FMTSTYLE | AV_CHG_FMTBLOCK | AV_CHG_FMTSECTION | AV_CHG_FMTCHAR | AV_CHG_COLUMN | AV_CHG_CELL))
#define AV_CHG_STYLE_PARA   (static_cast<AV_ChangeMask>(AV_CHG_FMTBLOCK | AV_CHG_FMTCHAR))
/*
    Various UI elements (title, toolbar, etc.) need to stay in sync with
    the current state of an AV_View.  They can do so by registering
    an AV_Listener with the AV_View in order to be notified of the existence
    of certain changes to the document as they occur.

    Note that these notifications do *not* pass any document state, they
    simply note the existence of a certain category of changes to that state.

    The view will notify each registered listener (in an undefined order).
    When the listener registers, it is provided an ID which may be used
    later to refer to it.
*/

class ABI_EXPORT AV_Listener
{
public:
    virtual ~AV_Listener() {}

    virtual bool        notify(AV_View * pView, const AV_ChangeMask mask) = 0;
    virtual AV_ListenerType    getType(void) = 0;
};


class ABI_EXPORT AV_ListenerExtra : public AV_Listener
{
public:
    virtual bool        notify(AV_View * pView, const AV_ChangeMask mask, void * pPrivateData =NULL) = 0;
    virtual AV_ListenerType    getType(void) = 0;
};

#endif /* AV_LISTENER_H */