handlebox.h

// -*- c++ -*-
//  Generated by gtkmmproc from ./../handlebox.gen_h -- DO NOT MODIFY!
#ifndef _GTKMM_HANDLEBOX_H
#define _GTKMM_HANDLEBOX_H

/* $Id: handlebox.h,v 1.2 2003/06/17 16:37:40 pbd Exp $ */

/* handlebox.h
 *
 * Copyright (C) 1998-1999 The Gtk-- Development Team
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the Free
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#include <gtk--/eventbox.h>
#include <gtk/gtkhandlebox.h>

namespace Gtk {
class HandleBox;
class HandleBox_Class;
}
namespace Gtk { Gtk::HandleBox *wrap (GtkHandleBox *o); }
namespace Gtk
{
//: A container which allows the user to reposition it's contents.
//- The {\class Gtk::HandleBox} widget allows a portion of a window
//- to be "torn off". It is a bin widget which displays its child and
//- a handle that the user can drag to tear off a separate window
//- (the float window) containing the child widget. A thin ghost is
//- drawn in the original location of the handlebox. By dragging the
//- separate window back to its original location, it can be reattached.
//-
//- When reattaching, the ghost and float window, must be aligned
//- along one of the edges, the snap edge. This either can be
//- specified by the application programmer explicitely, or GTK+ will
//- pick a reasonable default based on the handle position.
//-
//- To make detaching and reattaching the handlebox as minimally
//- confusing as possible to the user, it is important to set the
//- snap edge so that the snap edge does not move when the
//- handlebox is deattached. For instance, if the handlebox is
//- packed at the bottom of a VBox, then when the handlebox is
//- detached, the bottom edge of the handlebox's allocation will
//- remain fixed as the height of the handlebox shrinks, so the
//- snap edge should be set to {\enum GTK_POS_BOTTOM}.
class HandleBox : public Bin
{

public:
  typedef HandleBox          CppObjectType;
  typedef HandleBox_Class    CppClassType;
  typedef GtkHandleBox           BaseObjectType;
  typedef GtkHandleBoxClass      BaseClassType;

private:
  friend class HandleBox_Class;
  static CppClassType handle_box_class;

  HandleBox(const HandleBox&);
  HandleBox& operator=(const HandleBox&); // not implemented

protected:
  void   initialize_class();
  explicit HandleBox(GtkHandleBox *castitem);

public:
  static GtkType get_type();
  GtkHandleBox* gtkobj()             { return (GtkHandleBox*)(gtkobject); }
  const GtkHandleBox* gtkobj() const { return (GtkHandleBox*)(gtkobject); }
  static bool isA(Object *checkcast);

  // Hook for proxies
  static const char* const signal_names[];

  virtual ~HandleBox();

private:

public:


  HandleBox();

  //: Set how te widget looks.
  //- type can be one of: {\enum GTK_SHADOW_NONE}, {\enum GTK_SHADOW_IN}, {\enum GTK_SHADOW_OUT},
  //- {\enum GTK_SHADOW_ETCHED_IN}, {\enum GTK_SHADOW_ETCHED_OUT}.

  void set_shadow_type(GtkShadowType type);

  //: Set the handle's position.
  //- position can be one of: {\enum GTK_POS_LEFT}, {\enum GTK_POS_RIGHT}, {\enum GTK_POS_TOP},
  //- {\enum GTK_POS_BOTTOM}.

  void set_handle_position(GtkPositionType position);


  void set_snap_edge(GtkPositionType edge);


  GtkShadowType get_shadow_type() const;

  GtkPositionType get_handle_position() const;

  GtkPositionType get_snap_edge() const;

  bool is_child_detached()      const { return gtkobj()->child_detached; }
  bool is_float_window_mapped() const { return gtkobj()->float_window_mapped; }
  bool is_in_drag()             const { return gtkobj()->in_drag; }
  bool shrinks_on_detach()      const { return gtkobj()->shrink_on_detach; }

  Gdk_Window get_bin_window()   { return Gdk_Window(gtkobj()->bin_window); }
  Gdk_Window get_float_window() { return Gdk_Window(gtkobj()->float_window); }

public:

    class Proxy_child_attached
      : public ProxySignal1<void,GtkWidget*,CppObjectType,BaseObjectType,0>
      {
          typedef ProxySignal1<void,GtkWidget*,CppObjectType,BaseObjectType,0> BaseType;
        public:
          Connection connect(const SigC::Slot1<void,Gtk::Widget*> &s);
      };
    class Proxy_child_detached
      : public ProxySignal1<void,GtkWidget*,CppObjectType,BaseObjectType,1>
      {
          typedef ProxySignal1<void,GtkWidget*,CppObjectType,BaseObjectType,1> BaseType;
        public:
          Connection connect(const SigC::Slot1<void,Gtk::Widget*> &s);
      };
  union
    {
      CppObjectType * handle_box_self;
      Proxy_child_attached child_attached;
      Proxy_child_detached child_detached;
    };

protected:
  // impl functions
    virtual void child_attached_impl(Gtk::Widget* p0);
    virtual void child_detached_impl(Gtk::Widget* p0);

};

}


//+ PROPERTIES(Gtk_HandleBox)
//. name: bin_window
//. type: GdkWindow*
//. get:
//. set:
//. desc: parent window for children

//. name: float_window
//. type: GdkWindow*
//. get:
//. set:
//. desc:

//. name: shadow_type
//. type: GtkShadowType
//. get:
//. set:
//. desc:

//. name: handle_position
//. type: guint:2
//. get:
//. set:
//. desc:

//. name: float_window_mapped
//. type: guint:1
//. get:
//. set:
//. desc:

//. name: child_detached
//. type: guint:1
//. get:
//. set:
//. desc:

//. name: in_drag
//. type: guint:1
//. get:
//. set:
//. desc:

//. name: shrink_on_detach
//. type: guint:1
//. get:
//. set:
//. desc:

#endif