Xamarin.Forms Views介绍(四)

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定义了CachingEnabledCachingValidity连个属性。CachingEnabled表示是否启用缓存,bool类型默认为true。CachingValidity表示缓存的有效时间,TimeSpan类型,默认为1天。

访问嵌入到PCL图片资源

图片资源添加到PCL项目中,设置图片的Build ActionEmbeddedResource

资源嵌入到项目中会有一个对应的资源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 ActionBundleResource (提供@2x命名文件,相关分辨率知识不做介绍).
Android - 图片存储在Resources/drawable 目录中并设置Build Action:AndroidResource. (不同分辨路图片放在Resources下drawable-ldpidrawable-hdpi 等子目录中 ).
Windows Phone - 图片存储在Assets目录或其子目录下并设置Build ActionContent .

示例代码:

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模拟器的图片,运行起来效果有点怪。


iOS、Android运行效果

通过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显示在屏幕底部。

Toolbar 不同平台效果

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像素的正方形图标。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,723评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,080评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,604评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,440评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,431评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,499评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,893评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,541评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,751评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,547评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,619评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,320评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,890评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,896评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,137评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,796评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,335评论 2 342

推荐阅读更多精彩内容