gr_Control.h

Go to the documentation of this file.

/* AbiSource Application Framework
 * Copyright (C) 2001 AbiSource, Inc.
 * Copyright (C) 2001 Dom Lachowicz <cinamod@hotmail.com>
 *
 * 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 GR_CONTROL_H
#define GR_CONTROL_H

#include "ut_types.h"
#include "ut_bytebuf.h"

class AV_View;
class XAP_Frame;
class GR_Graphics;

class ABI_EXPORT GR_Control
{

 public:

  virtual UT_Error isDrawable ( bool & drawable ) = 0;

  virtual UT_Error draw ( GR_Graphics * pGr,
              UT_uint32 x, UT_uint32 y ) = 0;

  virtual UT_Error isPersistable ( bool & persistable ) = 0;

  virtual UT_Error persist ( UT_ByteBuf * in ) = 0;

  virtual UT_Error _abi_callonce populate ( const UT_Byte * pBytes,
                        UT_uint32 dataLen ) = 0;

  virtual inline UT_Error _abi_callonce populate ( const UT_Bytebuf * pByteBuf )
    {
      return populate ( pByteBuf->getPointer(0), pByteBuf->getLength () );
    }

  virtual UT_Error getSize ( UT_uint32 &width, UT_uint32 &height ) = 0;

  virtual UT_Error resize ( UT_uint32 width, UT_uint32 height ) = 0;

 protected:

  GR_Control ( AV_View * pControllingView,
           XAP_Frame * pOwningFrame )
    : m_pView ( pControllingView ), m_pFrame ( pOwningFrame )
    {
    }

  virtual ~GR_Control ()
    {
    }

  inline AV_View * getControllingView () const
    {
      return m_pView;
    }

  inline XAP_Frame * getOwningFrame () const
    {
      return m_pFrame;
    }

 private:

  GR_Control ( const GR_Control & ); // no impl
  GR_Control & operator=( const GR_Control & ); // no impl

  AV_View   * m_pView;
  XAP_Frame * m_pFrame;
};

class ABI_EXPORT GR_ControlFactory
{

 public:

  static GR_ControlFactory * instance ();   // actually defined in platform-specific code

  virtual ~GR_ControlFactory ()
    {
    }

  // pure virtual functions that are implemented in platform-specific code

  virtual UT_Error newControlForMimeType ( AV_View * pControllingView,
                       XAP_Frame * pOwningFrame,
                       const char * pszMime,
                       GR_Control ** pCtlOut ) = 0;

  virtual UT_Error newControlForExtension ( AV_View * pControllingView,
                        XAP_Frame * pOwningFrame,
                        const char * pszExt,
                        GR_Control ** pCtlOut ) = 0;

  virtual UT_Error newControlForData ( AV_View * pControllingView,
                       XAP_Frame * pOwningFrame,
                       const UT_Byte * pData,
                       UT_uint32 dataLen,
                       GR_Control ** pCtlOut ) = 0;

  inline UT_Error newControlForData ( AV_View * pControllingView,
                      XAP_Frame * pOwningFrame,
                      const UT_Bytebuf * pData,
                      GR_Control ** pCtlOut )
    {
      return newControlForData ( pControllingView, pOwningFrame,
                 pData->getPointer(0), pData->getLength(),
                 pCtlOut );
    }

 protected:

  GR_ControlFactory ()
    {
    }

 private:

  void operator delete ( GR_ControlFactory * ); // no impl
  GR_ControlFactory ( const GR_ControlFactory & ); // no impl
  GR_ControlFactory & operator=( const GR_ControlFactory & ); // no impl
};

#endif // GR_CONTROL_H