缩放

本指南描述了如何使用 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