BitMap表示一个位图文件,支持“JPEG, PNG, GIF, and BMP”所有图片类型。Image不支持Gif图片显示。
Image属性
-
Aspect :Aspect枚举类型,设置Image的缩放模式。
Fill - 拉伸图片填充整个显示区域,可能会导致图像失真.
AspectFill -剪切图片填充整个区域,不会使图像失真.
AspectFit - 不对图像进行拉伸和剪切处理,根据图像的大小上下或左右留白显示,默认值.
不同平台缩放效果可能会有所不同
- IsLoading :bool类型,表示图片的加载状态。
- IsOpaque :bool类型,设置Image是否透明。
- Source :ImageSource类型,设置显示的图片资源。
ImageSource介绍
ImageSource提供了四个静态方法来创建对象。
- FromUri :根据网络图片资源创建对象。
- FromResource :根据嵌入到PCL的图片资源创建对象。
- FromFile :根据各个平台提供的图片资源创建对象。
- FromStream :根据.NET Stream创建对象。
Xamarin.Forms 提供了三个ImageSource的子类。
- UriImageSource :表示网络图片资源,对应FromUri。
- FileImageSource :表示平台相关图片资源,对应FromFile。
- StreamImageSource :表示流图片资源,对应FromStream。
在XAML中定义ImageSource使用提供的ImageSource子类更方便,在代码中定义使用提供的静态方法更方便,静态方法内部实现就是返回系统提供的子类。
访问网络图片资源
FromUri代码示范:
Image image = new Image()
{
Source = ImageSource.FromUri(new Uri("http://cdn-qn0.jianshu.io/assets/apple-touch-icons/72-feca4b183b9d29fd188665785dc7a7f1.png"))
};
也可以直接设置Image的Source为string或Uri类型地址,会隐式转换为ImageSource。
Image image = new Image()
{
Source = "http://cdn-qn0.jianshu.io/assets/apple-touch-icons/72-feca4b183b9d29fd188665785dc7a7f1.png"
};
对应XAML为:
<Image Source="http://cdn-qn0.jianshu.io/assets/apple-touch-icons/72-feca4b183b9d29fd188665785dc7a7f1.png"/>
XAML定义UriImageSource示范:
<Image HorizontalOptions="Center" VerticalOptions="Center" WidthRequest="200" HeightRequest="200" Aspect="Fill">
<Image.Source>
<UriImageSource Uri="http://cdn-qn0.jianshu.io/assets/apple-touch-icons/72-feca4b183b9d29fd188665785dc7a7f1.png"/>
</Image.Source>
</Image>
UriImageSource定义了CachingEnabled
和CachingValidity
连个属性。CachingEnabled表示是否启用缓存,bool类型默认为true。CachingValidity表示缓存的有效时间,TimeSpan类型,默认为1天。
访问嵌入到PCL图片资源
图片资源添加到PCL项目中,设置图片的Build Action
为EmbeddedResource
。
资源嵌入到项目中会有一个对应的资源ID,对应的资源ID为程序集名.文件夹(若果有).图片全名(包含扩展名)
,如果不能确定资源ID可以调用Assembly 对象的GetManifestResourceNames
方法,返回一个string类型数组,表示项目中所有资源的ID。更简单的方法就是图片资源右键属性查看资源ID。
调用FromResource创建图片资源
var imageResID = "views.image.image.png";
image.Source = ImageSource.FromResource(imageResID);
XAML中如何调用嵌入资源?如果你熟悉x:FactoryMethod
使用,可能会想通过x:FactoryMethod调用ImageSource.FromResource
方法,但是ImageSource.FromResource方法要求图片资源与调用方法在同一个程序集内,通过x:FactoryMethod调用ImageSource.FromResource方法时调用代码是在Xamarin.Forms.Xaml
程序集内的。
《Creating Mobile App with Xamarin.Forms》中介绍了解决方法,定义一个XAML扩展标记(先不多做介绍)。
[ContentProperty("Source")]
public class ResourceImageExtension : IMarkupExtension
{
public string Source
{
get;
set;
}
public object ProvideValue(IServiceProvider serviceProvider)
{
if (Source == null)
return null;
return ImageSource.FromResource(Source);
}
}
定义了Source属性表示图片资源ID。添加ContentProperty特性,指定Source为ContentProperty,在使用ResourceImageExtension时不必明确指定“Source=”。
XAML中定义,local表示ResourceImageExtension所在命名空间
<Image x:Name="image" Source="{local:ResourceImageExtension views.image.image.png}"/>
访问单独平台图片资源
由于每个平台对一些图片有特别的分辨率要求,所以有时候会为每个平台准备不同大小图片,ImageSource.FromFile
静态方法和相应的FileImageSource
类能方便访问存储在平台项目中的图片资源。
各平台存储图片路径:
iOS - 图片存储在Resources 目录中并设置Build Action为BundleResource (提供@2x命名文件,相关分辨率知识不做介绍).
Android - 图片存储在Resources/drawable 目录中并设置Build Action:为AndroidResource. (不同分辨路图片放在Resources下drawable-ldpi 或drawable-hdpi 等子目录中 ).
Windows Phone - 图片存储在Assets目录或其子目录下并设置Build Action为Content .
示例代码:
image.Source = new FileImageSource()
{
File = Device.OnPlatform(iOS: "ios.png", Android: "android.png", WinPhone: "Assets/WindowsPhone.png")
};
对于iOS和Android直接指定文件名即可,这两个平台资源文件默认存储在Resources目录中,Windows Phone对应的路径应包含Assets目录。
对应的XAML为
<Image>
<Image.Source>
<OnPlatform x:TypeArguments="ImageSource" iOS="ios.png" Android="android.png" WinPhone="Assets/WindowsPhone.png" />
</Image.Source>
</Image>
分别截取了Android和iOS模拟器的图片,运行起来效果有点怪。
通过Stream访问图片资源
通过Stream可以访问网络图片和嵌入项目中的图片资源。ImageSource.FromStream
或者StreamImageSource
可以帮助我们轻松的访问Stream对应的图片资源。
FromStream方法的参数并不是Stream类型而是Func<Stream>
类型(一个无参数,返回值为Stream的方法)。
示例1——访问本地嵌入图片资源
var imageResID = "views.image.image.png";
image.Source = ImageSource.FromStream(() =>
{
Assembly assembly = GetType().GetTypeInfo().Assembly;
return assembly.GetManifestResourceStream(imageResID);
});
示例2——访问网络图片资源
var request = WebRequest.Create(new Uri("http://img2.myhsw.cn/2015-12-29/q9z0b418.jpg"));
request.BeginGetResponse((IAsyncResult arg) =>
{
var stream = request.EndGetResponse(arg).GetResponseStream();
//Windows 平台特殊处理
if (Device.OS == TargetPlatform.WinPhone || Device.OS == TargetPlatform.Windows)
{
MemoryStream memStream = new MemoryStream();
stream.CopyTo(memStream);
memStream.Seek(0, SeekOrigin.Begin);
stream = memStream;
}
var imageSource = ImageSource.FromStream(() => stream);
Device.BeginInvokeOnMainThread(() => { image.Source = imageSource; });
}, null);
子线程中不允许更新UI,在子线程中更新UI借助Device.BeginInvokeOnMainThread
方法完成。
不同平台图片显示效果不同。
“On iOS and Android, the bitmap is displayed in its pixel size. In other words, the bitmap is rendered with a one-to-one mapping between the pixels of the bitmap and the pixels of the video display. The iPhone 6 simulator used for these screenshots has a screen width of 750 pixels, and you can see that the 256-pixel width of the bitmap is about one-third that width. The Android phone here is a Nexus 5, which has a pixel width of 1080, and the bitmap is about one-quarter that width.
On the Windows Runtime platforms, however, the bitmap is displayed in device-independent units—in this example, 256 device-independent units. The Nokia Lumia 925 used for these screenshots has a pixel width of 768, which is approximately the same as the iPhone 6. However, the screen width of this Windows 10 Mobile phone in device-independent units is 341, and you can see that the rendered bitmap is much wider than on the other platforms.”
Toolbar使用
Toolbar表示应用程序的工具栏,iOS和AndroidToolbar显示在屏幕顶部,Windows Phone显示在屏幕底部。
Forms并没有提供Toolbar类,为Page类的ToolbarItems集合赋值即可实现Toolbar效果。Windows Phone平台ContentPage添加ToolbarItem正常显示,Android和iOS平台必须使用NavigationPage。
ToolbarItem并不View实现而是继承MenuItem类,ToolbarItem定义了三个属性。
Text - ToolbarItem显示的文本。
Order - ToolbarItemOrder枚举类型,决定ToolbarItem显示图标(Primary)还是显示文字(Secondary)。
Icon - FileImageSource类型,ToolbarItem显示的图标。FileImageSource类型说明图标文件是单独存储在平台项目中。
XAML示例代码:
<ContentPage.ToolbarItems>
<ToolbarItem Text="Item 1" Order="Primary" Clicked="响应点击事件">
<ToolbarItem.Icon>
<OnPlatform x:TypeArguments="FileImageSource"
iOS="tc.png"
Android="tc.png"/>
</ToolbarItem.Icon>
</ToolbarItem>
<ToolbarItem Text="Item 2" Order="Primary" >
<ToolbarItem.Icon>
<OnPlatform x:TypeArguments="FileImageSource"
iOS="tf.png"
Android="tf.png"/>
</ToolbarItem.Icon>
</ToolbarItem>
<ToolbarItem Text="Item 3" Order="Primary" >
<ToolbarItem.Icon>
<OnPlatform x:TypeArguments="FileImageSource"
iOS="tg.png"
Android="tg.png"/>
</ToolbarItem.Icon>
</ToolbarItem>
<ToolbarItem Text="Item 4" Order="Secondary" >
<ToolbarItem.Icon>
<OnPlatform x:TypeArguments="FileImageSource"
iOS="tf.png"
Android="tf.png"/>
</ToolbarItem.Icon>
</ToolbarItem>
<ToolbarItem Text="Item 5" Order="Secondary" >
<ToolbarItem.Icon>
<OnPlatform x:TypeArguments="FileImageSource"
iOS="tg.png"
Android="tg.png"/>
</ToolbarItem.Icon>
</ToolbarItem>
</ContentPage.ToolbarItems>
一定要修改App.xaml.cs文件中构造函数MainPage赋值的代码为MainPage = new NavigationPage(new 自己的page类());
各平台图标像素要求
Android ToolbarItem图标像素:
• drawable-mdpi (medium DPI) — 32 pixels square
• drawable-hdpi (high DPI) — 48 pixels square
• drawable-xhdpi (extra high DPI) — 64 pixels square
• drawable-xxhdpi (extra extra high DPI) — 96 pixels square
IOS ToolbarItem图标像素:
默认为20像素正方形,应提供@2x(40-pixel-square )和@3x(60-pixel-square )版本使iPhone5 和iPhone6有更好的显示效果。
Windows Phone ToolbarItem图标像素要求:
大小为76像素的正方形图标。