1 /** Copyright (c) 2017 Samsung Electronics Co., Ltd.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 // This File has been auto-generated by SWIG and then modified using DALi Ruby Scripts
17 //------------------------------------------------------------------------------
20 // This file was automatically generated by SWIG (http://www.swig.org).
23 // Do not make changes to this file unless you know what you are doing--modify
24 // the SWIG interface file instead.
25 //------------------------------------------------------------------------------
27 namespace Tizen.NUI.BaseComponents
30 using System.Runtime.InteropServices;
33 /// ImageView is a class for displaying an image resource.<br>
34 /// An instance of ImageView can be created using a URL or an Image instance.<br>
36 public class ImageView : View
38 private global::System.Runtime.InteropServices.HandleRef swigCPtr;
40 internal ImageView(global::System.IntPtr cPtr, bool cMemoryOwn) : base(NDalicPINVOKE.ImageView_SWIGUpcast(cPtr), cMemoryOwn)
42 swigCPtr = new global::System.Runtime.InteropServices.HandleRef(this, cPtr);
43 // By default, we do not want the position to use the anchor point
44 PositionUsesAnchorPoint = false;
47 internal static global::System.Runtime.InteropServices.HandleRef getCPtr(ImageView obj)
49 return (obj == null) ? new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero) : obj.swigCPtr;
54 /// Event arguments of resource ready.
56 public class ResourceReadyEventArgs : EventArgs
61 /// The view whose resource is ready.
76 private EventHandler<ResourceReadyEventArgs> _resourceReadyEventHandler;
77 [UnmanagedFunctionPointer(CallingConvention.StdCall)]
78 private delegate void ResourceReadyEventCallbackType(IntPtr data);
79 private ResourceReadyEventCallbackType _resourceReadyEventCallback;
82 /// Event for ResourceReady signal which can be used to subscribe/unsubscribe the event handler.<br>
83 /// This signal is emitted after all resources required by a control are loaded and ready.<br>
84 /// Most resources are only loaded when the control is placed on stage.<br>
86 public event EventHandler<ResourceReadyEventArgs> ResourceReady
90 if (_resourceReadyEventHandler == null)
92 _resourceReadyEventCallback = OnResourceReady;
93 ResourceReadySignal(this).Connect(_resourceReadyEventCallback);
96 _resourceReadyEventHandler += value;
101 _resourceReadyEventHandler -= value;
103 if (_resourceReadyEventHandler == null && ResourceReadySignal(this).Empty() == false)
105 ResourceReadySignal(this).Disconnect(_resourceReadyEventCallback);
110 // Callback for View ResourceReady signal
111 private void OnResourceReady(IntPtr data)
113 ResourceReadyEventArgs e = new ResourceReadyEventArgs();
116 e.View = View.GetViewFromPtr(data);
119 if (_resourceReadyEventHandler != null)
121 _resourceReadyEventHandler(this, e);
125 //you can override it to clean-up your own resources.
126 protected override void Dispose(DisposeTypes type)
133 if(type == DisposeTypes.Explicit)
136 //Release your own managed resources here.
137 //You should release all of your own disposable objects here.
140 _nPatchMap?.Dispose();
144 //Release your own unmanaged resources here.
145 //You should not access any managed member here except static instance.
146 //because the execution order of Finalizes is non-deterministic.
148 if (swigCPtr.Handle != global::System.IntPtr.Zero)
153 NDalicPINVOKE.delete_ImageView(swigCPtr);
155 swigCPtr = new global::System.Runtime.InteropServices.HandleRef(null, global::System.IntPtr.Zero);
161 internal class Property
163 internal static readonly int RESOURCE_URL = NDalicPINVOKE.ImageView_Property_RESOURCE_URL_get();
164 internal static readonly int IMAGE = NDalicPINVOKE.ImageView_Property_IMAGE_get();
165 internal static readonly int PRE_MULTIPLIED_ALPHA = NDalicPINVOKE.ImageView_Property_PRE_MULTIPLIED_ALPHA_get();
166 internal static readonly int PIXEL_AREA = NDalicPINVOKE.ImageView_Property_PIXEL_AREA_get();
170 /// Creates an initialized ImageView.
172 public ImageView() : this(NDalicPINVOKE.ImageView_New__SWIG_0(), true)
174 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
178 /// Creates an initialized ImageView from an URL to an image resource.<br>
179 /// If the string is empty, ImageView will not display anything.<br>
181 /// <param name="url">The url of the image resource to display</param>
182 public ImageView(string url) : this(NDalicPINVOKE.ImageView_New__SWIG_2(url), true)
184 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
187 internal ImageView(string url, Uint16Pair size) : this(NDalicPINVOKE.ImageView_New__SWIG_3(url, Uint16Pair.getCPtr(size)), true)
189 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
194 /// Downcasts a handle to ImageView handle.<br>
195 /// If handle points to a ImageView, the downcast produces valid handle.<br>
196 /// If not, the returned handle is left uninitialized.<br>
198 /// <param name="handle">Handle to an object</param>
199 /// <returns>Handle to a ImageView or an uninitialized handle</returns>
200 internal new static ImageView DownCast(BaseHandle handle)
202 ImageView ret = new ImageView(NDalicPINVOKE.ImageView_DownCast(BaseHandle.getCPtr(handle)), true);
203 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
207 /// Sets this ImageView from the given URL.<br>
208 /// If the URL is empty, ImageView will not display anything.<br>
210 /// <param name="url">The URL to the image resource to display</param>
211 public void SetImage(string url)
213 NDalicPINVOKE.ImageView_SetImage__SWIG_1(swigCPtr, url);
214 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
216 internal void SetImage(string url, Uint16Pair size)
218 NDalicPINVOKE.ImageView_SetImage__SWIG_2(swigCPtr, url, Uint16Pair.getCPtr(size));
219 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
222 internal ViewResourceReadySignal ResourceReadySignal(View view) {
223 ViewResourceReadySignal ret = new ViewResourceReadySignal(NDalicPINVOKE.ResourceReadySignal(View.getCPtr(view)), false);
224 if (NDalicPINVOKE.SWIGPendingException.Pending) throw NDalicPINVOKE.SWIGPendingException.Retrieve();
229 /// Query if all resources required by a control are loaded and ready.<br>
230 /// Most resources are only loaded when the control is placed on stage.<br>
231 /// true if the resources are loaded and ready, false otherwise.<br>
233 public bool IsResourceReady()
235 bool ret = NDalicPINVOKE.IsResourceReady(swigCPtr);
236 if (NDalicPINVOKE.SWIGPendingException.Pending)
237 throw NDalicPINVOKE.SWIGPendingException.Retrieve();
242 /// ImageView ResourceUrl, type string
244 public string ResourceUrl
258 /// ImageView ImageMap, type PropertyMap : string if it is a url, map otherwise
260 public PropertyMap ImageMap
266 PropertyMap temp = new PropertyMap();
267 GetProperty(ImageView.Property.IMAGE).Get(temp);
279 SetProperty(ImageView.Property.IMAGE, new Tizen.NUI.PropertyValue(value));
285 /// ImageView PreMultipliedAlpha, type Boolean.<br>
286 /// Image must be initialized.<br>
288 public bool PreMultipliedAlpha
293 GetProperty(ImageView.Property.PRE_MULTIPLIED_ALPHA).Get(out temp);
298 SetProperty(ImageView.Property.PRE_MULTIPLIED_ALPHA, new Tizen.NUI.PropertyValue(value));
303 /// ImageView PixelArea, type Vector4 (Animatable property).<br>
304 /// Pixel area is a relative value with the whole image area as [0.0, 0.0, 1.0, 1.0].<br>
306 public RelativeVector4 PixelArea
310 Vector4 temp = new Vector4(0.0f, 0.0f, 0.0f, 0.0f);
311 GetProperty(ImageView.Property.PIXEL_AREA).Get(temp);
316 SetProperty(ImageView.Property.PIXEL_AREA, new Tizen.NUI.PropertyValue(value));
321 /// The border of the image in the order: left, right, bottom, top.<br>
322 /// If set, ImageMap will be ignored.<br>
323 /// For N-Patch images only.<br>
326 public Rectangle Border
340 /// Get or set whether to draws the borders only(If true).<br>
341 /// If not specified, the default is false.<br>
342 /// For N-Patch images only.<br>
345 public bool BorderOnly
349 return _borderOnly ?? false;
358 public bool SynchronosLoading
362 return _synchronousLoading ?? false;
366 _synchronousLoading = value;
371 private void UpdateImage()
376 { // for nine-patch image
377 _nPatchMap = new PropertyMap();
378 _nPatchMap.Add(Visual.Property.Type, new PropertyValue((int)Visual.Type.NPatch));
379 _nPatchMap.Add(NpatchImageVisualProperty.URL, new PropertyValue(_url));
380 _nPatchMap.Add(NpatchImageVisualProperty.Border, new PropertyValue(_border));
381 if (_borderOnly != null) { _nPatchMap.Add(NpatchImageVisualProperty.BorderOnly, new PropertyValue((bool)_borderOnly)); }
382 if (_synchronousLoading != null) _nPatchMap.Add(NpatchImageVisualProperty.SynchronousLoading, new PropertyValue((bool)_synchronousLoading));
383 SetProperty(ImageView.Property.IMAGE, new PropertyValue(_nPatchMap));
385 else if(_synchronousLoading != null)
386 { // for normal image, with synchronous loading property
387 PropertyMap imageMap = new PropertyMap();
388 imageMap.Add(Visual.Property.Type, new PropertyValue((int)Visual.Type.Image));
389 imageMap.Add(ImageVisualProperty.URL, new PropertyValue(_url));
390 imageMap.Add(ImageVisualProperty.SynchronousLoading, new PropertyValue((bool)_synchronousLoading));
391 SetProperty(ImageView.Property.IMAGE, new PropertyValue(imageMap));
394 { // just for normal image
395 SetProperty(ImageView.Property.RESOURCE_URL, new PropertyValue(_url));
400 private Rectangle _border = null;
401 private PropertyMap _nPatchMap = null;
402 private bool? _synchronousLoading = null;
403 private bool? _borderOnly = null;
404 private string _url = null;