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 #region Public Constructors
  39                 public BindingManagerBase() {
  40                 }
  41                 #endregion      // Public Constructors
  42
  43                 #region Protected Instance Fields
  44                 protected EventHandler onCurrentChangedHandler;
  45                 protected EventHandler onPositionChangedHandler;
  46                 #endregion      // Protected Instance Fields
  47
  48                 #region Public Instance Properties
  49                 public BindingsCollection Bindings {
  50                         get {
  51                                 if (bindings == null) {
  52                                         bindings = new BindingsCollection ();
  53                                 }
  54                                 return bindings;
  55                         }
  56                 }
  57
  58                 public abstract int Count {
  59                         get;
  60                 }
  61
  62                 public abstract object Current {
  63                         get;
  64                 }
  65
  66                 public abstract int Position {
  67                         get; set;
  68                 }
  69                 #endregion      // Public Instance Properties
  70
  71                 #region Public Instance Methods
  72                 public abstract void AddNew();
  73
  74                 public abstract void CancelCurrentEdit();
  75
  76                 public abstract void EndCurrentEdit();
  77
  78                 public abstract PropertyDescriptorCollection GetItemProperties();
  79
  80                 public abstract void RemoveAt(int index);
  81
  82                 public abstract void ResumeBinding();
  83
  84                 public abstract void SuspendBinding();
  85                 #endregion      // Public Instance Methods
  86
  87                 internal abstract bool IsSuspended {
  88                         get;
  89                 }
  90
  91                 #region Protected Instance Methods
  92                 [MonoTODO]
  93                 protected internal virtual PropertyDescriptorCollection GetItemProperties(ArrayList dataSources, ArrayList listAccessors) {
  94                         throw new NotImplementedException();
  95                 }
  96
  97                 [MonoTODO]
  98                 protected virtual PropertyDescriptorCollection GetItemProperties(Type lisType, int offset, ArrayList dataSources, ArrayList listAccessors) {
  99                         throw new NotImplementedException();
 100                 }
 101
 102                 protected internal abstract string GetListName (ArrayList listAccessors);
 103
 104                 protected internal abstract void OnCurrentChanged (EventArgs e);
 105
 106                 protected void PullData()
 107                 {
 108                         pulling_data = true;
 109                         try {
 110                                 UpdateIsBinding ();
 111                                 foreach (Binding binding in Bindings)
 112                                         binding.PullData ();
 113                         } finally {
 114                                 pulling_data = false;
 115                         }
 116                 }
 117
 118                 protected void PushData()
 119                 {
 120                         if (pulling_data)
 121                                 return;
 122
 123                         UpdateIsBinding ();
 124                         foreach (Binding binding in Bindings)
 125                                 binding.PushData ();
 126                 }
 127
 128                 protected abstract void UpdateIsBinding();
 129                 #endregion      // Protected Instance Methods
 130
 131                 internal void AddBinding (Binding binding)
 132                 {
 133                         if (Bindings.Contains (binding))
 134                                 return;
 135                         Bindings.Add (binding);
 136                 }
 137
 138                 #region Events
 139                 public event EventHandler CurrentChanged {
 140                         add { onCurrentChangedHandler += value; }
 141                         remove { onCurrentChangedHandler -= value; }
 142                 }
 143
 144                 public event EventHandler PositionChanged {
 145                         add { onPositionChangedHandler += value; }
 146                         remove { onPositionChangedHandler -= value; }
 147                 }
 148                 #endregion      // Events
 149         }
 150 }