/* * 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(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; } /// 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; private bool handled = true; /// /// 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; } } /// /// Gets or sets a value that indicates whether the event handler has completely handled the event or whether the system should continue its own processing. /// [EditorBrowsable(EditorBrowsableState.Never)] public bool Handled { get => handled; set { handled = value; Interop.Actor.SetNeedGesturePropagation(View.getCPtr(view), !value); if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve(); } } } } }