缩放

本指南介绍如何使用 DotNetBrowser Zoom API。

DotNetBrowser 允许缩放一个网页或所有网页的内容、在网页缩放级别发生变化时接收通知、覆盖默认缩放级别以及其他功能。

要使用应用于所有网页的全局缩放，请使用 IEngine.ZoomLevels 属性。 该属性的实例可从 Profile 获取。 例如：

IZoomLevels zoomLevels = profile.ZoomLevels;

Dim zoomLevels As IZoomLevels = profile.ZoomLevels

如果使用 IEngine.ZoomLevels ，则会获得与默认配置文件关联的 IZoomLevels 服务。

要控制在 IBrowser 实例中加载的网页的缩放，请使用 IBrowser.Zoom 属性。

默认缩放级别

所有网页的默认缩放级别为 100%。 您可以使用 IZoomLevels.DefaultLevel 属性来进行更改。

下面的代码示例将所有网页的默认缩放级别设置为 150%：

engine.Profiles.Default.ZoomLevels.DefaultLevel = Level.P150;

engine.Profiles.Default.ZoomLevels.DefaultLevel = Level.P150

控制缩放

您可以使用 IZoom 实例或使用触摸屏环境中的触摸手势，以编程方式缩放 IBrowser 中加载的网页内容。

缩放级别是为每台主机单独配置的。 如果您为 http://www.a.com 网页设置缩放级别，它不会影响 http://www.b.com 网页。

要更改缩放级别，您需要等待直到网页完全加载完毕。

放大

要放大当前加载的网页，请使用以下方法：

browser.Zoom.In();

browser.Zoom.In()

缩小

要缩小当前加载的网页，请使用以下方法：

browser.Zoom.Out();

browser.Zoom.Out()

设置缩放级别

以下代码示例将已加载网页的缩放级别设置为 200%：

browser.Zoom.Level = Level.P200;

browser.Zoom.Level = Level.P200

重置缩放

要将缩放级别重置为默认值，请使用以下代码示例：

browser.Zoom.Reset();

browser.Zoom.Reset()

禁用缩放

您可以使用 IZoom.Enabled 属性禁用 IBrowser 中加载的所有网页的缩放。 它启用或禁用缩放功能并将缩放级别重置为默认值。 在那之后 任何使用 DotNetBrowser Zoom API 和
触摸屏设备上的触摸手势以编程方式更改缩放级别的尝试都会被忽略。

例如：

browser.Zoom.Enabled = false;

browser.Zoom.Enabled = False

缩放事件

要获取特定网页的缩放级别更改通知，请使用 ZoomChanged 事件。 请参阅以下代码示例：

engine.Profiles.Default.ZoomLevels.LevelChanged += (s, e) =>
{
    string hostUrl = e.Host;
    Level zoomLevel = e.Level;
};

AddHandler engine.Profiles.Default.ZoomLevels.LevelChanged, Sub(s, e)
    Dim hostUrl As String = e.Host
    Dim zoomLevel As Level = e.Level
End Sub