mcs/class/System.Windows.Forms/System.Windows.Forms/ContainerControl.cs

   1 //
   2 // System.Windows.Forms.ContainerControl.cs
   3 //
   4 // Author:
   5 //   Miguel de Icaza (miguel@ximian.com)
   6 //   stubbed out by Jaak Simm (jaaksimm@firm.ee)
   7 //   Dennis Hayes (dennish@Raytek.com)
   8 //   WINELib implementation started by John Sohn (jsohn@columbus.rr.com)
   9 //
  10 // (C) Ximian, Inc., 2002/3
  11 //
  12
  13 //
  14 // Permission is hereby granted, free of charge, to any person obtaining
  15 // a copy of this software and associated documentation files (the
  16 // "Software"), to deal in the Software without restriction, including
  17 // without limitation the rights to use, copy, modify, merge, publish,
  18 // distribute, sublicense, and/or sell copies of the Software, and to
  19 // permit persons to whom the Software is furnished to do so, subject to
  20 // the following conditions:
  21 //
  22 // The above copyright notice and this permission notice shall be
  23 // included in all copies or substantial portions of the Software.
  24 //
  25 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  26 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  27 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  28 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  29 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  30 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  31 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  32 //
  33
  34 using System.ComponentModel;
  35 using System.Drawing;
  36
  37 namespace System.Windows.Forms {
  38
  39         /// <summary>
  40         /// Provides focus management functionality for controls that can function as a container for other controls.
  41         /// </summary>
  42
  43         public class ContainerControl : ScrollableControl, IContainerControl {
  44
  45                 private Control activeControl;
  46
  47                 public ContainerControl () : base ()
  48                 {
  49                         controlStyles_ |= ControlStyles.ContainerControl;
  50                 }
  51
  52
  53                 [MonoTODO]
  54                 public Control ActiveControl {
  55                         get {
  56                                 return(activeControl);
  57                         }
  58                         set {
  59                                 if ((value==activeControl) || (value==null)) {
  60                                         return;
  61                                 }
  62
  63                                 if (!Contains(value)) {
  64                                         throw new ArgumentException("Not a child control");
  65                                 }
  66
  67                                 // FIXME; need to let Wine know
  68                                 activeControl=value;
  69                         }
  70                 }
  71
  72                 //Compact Framework
  73                 [MonoTODO]
  74                 // not ready for BindingContext
  75                 public override BindingContext BindingContext {
  76                         get {
  77                                 throw new NotImplementedException ();
  78                         }
  79                         set {
  80                                 //fixme:
  81                         }
  82                 }
  83
  84                 protected override CreateParams CreateParams {
  85                         get { return base.CreateParams; }
  86                 }
  87
  88                 public Form ParentForm {
  89                         get {
  90                                 if (Parent != null) {
  91                                         return(Parent.FindForm());
  92                                 } else {
  93                                         return(FindForm());
  94                                 }
  95                         }
  96                 }
  97
  98                 /// --- Methods ---
  99                 /// internal .NET framework supporting methods, not stubbed out:
 100                 /// - protected virtual void UpdateDefaultButton()
 101
 102                 protected override void AdjustFormScrollbars (
 103                         bool displayScrollbars)
 104                 {
 105                         //FIXME:
 106                         base.AdjustFormScrollbars (displayScrollbars);
 107                 }
 108
 109                 protected override void Dispose (bool disposing)
 110                 {
 111                         //FIXME
 112                         base.Dispose(disposing);
 113                 }
 114
 115                 public bool ActivateControl(Control control)
 116                 {
 117                         Control                 parent=Parent;
 118                         ContainerControl        container;
 119                         bool                    result=true;
 120
 121                         // We might have a container inside a container, etc...
 122                         // if we do, make sure that the whole chain up knows about the activation
 123                         if (parent!=null) {
 124                                 container=parent.GetContainerControl() as ContainerControl;
 125                                 if ((container!=null) && (container.ActiveControl!=this)) {
 126                                         container.ActivateControl(this);
 127                                 }
 128                         }
 129
 130                         if (activeControl!=control) {
 131                                 // FIXME - let wine know
 132                                 activeControl=control;
 133                         }
 134                         return(result);
 135                 }
 136
 137                 // [event methods]
 138                 protected override void OnControlRemoved (ControlEventArgs e)
 139                 {
 140                         if ((e.Control==activeControl) || (e.Control.Contains(activeControl))) {
 141                                 ActiveControl=null;
 142                         }
 143                         base.OnControlRemoved(e);
 144                 }
 145
 146                 protected override void OnCreateControl ()
 147                 {
 148                         base.OnCreateControl ();
 149                         OnBindingContextChanged(EventArgs.Empty);
 150                 }
 151                 // end of [event methods]
 152
 153                 protected override bool ProcessDialogChar (char charCode)
 154                 {
 155                         // Only process if we own the whole thing
 156                         if (GetTopLevel()) {
 157                                 if (ProcessMnemonic(charCode)) {
 158                                         return(true);
 159                                 }
 160                         }
 161                         return base.ProcessDialogChar(charCode);
 162                 }
 163
 164                 [MonoTODO]
 165                 protected override bool ProcessDialogKey (Keys keyData)
 166                 {
 167                         if ( keyData == Keys.Tab ) {
 168                                 return ProcessTabKey ( Control.ModifierKeys != Keys.Shift );
 169                         } else if ((keyData==Keys.Left) || (keyData==Keys.Right) || (keyData==Keys.Up) || (keyData==Keys.Down)) {
 170                                 // Select the next control
 171
 172                                 Control select=this;
 173                                 bool    forward=true;
 174
 175                                 if ((keyData==Keys.Left) || (keyData==Keys.Up)) {
 176                                         forward=false;
 177                                 }
 178
 179                                 if (activeControl!=null) {
 180                                         select=activeControl.Parent;
 181                                 }
 182
 183                                 select.SelectNextControl(activeControl, forward, false, false, true);
 184                                 return(true);
 185                         }
 186                         return base.ProcessDialogKey(keyData);
 187                 }
 188
 189                 [MonoTODO]
 190                 protected override bool ProcessMnemonic (char charCode)
 191                 {
 192                         //FIXME:
 193                         return base.ProcessMnemonic(charCode);
 194                 }
 195
 196                 [MonoTODO]
 197                 protected virtual bool ProcessTabKey ( bool forward )
 198                 {
 199                         Control newFocus = getNextFocusedControl ( this, forward );
 200                         if ( newFocus != null )
 201                                 return newFocus.Focus ( );
 202                         return false;
 203                 }
 204
 205                 // Not an overridden function?
 206                 protected override void Select(bool directed,bool forward)
 207                 {
 208                         base.Select(directed, forward);
 209                 }
 210
 211                 protected virtual void UpdateDefaultButton() {
 212
 213                 }
 214
 215                 [MonoTODO]
 216                 public bool Validate ()
 217                 {
 218                         throw new NotImplementedException ();
 219                 }
 220
 221                 protected override void WndProc(ref Message m)
 222                 {
 223                         base.WndProc(ref m);
 224                 }
 225         }
 226 }