/* * Copyright(c) 2019 Samsung Electronics Co., Ltd. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ using System; using System.Runtime.InteropServices; using Tizen.NUI.BaseComponents; using System.ComponentModel; namespace Tizen.NUI { /// /// This class emits a signals when a long press gesture occurs that meets the requirements set by the application.
/// For any valid long press, two signals will be emitted:
/// - First identifying the beginning (state = Started) i.e. when fingers held down for the required time.
/// - Second identifying the ending (state = Finished) i.e. when fingers are released.
///
/// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public class LongPressGestureDetector : GestureDetector { /// /// Constructor. /// /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public LongPressGestureDetector() : this(Interop.LongPressGestureDetector.New(), true) { if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); } /// /// Creates an initialized LongPressGestureDetector with the number of touches required.
/// A long press gesture will be emitted from this detector if the number of fingers touching the screen is equal to the touches required.
///
/// The number of touches required. /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public LongPressGestureDetector(uint touchesRequired) : this(Interop.LongPressGestureDetector.New(touchesRequired), true) { if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); } /// /// Creates an initialized LongPressGestureDetector with the minimum and maximum number of touches required.
/// A long press gesture will be emitted from this detector if the number of fingers touching the screen falls between the minimum and maximum touches set.
///
/// The minimum number of touches required. /// The maximum number of touches required. /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public LongPressGestureDetector(uint minTouches, uint maxTouches) : this(Interop.LongPressGestureDetector.New(minTouches, maxTouches), true) { if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); } /// /// The copy constructor. /// /// A reference to the copied handle /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public LongPressGestureDetector(LongPressGestureDetector handle) : this(Interop.LongPressGestureDetector.NewLongPressGestureDetector(LongPressGestureDetector.getCPtr(handle)), true) { if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); } internal LongPressGestureDetector(global::System.IntPtr cPtr, bool cMemoryOwn) : base(Interop.LongPressGestureDetector.Upcast(cPtr), cMemoryOwn) { } private DaliEventHandler _detectedEventHandler; [UnmanagedFunctionPointer(CallingConvention.StdCall)] private delegate void DetectedCallbackType(IntPtr actor, IntPtr longPressGesture); private DetectedCallbackType _detectedCallback; /// /// This signal is emitted when the specified long press is detected on the attached view. /// /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public event DaliEventHandler Detected { add { if (_detectedEventHandler == null) { _detectedCallback = OnLongPressGestureDetected; DetectedSignal().Connect(_detectedCallback); } _detectedEventHandler += value; } remove { _detectedEventHandler -= value; if (_detectedEventHandler == null && DetectedSignal().Empty() == false) { DetectedSignal().Disconnect(_detectedCallback); } } } /// /// Sets the number of touches required.
/// The number of touches corresponds to the number of fingers a user has on the screen. The default is 1.
///
/// Touches required /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public void SetTouchesRequired(uint touches) { Interop.LongPressGestureDetector.SetTouchesRequired(swigCPtr, touches); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); } /// /// Sets the minimum and maximum touches required. /// /// Minimum touches required. /// Maximum touches required. /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public void SetTouchesRequired(uint minTouches, uint maxTouches) { Interop.LongPressGestureDetector.SetTouchesRequired(swigCPtr, minTouches, maxTouches); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); } /// /// Retrieves the minimum number of touches required. /// /// The minimum number of touches required. /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public uint GetMinimumTouchesRequired() { uint ret = Interop.LongPressGestureDetector.GetMinimumTouchesRequired(swigCPtr); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); return ret; } /// /// Retrieves the maximum number of touches required. /// /// The maximum number of touches required. /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public uint GetMaximumTouchesRequired() { uint ret = Interop.LongPressGestureDetector.GetMaximumTouchesRequired(swigCPtr); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); return ret; } internal static LongPressGestureDetector GetLongPressGestureDetectorFromPtr(global::System.IntPtr cPtr) { LongPressGestureDetector ret = new LongPressGestureDetector(cPtr, false); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); return ret; } internal new static LongPressGestureDetector DownCast(BaseHandle handle) { LongPressGestureDetector ret = Registry.GetManagedBaseHandleFromNativePtr(handle) as LongPressGestureDetector; if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); return ret; } internal LongPressGestureDetector Assign(LongPressGestureDetector rhs) { LongPressGestureDetector ret = new LongPressGestureDetector(Interop.LongPressGestureDetector.Assign(swigCPtr, LongPressGestureDetector.getCPtr(rhs)), false); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); return ret; } internal LongPressGestureDetectedSignal DetectedSignal() { LongPressGestureDetectedSignal ret = new LongPressGestureDetectedSignal(Interop.LongPressGestureDetector.DetectedSignal(swigCPtr), false); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); return ret; } internal static global::System.Runtime.InteropServices.HandleRef getCPtr(LongPressGestureDetector obj) { return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero) : obj.swigCPtr; } /// This will not be public opened. [EditorBrowsable(EditorBrowsableState.Never)] protected override void ReleaseSwigCPtr(System.Runtime.InteropServices.HandleRef swigCPtr) { if (_detectedEventHandler == null && DetectedSignal().Empty() == false) { DetectedSignal().Disconnect(_detectedCallback); } Interop.LongPressGestureDetector.DeleteLongPressGestureDetector(swigCPtr); } private void OnLongPressGestureDetected(IntPtr actor, IntPtr longPressGesture) { DetectedEventArgs e = new DetectedEventArgs(); // Populate all members of "e" (LongPressGestureEventArgs) with real data. e.View = Registry.GetManagedBaseHandleFromNativePtr(actor) as View; if (null == e.View) { e.View = Registry.GetManagedBaseHandleFromRefObject(actor) as View; } e.LongPressGesture = Tizen.NUI.LongPressGesture.GetLongPressGestureFromPtr(longPressGesture); if (_detectedEventHandler != null) { //Here we send all data to user event handlers. _detectedEventHandler(this, e); } } /// /// Event arguments that passed via the LongPressGestureEvent signal. /// /// 5 /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public class DetectedEventArgs : EventArgs { private View _view; private LongPressGesture _longPressGesture; /// /// View the attached view. /// /// 5 /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public View View { get { return _view; } set { _view = value; } } /// /// The LongPressGesture. /// /// 5 /// This will be public opened in tizen_5.0 after ACR done. Before ACR, need to be hidden as inhouse API. [EditorBrowsable(EditorBrowsableState.Never)] public LongPressGesture LongPressGesture { get { return _longPressGesture; } set { _longPressGesture = value; } } } } }