2001-09-19 04:04:57 +02:00
|
|
|
// Object.cs - GObject class wrapper implementation
|
|
|
|
//
|
2003-07-23 19:19:21 +02:00
|
|
|
// Authors: Mike Kestner <mkestner@speakeasy.net>
|
2001-09-19 04:04:57 +02:00
|
|
|
//
|
2003-07-23 19:19:21 +02:00
|
|
|
// (c) 2001-2003 Mike Kestner
|
2003-03-15 21:49:37 +01:00
|
|
|
//
|
|
|
|
// TODO:
|
|
|
|
// Could remove `disposed' for a check if an object is on the dispose_queue_list.
|
|
|
|
//
|
2001-09-19 13:37:15 +02:00
|
|
|
namespace GLib {
|
2001-09-19 04:04:57 +02:00
|
|
|
|
|
|
|
using System;
|
2001-09-20 06:03:27 +02:00
|
|
|
using System.Collections;
|
2001-09-19 13:37:15 +02:00
|
|
|
using System.ComponentModel;
|
2002-12-25 01:36:00 +01:00
|
|
|
using System.Reflection;
|
2001-09-19 04:04:57 +02:00
|
|
|
using System.Runtime.InteropServices;
|
|
|
|
|
2001-09-27 20:39:53 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Object Class
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Wrapper class for GObject.
|
|
|
|
/// </remarks>
|
|
|
|
|
2002-09-04 07:25:58 +02:00
|
|
|
public class Object : IWrapper, IDisposable {
|
2001-09-27 20:39:53 +02:00
|
|
|
|
|
|
|
// Private class and instance members
|
|
|
|
IntPtr _obj;
|
|
|
|
EventHandlerList _events;
|
2002-09-04 07:25:58 +02:00
|
|
|
bool disposed = false;
|
2003-07-04 09:13:19 +02:00
|
|
|
Hashtable data;
|
2001-09-27 20:39:53 +02:00
|
|
|
static Hashtable Objects = new Hashtable();
|
2003-03-15 21:49:37 +01:00
|
|
|
static Queue PendingDestroys = new Queue ();
|
|
|
|
static bool idle_queued;
|
2001-09-27 20:39:53 +02:00
|
|
|
|
2003-03-15 21:49:37 +01:00
|
|
|
//
|
|
|
|
// The destructor is invoked by a thread
|
|
|
|
//
|
2002-09-04 07:25:58 +02:00
|
|
|
~Object ()
|
|
|
|
{
|
|
|
|
Dispose ();
|
|
|
|
}
|
|
|
|
|
2003-07-23 19:19:21 +02:00
|
|
|
[DllImport("libgobject-2.0-0.dll")]
|
|
|
|
static extern void g_object_unref (IntPtr raw);
|
|
|
|
|
2003-03-15 21:49:37 +01:00
|
|
|
static bool PerformQueuedUnrefs ()
|
|
|
|
{
|
|
|
|
Object [] objects;
|
|
|
|
|
|
|
|
lock (PendingDestroys){
|
|
|
|
objects = new Object [PendingDestroys.Count];
|
|
|
|
PendingDestroys.CopyTo (objects, 0);
|
|
|
|
PendingDestroys.Clear ();
|
|
|
|
}
|
|
|
|
lock (typeof (Object))
|
|
|
|
idle_queued = false;
|
|
|
|
|
|
|
|
foreach (Object o in objects){
|
|
|
|
if (o._obj == IntPtr.Zero)
|
|
|
|
continue;
|
2003-12-03 21:23:25 +01:00
|
|
|
|
2003-07-23 19:19:21 +02:00
|
|
|
g_object_unref (o._obj);
|
2003-03-15 21:49:37 +01:00
|
|
|
o._obj = IntPtr.Zero;
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
|
2002-09-04 07:25:58 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Dispose Method
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Disposes of the raw object. Only override this if
|
|
|
|
/// the Raw object should not be unref'd when the object
|
|
|
|
/// is garbage collected.
|
|
|
|
/// </remarks>
|
|
|
|
|
|
|
|
public void Dispose ()
|
|
|
|
{
|
|
|
|
if (disposed)
|
|
|
|
return;
|
|
|
|
|
|
|
|
disposed = true;
|
2003-03-23 19:05:36 +01:00
|
|
|
Objects.Remove (_obj);
|
2003-03-15 21:49:37 +01:00
|
|
|
lock (PendingDestroys){
|
|
|
|
PendingDestroys.Enqueue (this);
|
|
|
|
lock (typeof (Object)){
|
|
|
|
if (!idle_queued){
|
|
|
|
Idle.Add (new IdleHandler (PerformQueuedUnrefs));
|
|
|
|
idle_queued = true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
GC.SuppressFinalize (this);
|
2002-09-04 07:25:58 +02:00
|
|
|
}
|
|
|
|
|
2003-02-22 05:34:56 +01:00
|
|
|
[DllImport("libgobject-2.0-0.dll")]
|
2002-09-12 07:21:16 +02:00
|
|
|
static extern void g_object_ref (IntPtr raw);
|
|
|
|
|
2001-09-27 20:39:53 +02:00
|
|
|
/// <summary>
|
|
|
|
/// GetObject Shared Method
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Used to obtain a CLI typed object associated with a
|
|
|
|
/// given raw object pointer. This method is primarily
|
|
|
|
/// used to wrap object references that are returned
|
|
|
|
/// by either the signal system or raw class methods that
|
|
|
|
/// return GObject references.
|
|
|
|
/// </remarks>
|
|
|
|
///
|
|
|
|
/// <returns>
|
|
|
|
/// The wrapper instance.
|
|
|
|
/// </returns>
|
|
|
|
|
2003-07-23 19:19:21 +02:00
|
|
|
public static Object GetObject(IntPtr o, bool owned_ref)
|
2001-09-19 06:47:48 +02:00
|
|
|
{
|
2003-07-23 19:19:21 +02:00
|
|
|
Object obj;
|
|
|
|
WeakReference weak_ref = Objects[o] as WeakReference;
|
|
|
|
if (weak_ref != null && weak_ref.IsAlive) {
|
|
|
|
obj = weak_ref.Target as GLib.Object;
|
|
|
|
if (owned_ref)
|
|
|
|
g_object_unref (obj._obj);
|
|
|
|
return obj;
|
2003-04-09 19:50:51 +02:00
|
|
|
}
|
|
|
|
|
2003-07-23 19:19:21 +02:00
|
|
|
obj = GtkSharp.ObjectManager.CreateObject(o);
|
|
|
|
if (obj == null)
|
|
|
|
return null;
|
|
|
|
|
|
|
|
if (!owned_ref)
|
|
|
|
g_object_ref (obj.Handle);
|
|
|
|
Objects [o] = new WeakReference (obj);
|
|
|
|
return obj;
|
2001-09-19 04:04:57 +02:00
|
|
|
}
|
2001-09-20 06:03:27 +02:00
|
|
|
|
2002-12-25 01:36:00 +01:00
|
|
|
[DllImport("gtksharpglue")]
|
|
|
|
static extern uint gtksharp_register_type (string name, uint parent_type);
|
|
|
|
|
2003-07-23 19:19:21 +02:00
|
|
|
/// <summary>
|
|
|
|
/// RegisterGType Shared Method
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Shared method to register types with the GType system.
|
|
|
|
/// This method should be called from the class constructor
|
|
|
|
/// of subclasses.
|
|
|
|
/// </remarks>
|
|
|
|
|
2003-02-24 07:39:30 +01:00
|
|
|
public static GLib.Type RegisterGType (System.Type t)
|
2002-12-25 01:36:00 +01:00
|
|
|
{
|
2003-02-24 07:39:30 +01:00
|
|
|
System.Type parent = t.BaseType;
|
2002-12-25 01:36:00 +01:00
|
|
|
PropertyInfo pi = parent.GetProperty ("GType", BindingFlags.DeclaredOnly | BindingFlags.Static | BindingFlags.Public);
|
|
|
|
if (pi == null) {
|
|
|
|
Console.WriteLine ("null PropertyInfo");
|
2003-02-24 07:39:30 +01:00
|
|
|
return null;
|
2002-12-25 01:36:00 +01:00
|
|
|
}
|
|
|
|
uint parent_gtype = (uint) pi.GetValue (null, null);
|
2003-03-11 09:33:24 +01:00
|
|
|
string name = t.Namespace.Replace(".", "_") + t.Name;
|
2002-12-25 01:36:00 +01:00
|
|
|
GtkSharp.ObjectManager.RegisterType (name, t.Namespace + t.Name, t.Assembly.GetName().Name);
|
2003-02-24 07:39:30 +01:00
|
|
|
return new GLib.Type (gtksharp_register_type (name, parent_gtype));
|
2002-12-25 01:36:00 +01:00
|
|
|
}
|
|
|
|
|
2002-02-03 04:44:10 +01:00
|
|
|
/// <summary>
|
|
|
|
/// Object Constructor
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Dummy constructor needed for derived classes.
|
|
|
|
/// </remarks>
|
|
|
|
|
2003-07-23 19:19:21 +02:00
|
|
|
protected Object () {}
|
2002-02-03 04:44:10 +01:00
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
/// Object Constructor
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Creates an object from a raw object reference.
|
|
|
|
/// </remarks>
|
|
|
|
|
|
|
|
public Object (IntPtr raw)
|
|
|
|
{
|
2002-02-19 20:46:44 +01:00
|
|
|
Raw = raw;
|
2002-02-03 04:44:10 +01:00
|
|
|
}
|
2001-09-19 04:04:57 +02:00
|
|
|
|
2003-02-22 05:34:56 +01:00
|
|
|
[DllImport("libgobject-2.0-0.dll")]
|
2002-12-25 01:36:00 +01:00
|
|
|
static extern IntPtr g_object_new (uint gtype, IntPtr dummy);
|
|
|
|
|
2003-07-23 19:19:21 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Object Constructor
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Creates an object from a specified GType.
|
|
|
|
/// </remarks>
|
|
|
|
|
|
|
|
protected Object (GLib.Type gtype)
|
2002-12-25 01:36:00 +01:00
|
|
|
{
|
2003-02-24 07:39:30 +01:00
|
|
|
Raw = g_object_new (gtype.Value, IntPtr.Zero);
|
2002-12-25 01:36:00 +01:00
|
|
|
}
|
|
|
|
|
2001-09-27 20:39:53 +02:00
|
|
|
/// <summary>
|
2002-02-19 20:46:44 +01:00
|
|
|
/// Raw Property
|
2001-09-27 20:39:53 +02:00
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// The raw GObject reference associated with this wrapper.
|
2001-10-07 02:41:52 +02:00
|
|
|
/// Only subclasses of Object can access this read/write
|
|
|
|
/// property. For public read-only access, use the
|
|
|
|
/// Handle property.
|
2001-09-27 20:39:53 +02:00
|
|
|
/// </remarks>
|
|
|
|
|
2002-11-10 11:09:05 +01:00
|
|
|
protected virtual IntPtr Raw {
|
2001-09-19 13:37:15 +02:00
|
|
|
get {
|
2001-09-19 04:04:57 +02:00
|
|
|
return _obj;
|
|
|
|
}
|
2001-09-19 13:37:15 +02:00
|
|
|
set {
|
2002-10-26 10:37:48 +02:00
|
|
|
Objects [value] = new WeakReference (this);
|
2001-09-19 04:04:57 +02:00
|
|
|
_obj = value;
|
|
|
|
}
|
2002-11-10 11:09:05 +01:00
|
|
|
}
|
2001-09-19 04:04:57 +02:00
|
|
|
|
2002-08-09 05:56:27 +02:00
|
|
|
/// <summary>
|
|
|
|
/// GType Property
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// The type associated with this object class.
|
|
|
|
/// </remarks>
|
|
|
|
|
2002-12-25 01:36:00 +01:00
|
|
|
[DllImport("gtksharpglue")]
|
2002-11-10 11:09:05 +01:00
|
|
|
private static extern uint gtksharp_get_type_id (IntPtr obj);
|
|
|
|
|
2002-11-18 19:55:39 +01:00
|
|
|
public static uint GType {
|
2002-08-09 05:56:27 +02:00
|
|
|
get {
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2003-12-03 21:23:25 +01:00
|
|
|
[DllImport("gtksharpglue")]
|
|
|
|
static extern IntPtr gtksharp_get_type_name (IntPtr raw);
|
|
|
|
|
|
|
|
public string TypeName {
|
|
|
|
get {
|
|
|
|
return Marshal.PtrToStringAnsi (gtksharp_get_type_name (Raw));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2002-11-18 19:55:39 +01:00
|
|
|
/// <summary>
|
|
|
|
/// GetGType Method
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Returns the GType of this object.
|
|
|
|
/// </remarks>
|
|
|
|
|
|
|
|
public uint GetGType () {
|
|
|
|
if (_obj == IntPtr.Zero)
|
|
|
|
return (uint) TypeFundamentals.TypeInvalid;
|
|
|
|
else
|
|
|
|
return gtksharp_get_type_id (_obj);
|
|
|
|
}
|
|
|
|
|
2001-10-07 02:41:52 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Handle Property
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// The raw GObject reference associated with this object.
|
2002-02-19 20:46:44 +01:00
|
|
|
/// Subclasses can use Raw property for read/write
|
2001-10-07 02:41:52 +02:00
|
|
|
/// access.
|
|
|
|
/// </remarks>
|
|
|
|
|
|
|
|
public IntPtr Handle {
|
|
|
|
get {
|
|
|
|
return _obj;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2001-09-27 20:39:53 +02:00
|
|
|
/// <summary>
|
2002-01-12 03:08:16 +01:00
|
|
|
/// EventList Property
|
2001-09-27 20:39:53 +02:00
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// A list object containing all the events for this
|
|
|
|
/// object indexed by the Gtk+ signal name.
|
|
|
|
/// </remarks>
|
|
|
|
|
2002-01-12 03:08:16 +01:00
|
|
|
protected EventHandlerList EventList {
|
2001-09-19 13:37:15 +02:00
|
|
|
get {
|
|
|
|
if (_events == null)
|
|
|
|
_events = new EventHandlerList ();
|
|
|
|
return _events;
|
2001-09-19 04:04:57 +02:00
|
|
|
}
|
|
|
|
}
|
2001-09-19 06:47:48 +02:00
|
|
|
|
2001-10-31 02:31:05 +01:00
|
|
|
/// <summary>
|
|
|
|
/// GetHashCode Method
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
|
|
|
/// Calculates a hashing value.
|
|
|
|
/// </remarks>
|
|
|
|
|
|
|
|
public override int GetHashCode ()
|
|
|
|
{
|
|
|
|
return Handle.GetHashCode ();
|
|
|
|
}
|
|
|
|
|
2001-09-27 20:39:53 +02:00
|
|
|
/// <summary>
|
2003-07-04 09:13:19 +02:00
|
|
|
/// Data property
|
2001-09-27 20:39:53 +02:00
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
2003-07-04 09:13:19 +02:00
|
|
|
/// Stores and Accesses arbitrary data on the Object.
|
2001-09-27 20:39:53 +02:00
|
|
|
/// </remarks>
|
2001-09-20 06:03:27 +02:00
|
|
|
|
2003-07-04 09:13:19 +02:00
|
|
|
public Hashtable Data {
|
|
|
|
get {
|
|
|
|
if (data == null)
|
|
|
|
data = new Hashtable ();
|
|
|
|
|
|
|
|
return data;
|
|
|
|
}
|
2001-09-19 04:04:57 +02:00
|
|
|
}
|
2001-09-20 06:03:27 +02:00
|
|
|
|
2003-02-22 05:34:56 +01:00
|
|
|
[DllImport("libgobject-2.0-0.dll")]
|
2002-06-23 20:49:33 +02:00
|
|
|
static extern void g_object_get_property (
|
|
|
|
IntPtr obj, string name, IntPtr val);
|
|
|
|
|
2001-09-28 20:23:14 +02:00
|
|
|
/// <summary>
|
|
|
|
/// GetProperty Method
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
2002-05-02 23:57:41 +02:00
|
|
|
/// Accesses a Value Property.
|
2001-09-28 20:23:14 +02:00
|
|
|
/// </remarks>
|
|
|
|
|
2002-06-05 23:59:10 +02:00
|
|
|
public void GetProperty (String name, GLib.Value val)
|
2001-09-28 20:23:14 +02:00
|
|
|
{
|
2002-06-05 23:59:10 +02:00
|
|
|
g_object_get_property (Raw, name, val.Handle);
|
2001-09-28 20:23:14 +02:00
|
|
|
}
|
|
|
|
|
2003-02-22 05:34:56 +01:00
|
|
|
[DllImport("libgobject-2.0-0.dll")]
|
2002-06-23 20:49:33 +02:00
|
|
|
static extern void g_object_set_property (
|
|
|
|
IntPtr obj, string name, IntPtr val);
|
|
|
|
|
2002-01-12 03:08:16 +01:00
|
|
|
/// <summary>
|
|
|
|
/// SetProperty Method
|
|
|
|
/// </summary>
|
|
|
|
///
|
|
|
|
/// <remarks>
|
2002-05-02 23:57:41 +02:00
|
|
|
/// Accesses a Value Property.
|
2002-01-12 03:08:16 +01:00
|
|
|
/// </remarks>
|
|
|
|
|
2002-05-02 23:57:41 +02:00
|
|
|
public void SetProperty (String name, GLib.Value val)
|
2002-01-12 03:08:16 +01:00
|
|
|
{
|
2002-05-02 23:57:41 +02:00
|
|
|
g_object_set_property (Raw, name, val.Handle);
|
2002-01-12 03:08:16 +01:00
|
|
|
}
|
|
|
|
|
2002-09-01 06:46:38 +02:00
|
|
|
[DllImport("gtksharpglue")]
|
|
|
|
static extern bool gtksharp_is_object (IntPtr obj);
|
|
|
|
|
|
|
|
internal static bool IsObject (IntPtr obj)
|
|
|
|
{
|
|
|
|
return gtksharp_is_object (obj);
|
|
|
|
}
|
2002-11-10 11:09:05 +01:00
|
|
|
|
|
|
|
[DllImport("gtksharpglue")]
|
|
|
|
static extern int gtksharp_object_get_ref_count (IntPtr obj);
|
|
|
|
|
|
|
|
public int RefCount {
|
|
|
|
get {
|
|
|
|
return gtksharp_object_get_ref_count (Handle);
|
|
|
|
}
|
|
|
|
}
|
2001-09-19 04:04:57 +02:00
|
|
|
}
|
|
|
|
}
|