第二十七章:自定义渲染器(二)

简介: 您好,自定义渲染器!HelloRenderers程序主要演示编写简单渲染器所需的开销。 该程序定义了一个名为HelloView的新View衍生,旨在显示一个简单的固定文本字符串。 这是HelloRenderers可移植类库项目中的完整HelloView.cs文件:using Xamarin.Forms;namespace HelloRenderers{ public class HelloView : View { }}而已! 但请注意,该类被定义为public。

您好,自定义渲染器!

HelloRenderers程序主要演示编写简单渲染器所需的开销。 该程序定义了一个名为HelloView的新View衍生,旨在显示一个简单的固定文本字符串。 这是HelloRenderers可移植类库项目中的完整HelloView.cs文件:

using Xamarin.Forms;
namespace HelloRenderers
{
    public class HelloView : View 
    {
    }
}

而已! 但请注意,该类被定义为public。 即使您可能认为此类仅在PCL中引用,但事实并非如此。 它必须对平台组件可见。
HelloRenderers PCL非常简单,甚至不会打扰页面类。 相反,它实例化并在App.cs文件中显示以页面为中心的HelloView对象:

namespace HelloRenderers
{
    public class App : Application
    {
        public App()
        {
            MainPage = new ContentPage
            {
                Content = new HelloView
                {
                    VerticalOptions = LayoutOptions.Center,
                    HorizontalOptions = LayoutOptions.Center
                }
            };
        }
    __
    }
}

没有任何其他代码,这个程序运行正常,但你实际上不会在屏幕上看到HelloView对象,因为它只是一个空白的透明视图。 我们需要的是HelloView的一些平台渲染器。
当Xamarin.Forms应用程序启动时,Xamarin.Forms使用.NET反射搜索构成应用程序的各种程序集,查找名为ExportRenderer的程序集属性。 ExportRenderer属性指示是否存在可以为Xamarin.Forms元素提供支持的自定义渲染器。
HelloRenderers.iOS项目包含以下HelloViewRenderer.cs文件,完整显示。 请注意using指令下的ExportRenderer属性。 因为这是一个程序集属性,所以它必须在名称空间声明之外。 这个特殊的ExportRenderer属性基本上表示“HelloViewRenderer类型的渲染器支持HelloView类”:

using Xamarin.Forms;
using Xamarin.Forms.Platform.iOS;
using UIKit;
using HelloRenderers;
using HelloRenderers.iOS;
[assembly: ExportRenderer(typeof(HelloView), typeof(HelloViewRenderer))]
namespace HelloRenderers.iOS
{
    public class HelloViewRenderer : ViewRenderer<HelloView, UILabel>
    {
        protected override void OnElementChanged(ElementChangedEventArgs<HelloView> args)
        {
            base.OnElementChanged(args);
            if (Control == null)
            {
                UILabel label = new UILabel
                {
                    Text = "Hello from iOS!",
                    Font = UIFont.SystemFontOfSize(24)
                };
                SetNativeControl(label);
            }
        }
    }
}

HelloViewRenderer类的定义遵循ExportRenderer属性。这堂课必须公开。它派生自通用的ViewRenderer类。这两个通用参数名为TView,它是Xamarin.Forms类,TNativeView是这个特殊情况下的类,是iOS的原生类。
在iOS中,显示文本的类是UIKit名称空间中的UILabel,这就是这里使用的内容。 ViewRenderer的两个泛型参数基本上说“一个HelloView对象实际上被渲染为iOS UILabel对象”。
ViewRenderer派生的一个基本工作是覆盖OnElementChanged方法。创建HelloView对象时调用此方法,其作用是创建用于呈现HelloView对象的本机控件。
OnElementChanged覆盖首先检查该类是否继承自ViewRenderer的Control属性。此Control属性由ViewRenderer定义为TNativeView类型,因此在HelloViewRenderer中它的类型为UILabel。第一次调用OnElementChanged时,此Control属性将为null。必须创建UILabel对象。这就是该方法的作用,为其分配一些文本和字体大小。然后将该UILabel方法传递给SetNativeControl方法。此后,Control属性将是此UILabel对象。
文件顶部的using指令分为三组:

  • ExportRenderer属性需要Xamarin.Forms命名空间的using指令,而ViewRenderer类需要Xamarin.Forms.Platform.iOS。
  • UILabel需要iOS UIKIt名称空间。
  • 仅对于ExportRenderer属性中的HelloView和HelloViewRenderer引用,需要HelloRenderers和HelloRenderers.iOS的using指令,因为该属性必须位于HelloRenderer.iOS命名空间块之外。

