下载示例

Xamarin.Forms Visual 允许创建呈现器并选择性地应用于 VisualElement 对象，而无需子类 Xamarin.Forms 视图。 指定类型的呈现器（作为其 ExportRendererAttribute的一IVisual部分）将用于在视图中呈现选择的呈现器，而不是默认呈现器。 在呈现器选择时， Visual 将检查视图的属性并将其包含在呈现器选择过程中。

重要

目前，呈现 Visual 视图后无法更改属性，但将来的版本中会更改该属性。

创建和使用 Xamarin.Forms 可视呈现器的过程是：

有关创建呈现器类的信息，请参阅 自定义呈现器。 但请注意 Xamarin.Forms ，视觉对象呈现器无需对视图进行子类化即可应用于视图。

此处概述的呈现器类实现一个使用阴影显示其文本的自定义 Button 。

下面的代码示例演示适用于 iOS 的按钮呈现器：

以下代码示例演示适用于 Android 的按钮呈现器：

在跨平台库中，创建派生自 IVisual的类型：

CustomVisual然后，可以针对呈现器类注册类型，从而Button允许对象选择使用呈现器。

在平台项目中，在程序集级别添加 ExportRendererAttribute ：

在此 iOS 平台项目的示例中， ExportRendererAttribute 指定 CustomButtonRenderer 类将用于呈现使用 Button 对象，类型 IVisual 注册为第三个参数。 指定类型的呈现器（作为其 ExportRendererAttribute的一IVisual部分）将用于在视图中呈现选择的呈现器，而不是默认呈现器。

对象 Button 可以通过将其 Visual 属性设置为 Custom来选择使用呈现器类：

注意

在 XAML 中，类型转换器无需在属性值中包含 Visual “Visual”后缀。 但是，也可以指定完整类型名称。

等效 C# 代码如下：

在呈现器选择时， Visual 的 Button 属性将被检查并包含在呈现器选择过程中。 如果未找到呈现器， Xamarin.Forms 将使用默认呈现器。

以下屏幕截图显示了呈现 Button的 ，它显示带有阴影的文本：

屏幕截图

VisualAttribute可用于选择性地为IVisual类型注册不同的名称。 此方法可用于解决不同视觉对象库之间的命名冲突，或者你只想使用不同于其类型名称的名称来引用视觉对象时。

VisualAttribute应在跨平台库或平台项目中的程序集级别定义 ：

IVisual然后，可以通过其注册名称来使用类型：

注意

通过注册名称使用视觉对象时，必须包含任何“Visual”后缀。