src/Tizen.NUI.Components/Controls/Switch.cs

   1 /*
   2  * Copyright(c) 2019 Samsung Electronics Co., Ltd.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  * http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  *
  16  */
  17 using System;
  18 using System.ComponentModel;
  19 using Tizen.NUI.BaseComponents;
  20 using Tizen.NUI.Components.Extension;
  21
  22 namespace Tizen.NUI.Components
  23 {
  24     /// <summary>
  25     /// Switch is one kind of common component, it can be used as selector.
  26     /// User can handle Navigation by adding/inserting/deleting NavigationItem.
  27     /// </summary>
  28     /// <since_tizen> 6 </since_tizen>
  29     public class Switch : Button
  30     {
  31         private ImageView track = null;
  32         private ImageView thumb = null;
  33
  34         static Switch() { }
  35
  36         /// <summary>
  37         /// Creates a new instance of a Switch.
  38         /// </summary>
  39         /// <since_tizen> 6 </since_tizen>
  40         public Switch() : base()
  41         {
  42             Initialize();
  43         }
  44
  45         /// <summary>
  46         /// Creates a new instance of a Switch with style.
  47         /// </summary>
  48         /// <param name="style">Create Switch by special style defined in UX.</param>
  49         /// <since_tizen> 8 </since_tizen>
  50         public Switch(string style) : base(style)
  51         {
  52             Initialize();
  53         }
  54
  55         /// <summary>
  56         /// Creates a new instance of a Switch with style.
  57         /// </summary>
  58         /// <param name="switchStyle">Create Switch by style customized by user.</param>
  59         /// <since_tizen> 8 </since_tizen>
  60         public Switch(SwitchStyle switchStyle) : base(switchStyle)
  61         {
  62             Initialize();
  63         }
  64
  65         /// <summary>
  66         /// An event for the item selected signal which can be used to subscribe or unsubscribe the event handler provided by the user.<br />
  67         /// </summary>
  68         /// <since_tizen> 6 </since_tizen>
  69         public event EventHandler<SelectEventArgs> SelectedEvent;
  70
  71         /// <summary>
  72         /// Get style of switch.
  73         /// </summary>
  74         /// <since_tizen> 8 </since_tizen>
  75         public new SwitchStyle Style => ViewStyle as SwitchStyle;
  76
  77         /// <summary>
  78         /// Apply style to switch.
  79         /// </summary>
  80         /// <param name="viewStyle">The style to apply.</param>
  81         [EditorBrowsable(EditorBrowsableState.Never)]
  82         public override void ApplyStyle(ViewStyle viewStyle)
  83         {
  84             base.ApplyStyle(viewStyle);
  85
  86             SwitchStyle swStyle = viewStyle as SwitchStyle;
  87
  88             if (null != swStyle)
  89             {
  90                 if (swStyle.Track != null)
  91                 {
  92                     Track.ApplyStyle(swStyle.Track);
  93                 }
  94
  95                 if (swStyle.Thumb != null)
  96                 {
  97                     Thumb.ApplyStyle(swStyle.Thumb);
  98                 }
  99             }
 100         }
 101
 102         /// <summary>
 103         /// Switch's track part.
 104         /// </summary>
 105         /// <since_tizen> 8 </since_tizen>
 106         public ImageView Track
 107         {
 108             get
 109             {
 110                 if (track == null)
 111                 {
 112                     track = new ImageView()
 113                     {
 114                         PositionUsesPivotPoint = true,
 115                         ParentOrigin = Tizen.NUI.ParentOrigin.CenterLeft,
 116                         PivotPoint = Tizen.NUI.PivotPoint.CenterLeft,
 117                         WidthResizePolicy = ResizePolicyType.FillToParent,
 118                         HeightResizePolicy = ResizePolicyType.FillToParent
 119                     };
 120
 121                     var extension = (SwitchExtension)Extension;
 122                     if (extension != null)
 123                     {
 124                         track = extension.OnCreateTrack(this, track);
 125                     }
 126                     Add(track);
 127                 }
 128                 return track;
 129             }
 130             internal set
 131             {
 132                 track = value;
 133             }
 134         }
 135
 136         /// <summary>
 137         /// Switch's thumb part.
 138         /// </summary>
 139         /// <since_tizen> 8 </since_tizen>
 140         public ImageView Thumb
 141         {
 142             get
 143             {
 144                 if (thumb == null)
 145                 {
 146                     thumb = new ImageView()
 147                     {
 148                         PositionUsesPivotPoint = true,
 149                         ParentOrigin = Tizen.NUI.ParentOrigin.CenterLeft,
 150                         PivotPoint = Tizen.NUI.PivotPoint.CenterLeft,
 151                         WidthResizePolicy = ResizePolicyType.Fixed,
 152                         HeightResizePolicy = ResizePolicyType.Fixed
 153                     };
 154
 155                     var extension = (SwitchExtension)Extension;
 156                     if (extension != null)
 157                     {
 158                         thumb = extension.OnCreateThumb(this, thumb);
 159                     }
 160                     Add(thumb);
 161                 }
 162                 return thumb;
 163             }
 164             internal set
 165             {
 166                 thumb = value;
 167             }
 168         }
 169
 170         /// <summary>
 171         /// Background image's resource url selector in Switch.
 172         /// </summary>
 173         /// <since_tizen> 6 </since_tizen>
 174         public StringSelector SwitchBackgroundImageURLSelector
 175         {
 176             get
 177             {
 178                 StringSelector strSl = new StringSelector();
 179                 strSl.Clone(Style?.Track?.ResourceUrl);
 180                 return strSl;
 181             }
 182             set
 183             {
 184                 if (null != value && null != Style?.Track)
 185                 {
 186                     Style.Track.ResourceUrl = value;
 187                 }
 188             }
 189         }
 190
 191         /// <summary>
 192         /// Handler image's resource url in Switch.
 193         /// </summary>
 194         /// <since_tizen> 6 </since_tizen>
 195         public string SwitchHandlerImageURL
 196         {
 197             get
 198             {
 199                 return Style?.Thumb?.ResourceUrl?.All;
 200             }
 201             set
 202             {
 203                 if (null != value && null != Style?.Thumb)
 204                 {
 205                     Style.Thumb.ResourceUrl = value;
 206                 }
 207             }
 208         }
 209
 210         /// <summary>
 211         /// Handler image's resource url selector in Switch.
 212         /// </summary>
 213         /// <since_tizen> 6 </since_tizen>
 214         public StringSelector SwitchHandlerImageURLSelector
 215         {
 216             get
 217             {
 218                 StringSelector strSl = new StringSelector();
 219                 strSl.Clone(Style?.Thumb?.ResourceUrl);
 220                 return strSl;
 221             }
 222             set
 223             {
 224                 if (null != value && null != Style?.Thumb)
 225                 {
 226                     Style.Thumb.ResourceUrl = value;
 227                 }
 228             }
 229         }
 230
 231         /// <summary>
 232         /// Handler image's size in Switch.
 233         /// </summary>
 234         /// <since_tizen> 6 </since_tizen>
 235         public Size SwitchHandlerImageSize
 236         {
 237             get
 238             {
 239                 return Style?.Thumb?.Size;
 240             }
 241             set
 242             {
 243                 if (null != Style?.Thumb)
 244                 {
 245                     Style.Thumb.Size = value;
 246                 }
 247             }
 248         }
 249
 250         /// <summary>
 251         /// Dispose Switch and all children on it.
 252         /// </summary>
 253         /// <param name="type">Dispose type.</param>
 254         /// <since_tizen> 6 </since_tizen>
 255         protected override void Dispose(DisposeTypes type)
 256         {
 257             if (disposed) return;
 258
 259             if (type == DisposeTypes.Explicit)
 260             {
 261                 Utility.Dispose(Thumb);
 262                 Utility.Dispose(Track);
 263             }
 264
 265             base.Dispose(type);
 266         }
 267
 268         /// <summary>
 269         /// Called after a key event is received by the view that has had its focus set.
 270         /// </summary>
 271         /// <param name="key">The key event.</param>
 272         /// <returns>True if the key event should be consumed.</returns>
 273         /// <since_tizen> 8 </since_tizen>
 274         public override bool OnKey(Key key)
 275         {
 276             if (!IsEnabled || null == key) return false;
 277
 278             bool ret = base.OnKey(key);
 279             if (key.State == Key.StateType.Up)
 280             {
 281                 if (key.KeyPressedName == "Return")
 282                 {
 283                     OnSelect();
 284                 }
 285             }
 286
 287             return ret;
 288         }
 289
 290         /// <summary>
 291         /// Called after a touch event is received by the owning view.<br />
 292         /// CustomViewBehaviour.REQUIRES_TOUCH_EVENTS must be enabled during construction. See CustomView(ViewWrapperImpl.CustomViewBehaviour behaviour).<br />
 293         /// </summary>
 294         /// <param name="touch">The touch event.</param>
 295         /// <returns>True if the event should be consumed.</returns>
 296         /// <since_tizen> 8 </since_tizen>
 297         public override bool OnTouch(Touch touch)
 298         {
 299             if(!IsEnabled || null == touch) return false;
 300
 301             PointStateType state = touch.GetState(0);
 302             bool ret = base.OnTouch(touch);
 303             switch (state)
 304             {
 305                 case PointStateType.Up:
 306                     OnSelect();
 307                     break;
 308                 default:
 309                     break;
 310             }
 311             return ret;
 312         }
 313
 314         /// <summary>
 315         /// Get Switch style.
 316         /// </summary>
 317         /// <returns>The default switch style.</returns>
 318         /// <since_tizen> 8 </since_tizen>
 319         protected override ViewStyle CreateViewStyle()
 320         {
 321             return new SwitchStyle();
 322         }
 323
 324         private void Initialize()
 325         {
 326             Style.IsSelectable = true;
 327         }
 328
 329         /// <summary>
 330         /// Theme change callback when theme is changed, this callback will be trigger.
 331         /// </summary>
 332         /// <param name="sender">The sender</param>
 333         /// <param name="e">The event data</param>
 334         [EditorBrowsable(EditorBrowsableState.Never)]
 335         protected override void OnThemeChangedEvent(object sender, StyleManager.ThemeChangeEventArgs e)
 336         {
 337             SwitchStyle switchStyle = StyleManager.Instance.GetViewStyle(StyleName) as SwitchStyle;
 338             if (null != switchStyle)
 339             {
 340                 Style.CopyFrom(switchStyle);
 341             }
 342         }
 343
 344         private void OnSelect()
 345         {
 346             if (SelectedEvent != null)
 347             {
 348                 SelectEventArgs eventArgs = new SelectEventArgs();
 349                 eventArgs.IsSelected = IsSelected;
 350                 SelectedEvent(this, eventArgs);
 351             }
 352         }
 353
 354         /// <summary>
 355         /// SelectEventArgs is a class to record item selected arguments which will sent to user.
 356         /// </summary>
 357         /// <since_tizen> 6 </since_tizen>
 358         public class SelectEventArgs : EventArgs
 359         {
 360             /// <summary> Select state of Switch </summary>
 361             /// <since_tizen> 6 </since_tizen>
 362             public bool IsSelected;
 363         }
 364
 365         /// <summary>
 366         /// Get current track part to the attached SwitchExtension.
 367         /// </summary>
 368         /// <remarks>
 369         /// It returns null if the passed extension is invaild.
 370         /// </remarks>
 371         /// <param name="extension">The extension instance that is currently attached to this Switch.</param>
 372         /// <return>The switch's track part.</return>
 373         [EditorBrowsable(EditorBrowsableState.Never)]
 374         public ImageView GetCurrentTrack(SwitchExtension extension)
 375         {
 376             return (extension == Extension) ? Track : null;
 377         }
 378
 379          /// <summary>
 380         /// Get current thumb part to the attached SwitchExtension.
 381         /// </summary>
 382         /// <remarks>
 383         /// It returns null if the passed extension is invaild.
 384         /// </remarks>
 385         /// <param name="extension">The extension instance that is currently attached to this Switch.</param>
 386         /// <return>The switch's thumb part.</return>
 387         [EditorBrowsable(EditorBrowsableState.Never)]
 388         public ImageView GetCurrentThumb(SwitchExtension extension)
 389         {
 390             return (extension == Extension) ? Thumb : null;
 391         }
 392     }
 393 }