最后两个使用指令特别烦人,因为它们只需要一个目的。 如果您愿意,可以通过完全限定ExportRenderer属性中的类名来删除这两个使用指令。
这在以下渲染器中完成。 这是HelloRenderers.Droid项目中的完整HelloViewRenderer.cs文件。 用于显示文本的Android小部件是Android.Widget命名空间中的TextView:

using Xamarin.Forms;
using Xamarin.Forms.Platform.Android;
using Android.Util;
using Android.Widget;
[assembly: ExportRenderer(typeof(HelloRenderers.HelloView),
 typeof(HelloRenderers.Droid.HelloViewRenderer))]
namespace HelloRenderers.Droid
{
    public class HelloViewRenderer : ViewRenderer<HelloView, TextView>
    {
        protected override void OnElementChanged(ElementChangedEventArgs<HelloView> args)
        {
            base.OnElementChanged(args);
            if (Control == null)
            {
                SetNativeControl(new TextView(Context)
                {
                    Text = "Hello from Android!"
                });
                Control.SetTextSize(ComplexUnitType.Sp, 24);
            }
        }
    }
}

此HelloViewRenderer类派生自Android版本的ViewRenderer。 ViewRenderer的泛型参数表明Android TextView小部件支持HelloView类。
再次,在第一次调用OnElementChanged时,Control属性将为null。该方法必须创建本机Android TextView小部件并调用SetNativeControl。为了节省一点空间,新实例化的TextView对象直接传递给SetNativeControl方法。请注意,TextView构造函数需要Android Context对象。这是OnElementChanged的属性。
在调用SetNativeControl之后,ViewRenderer定义的Control属性是本机Android小部件,在本例中是TextView对象。该方法使用此Control属性在TextView对象上调用SetTextSize。在Android中,文本大小可以通过多种方式进行缩放。 ComplexUnitType.Sp枚举成员表示“缩放像素”,它与Xamarin.Forms处理Android中Label的字体大小的方式兼容。
这是HelloRenderers.UWP项目中的HelloViewRenderer的UWP版本:

using Xamarin.Forms.Platform.UWP;
using Windows.UI.Xaml.Controls;
[assembly: ExportRenderer (typeof(HelloRenderers.HelloView), 
 typeof(HelloRenderers.UWP.HelloViewRenderer))]
namespace HelloRenderers.UWP
{
    public class HelloViewRenderer : ViewRenderer<HelloView, TextBlock>
    {
        protected override void OnElementChanged(ElementChangedEventArgs<HelloView> args)
        {
            base.OnElementChanged(args);
            if (Control == null)
            {
                SetNativeControl(new TextBlock
                {
                    Text = "Hello from the UWP!",
                    FontSize = 24,
                });
            }
        }
    }
}

在所有Windows平台中,HelloView对象由Windows.UI.Xaml.Controls命名空间中的Windows运行时TextBlock呈现。
HelloRenderers.Windows和HelloRenderers.WinPhone项目中的HelloViewRenderer类大致相同,除了名称空间和用于设置TextBlock的Text属性的文本。
这是在三个标准平台上运行的程序:
2019_06_03_131710
注意如何通过使用HelloView对象上设置的常规HorizontalOptions和VerticalOptions属性来正确居中文本。 但是,您无法在HelloView上设置HorizontalTextAlignment和VerticalTextAlignment属性。 这些属性由Label定义,而不是由HelloView定义。
要将HelloView转换为用于显示文本的完整视图,您需要开始向HelloView类添加属性。 让我们来看看如何使用不同的示例将属性添加到渲染器。

