mcs/class/Managed.Windows.Forms/System.Windows.Forms/BindingManagerBase.cs

   1 // Permission is hereby granted, free of charge, to any person obtaining
   2 // a copy of this software and associated documentation files (the
   3 // "Software"), to deal in the Software without restriction, including
   4 // without limitation the rights to use, copy, modify, merge, publish,
   5 // distribute, sublicense, and/or sell copies of the Software, and to
   6 // permit persons to whom the Software is furnished to do so, subject to
   7 // the following conditions:
   8 //
   9 // The above copyright notice and this permission notice shall be
  10 // included in all copies or substantial portions of the Software.
  11 //
  12 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  13 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  14 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  15 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  16 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  17 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  18 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  19 //
  20 // Copyright (c) 2004-2005 Novell, Inc.
  21 //
  22 // Authors:
  23 //      Peter Bartok    pbartok@novell.com
  24 //      Jackson Harper  jackson@ximian.com
  25 //
  26
  27
  28 // NOT COMPLETE
  29
  30 using System.ComponentModel;
  31 using System.Collections;
  32
  33 namespace System.Windows.Forms {
  34         public abstract class BindingManagerBase {
  35                 private BindingsCollection      bindings;
  36                 private bool pulling_data;
  37
  38                 private static int count = 0;
  39                 private int id = count++;
  40
  41 #region Public Constructors
  42                 public BindingManagerBase() {
  43                 }
  44                 #endregion      // Public Constructors
  45
  46                 #region Protected Instance Fields
  47                 protected EventHandler onCurrentChangedHandler;
  48                 protected EventHandler onPositionChangedHandler;
  49                 #endregion      // Protected Instance Fields
  50
  51                 #region Public Instance Properties
  52                 public BindingsCollection Bindings {
  53                         get {
  54                                 if (bindings == null) {
  55                                         bindings = new BindingsCollection ();
  56                                 }
  57                                 return bindings;
  58                         }
  59                 }
  60
  61                 public abstract int Count {
  62                         get;
  63                 }
  64
  65                 public abstract object Current {
  66                         get;
  67                 }
  68
  69                 public abstract int Position {
  70                         get; set;
  71                 }
  72                 #endregion      // Public Instance Properties
  73
  74                 #region Public Instance Methods
  75                 public abstract void AddNew();
  76
  77                 public abstract void CancelCurrentEdit();
  78
  79                 public abstract void EndCurrentEdit();
  80
  81                 public abstract PropertyDescriptorCollection GetItemProperties();
  82
  83                 public abstract void RemoveAt(int index);
  84
  85                 public abstract void ResumeBinding();
  86
  87                 public abstract void SuspendBinding();
  88                 #endregion      // Public Instance Methods
  89
  90                 internal abstract bool IsSuspended {
  91                         get;
  92                 }
  93
  94                 #region Protected Instance Methods
  95                 [MonoTODO]
  96                 protected internal virtual PropertyDescriptorCollection GetItemProperties(System.Collections.ArrayList dataSources, System.Collections.ArrayList listAccessors) {
  97                         throw new NotImplementedException();
  98                 }
  99
 100                 [MonoTODO]
 101                 protected virtual PropertyDescriptorCollection GetItemProperties(Type lisType, int offset, System.Collections.ArrayList dataSources, System.Collections.ArrayList listAccessors) {
 102                         throw new NotImplementedException();
 103                 }
 104
 105                 protected internal abstract string GetListName (System.Collections.ArrayList listAccessors);
 106
 107                 protected internal abstract void OnCurrentChanged (EventArgs e);
 108
 109                 protected void PullData()
 110                 {
 111                         pulling_data = true;
 112                         try {
 113                                 UpdateIsBinding ();
 114                                 foreach (Binding binding in Bindings)
 115                                         binding.PullData ();
 116                         } finally {
 117                                 pulling_data = false;
 118                         }
 119                 }
 120
 121                 protected void PushData()
 122                 {
 123                         if (pulling_data)
 124                                 return;
 125
 126                         UpdateIsBinding ();
 127                         foreach (Binding binding in Bindings)
 128                                 binding.PushData ();
 129                 }
 130
 131                 protected abstract void UpdateIsBinding();
 132                 #endregion      // Protected Instance Methods
 133
 134                 internal void AddBinding (Binding binding)
 135                 {
 136                         if (Bindings.Contains (binding))
 137                                 return;
 138                         Bindings.Add (binding);
 139                 }
 140
 141                 #region Events
 142                 public event EventHandler CurrentChanged {
 143                         add { onCurrentChangedHandler += value; }
 144                         remove { onCurrentChangedHandler -= value; }
 145                 }
 146
 147                 public event EventHandler PositionChanged {
 148                         add { onPositionChangedHandler += value; }
 149                         remove { onPositionChangedHandler -= value; }
 150                 }
 151                 #endregion      // Events
 152         }
 153 }