Class ImageView
Definition
- Namespace:
- Tizen.NUI.BaseComponents
- Assembly:
- Tizen.NUI.dll
- API Level:
- 3
ImageView is a class for displaying an image resource.
An instance of ImageView can be created using a URL or an image instance.
C#Copypublic class ImageView : View, INotifyPropertyChanged, IDynamicResourceHandler, IElement, INameScope, IElementController, IDisposable, IResourcesProvider
- Inheritance
- Derived
-
Tizen.NUI.BaseComponents.AnimatedImageView
- Implements
Constructors
Declaration
C#Copypublic ImageView()
API Level: 3
ImageView(String)
Creates an initialized ImageView from a URL to an image resource.
If the string is empty, ImageView will not display anything.
Declaration
C#Copypublic ImageView(string url)
Parameters
| Type | Name | Description |
|---|---|---|
| String | url | The URL of the image resource to display. |
API Level: 3
Properties
AdjustViewSize
Gets or sets the mode to adjust view size to preserve the aspect ratio of the image resource.
Declaration
C#Copypublic bool AdjustViewSize { get; set; }
Property Value
| Type | Description |
|---|---|
| Boolean |
Remarks
This is false by default. If this is set to be true, then the width or height value, which is not set by user explicitly, can be changed automatically to preserve the aspect ratio of the image resource. AdjustViewSize works only if ImageView is added to a View having Layout. e.g. If the image resource size is (100, 100), then the ImageView requests size (100, 100) to its parent layout by default. If the ImageView's HeightSpecification is 50 and AdjustViewSize is true, then the ImageView requests size (50, 50) instead of (100, 50).
API Level: 9
Border
The border of the image in the order: left, right, bottom, top.
If set, ImageMap will be ignored.
For N-Patch images only.
Optional.
Declaration
C#Copypublic Rectangle Border { get; set; }
Property Value
| Type | Description |
|---|---|
| Rectangle |
Remarks
The property cascade chaining set is possible. For example, this (imageView.Border.X = 1;) is possible.
API Level: 3
BorderOnly
Gets or sets whether to draw the borders only (if true).
If not specified, the default is false.
For N-Patch images only.
Optional.
Declaration
C#Copypublic bool BorderOnly { get; set; }
Property Value
| Type | Description |
|---|---|
| Boolean |
API Level: 3
Declaration
C#Copypublic bool CropToMask { get; set; }
Property Value
| Type | Description |
|---|---|
| Boolean |
API Level: 6
Declaration
C#Copypublic PropertyMap Image { get; set; }
Property Value
| Type | Description |
|---|---|
| PropertyMap |
Remarks
This PropertyMap use a ImageVisualProperty.
See ImageVisualProperty for a detailed description.
you can also use Visual.Property.
See Visual.Property for a detailed description.
Examples
The following example demonstrates how to use the Image property.
CopyPropertyMap map = new PropertyMap(); map.Insert(Visual.Property.Type, new PropertyValue((int)Visual.Type.Image)); map.Insert(ImageVisualProperty.AlphaMaskURL, new PropertyValue(url)); map.Insert(ImageVisualProperty.FittingMode, new PropertyValue((int)FittingModeType.ScaleToFill); imageview.Image = map;
API Level: 4
Declaration
C#Copypublic ImageView.LoadingStatusType LoadingStatus { get; }
Property Value
| Type | Description |
|---|---|
| ImageView.LoadingStatusType |
API Level: 5
OrientationCorrection
Gets or sets whether to automatically correct the orientation of an image.
Declaration
C#Copypublic bool OrientationCorrection { get; set; }
Property Value
| Type | Description |
|---|---|
| Boolean |
API Level: 5
PixelArea
ImageView PixelArea, type Vector4 (Animatable property).
Pixel area is a relative value with the whole image area as [0.0, 0.0, 1.0, 1.0].
Declaration
C#Copypublic RelativeVector4 PixelArea { get; set; }
Property Value
| Type | Description |
|---|---|
| RelativeVector4 |
Remarks
The property cascade chaining set is possible. For example, this (imageView.PixelArea.X = 0.1f;) is possible.
API Level: 3
PreMultipliedAlpha
ImageView PreMultipliedAlpha, type Boolean.
Image must be initialized.
Declaration
C#Copypublic bool PreMultipliedAlpha { get; set; }
Property Value
| Type | Description |
|---|---|
| Boolean |
API Level: 3
ResourceUrl
ImageView ResourceUrl, type string. This is one of mandatory property. Even if not set or null set, it sets empty string ("") internally. When it is set as null, it gives empty string ("") to be read.
Declaration
C#Copypublic string ResourceUrl { get; set; }
Property Value
| Type | Description |
|---|---|
| String |
API Level: 3
Declaration
C#Copy[Obsolete("This has been deprecated since API9 and will be removed in API11. Use SynchronousLoading instead.")] public bool SynchronosLoading { get; set; }
Property Value
| Type | Description |
|---|---|
| Boolean |
API Level: 3
SynchronousLoading
Gets or sets whether the image of the ResourceUrl property will be loaded synchronously.
Declaration
C#Copypublic bool SynchronousLoading { get; set; }
Property Value
| Type | Description |
|---|---|
| Boolean |
Remarks
Changing this property make this ImageView load image synchronously at the next loading by following operation: Reload(), SetImage(String), and by some properties those cause reloading: ResourceUrl, PreMultipliedAlpha and etc.
API Level: 9
Methods
Declaration
C#Copyprotected override void Dispose(DisposeTypes type)
Parameters
| Type | Name | Description |
|---|---|---|
| DisposeTypes | type | DisposeTypes |
Overrides
API Level: 3
IsResourceReady()
Queries if all resources required by a control are loaded and ready.
Most resources are only loaded when the control is placed on the stage.
True if the resources are loaded and ready, false otherwise.
Declaration
C#Copypublic bool IsResourceReady()
Returns
| Type | Description |
|---|---|
| Boolean |
API Level: 3
Declaration
C#Copypublic void Pause()
API Level: 5
Declaration
C#Copypublic void Play()
API Level: 5
Reload()
Forcefully reloads the image. All the visuals using this image will reload to the latest image.
Declaration
C#Copypublic void Reload()
API Level: 5
SetImage(String)
Sets this ImageView from the given URL.
If the URL is empty, ImageView will not display anything.
Declaration
C#Copypublic void SetImage(string url)
Parameters
| Type | Name | Description |
|---|---|---|
| String | url | The URL to the image resource to display. |
Exceptions
| Type | Condition |
|---|---|
| ArgumentNullException | Thrown when url is null. |
API Level: 3
Declaration
C#Copypublic void Stop()
API Level: 5
Events
ResourceReady
An event for ResourceReady signal which can be used to subscribe or unsubscribe the event handler.
This signal is emitted after all resources required by a control are loaded and ready.
Most resources are only loaded when the control is placed on the stage.
Declaration
C#Copypublic event EventHandler<ImageView.ResourceReadyEventArgs> ResourceReady
Event Type
| Type | Description |
|---|---|
| EventHandler<ImageView.ResourceReadyEventArgs> |