目录
相关文章
|
Web App开发 iOS开发 Windows
ios获取原生系统应用的包名
ios获取原生系统应用的包名
3625 0
|
2月前
|
人工智能 PyTorch 云栖大会
亮点抢先看!AMD、中兴通讯等企业大咖解码下一代 OS|2026 云栖大会
一览来自 AMD、中兴通讯、阿里云、英特尔,以及上海交通大学等企业/高校专家的精彩金句和重磅议题。
|
2月前
|
人工智能 前端开发 API
阿里云百炼官网及控制台链接:获取 API‑Key、查询免费 Token 额度操作入口
阿里云百炼是其AI大模型服务平台,提供官网(介绍、计费、领免费Token)与控制台(API Key管理、Token用量查询、模型配置)双入口。新用户可领超7000万Tokens额度,支持按量付费、TokenPlan等多种计费方式。在阿里云百炼官网:https://t.aliyun.com/U/fPVHqY 免费领取千万Tokens
|
8月前
|
人工智能 运维 安全
开源知识库二次开发实操指南:模块化扩展与合规风险防控
在企业数字化转型进程中,知识管理的智能化、私有化与可扩展性成为技术团队核心诉求,传统文档管理因缺乏AI能力、集成性弱、部署繁琐等问题,已难以匹配现代研发与业务协作的效率需求。基于AGPL-3.0协议的AI大模型驱动开源知识库,以AI原生架构为核心,融合文档全生命周期管理、多端集成、私有化部署等能力,为企业构建智能化知识体系提供了轻量化且高扩展性的解决方案。本文将围绕“架构解析—能力落地—案例实践—合规指引—总结建议”的核心框架,结合实操心得,从技术架构特性、核心能力落地、实际应用案例及开源协议合规性等维度展开深度解析。
840 5
|
8月前
|
人工智能 自然语言处理 Java
Java企业AI转型:构建稳定可落地的AI能力
面向Java企业的AI赋能平台,以“智能中台+场景化方案”为核心,提供模型网关、RAG知识库、Agent开发、多模态支持等能力,实现低侵入、低成本、高稳定的老系统AI化改造与原生应用开发,加速智能化升级。(239字)
505 4
|
文字识别 计算机视觉 开发者
基于QT的OCR和opencv融合框架FastOCRLearn实战
本文介绍了在Qt环境下结合OpenCV库构建OCR识别系统的实战方法,通过FastOCRLearn项目,读者可以学习Tesseract OCR的编译配置和在Windows平台下的实践步骤,文章提供了技术资源链接,帮助开发者理解并实现OCR技术。
1112 9
基于QT的OCR和opencv融合框架FastOCRLearn实战
|
4月前
|
前端开发 Java Serverless
阿里云云联络中心对接使用完全指南:从SIP中继到API/SDK集成
本文系统阐述阿里云云联络中心(Cloud Contact Center)的对接使用全流程。首先介绍云联络中心作为全渠道云客服平台的核心能力与架构组成,包括坐席工作台、IVR可视化编排、智能路由引擎等子系统。随后详细说明对接前的账号注册、企业实名认证、RAM授权及实例创建等前置准备工作。在核心对接层面,深入拆解SIP Trunk中继对接的技术原理与配置流程,包括信令服务器与媒体服务器地址、端口范围、设备要求及自有号码接入步骤;同时全面介绍OpenAPI调用与多语言SDK(Java、Python、PHP、Go、TypeScript等)的集成方法,提供完整的Java SDK代码示例实现智能联络机器人
|
7月前
|
Java 大数据 双11
一张图看懂 Java 能干什么——从淘宝下单到双11抢货,背后都是它
本文专为Java零基础小白打造,用通俗比喻讲清Java本质(“万能翻译官”)、跨平台特性及核心优势;解析其在电商、支付等真实场景的应用;破除“Java已死”误区,结合数据说明其持续强势;并给出清晰入门路径与实用学习建议,助你科学起步。
一张图看懂 Java 能干什么——从淘宝下单到双11抢货,背后都是它
|
安全 网络协议
阿里云25端口解封教程完美解决25端口封禁的方法
阿里云出于安全考虑,默认封禁了TCP 25端口出方向的访问流量,所以用户无法使用25号端口邮件服务,云吞铺子分享25端口解封的方法: 阿里云25端口解封申请教程 用户想要使用25端口进行对外连接,可以在安全管控平台中提交25端口解封申请,可以参考官方文档(TCP 25端口解封申请- 阿里云),也可以参考下方云吞铺子的教程: 登录到阿里云管理控制台; 鼠标移动到头像,可以看到下拉菜单,点击“安全管控”如下图: 左侧栏“业务申请”--“25端口解封” 注意:在正式申请前,您需要确认同意并承诺,保证TCP 25端口仅用来连接第三方的SMTP服务器,从第三方的SMTP服务器外发邮件。
28125 1
|
人工智能 计算机视觉 Python
AI计算机视觉笔记八:基于mediapipe的虚拟绘画
该项目利用MediaPipe手部关键点识别技术,实现了隔空绘画功能。用户可以通过手势控制绘画工具,选择颜色或橡皮擦。环境配置基于`mediapipe_env`,在PyCharm中运行。项目包括两个文件:`AiVirtualPainter.py`负责绘画逻辑,`HandTrackingModule.py`用于手部关键点检测。此项目展示了AI技术在互动应用中的潜力,适合初学者实践与学习。
699 10