com.teamdev.jxbrowser.chromium

Enum BrowserType

java.lang.Object

java.lang.Enum<BrowserType>

com.teamdev.jxbrowser.chromium.BrowserType

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable< BrowserType>

public enum BrowserType
extends java.lang.Enum<BrowserType>

Provides set of supported browser types.

提供一组受支持的浏览器类型。

Enum Constant Summary

Enum Constants

Enum Constant and Description
HEAVYWEIGHT Indicates that Browser instance will be initialized as a heavyweight component.
LIGHTWEIGHT Indicates that Browser instance will be initialized as a lightweight (off-screen) component.

Method Summary

Modifier and Type	Method and Description
static BrowserType	getDefault() Returns BrowserType provided via the "jxbrowser.browser.type" System Property. 返回通过“ jxbrowser.browser.type”系统属性提供的BrowserType。
static BrowserType	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name. 返回具有指定名称的此类型的枚举常量。
static BrowserType[]	values() Returns an array containing the constants of this enum type, in the order they are declared. 以声明顺序返回包含此枚举类型的常量的数组。

Methods inherited from class java.lang.Enum

compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

LIGHTWEIGHT

public static final BrowserType LIGHTWEIGHT

Indicates that Browser instance will be initialized as a lightweight (off-screen) component. In this mode Chromium engine renders web page content off-screen and Java component just displays rendering results as image using standard Java Graphics API.

In this mode GPU acceleration in Chromium engine isn't used. As result, rendering performance isn't so good as with enabled GPU acceleration.

It's recommended to configure Browser instance with this type in Java Swing/JavaFX applications where lightweight is the main requirements. For example, when transparent JPanel should be displayed over BrowserView component, or when BrowserView component is embedded into JInternalFrame or layered panels.

指示浏览器实例将被初始化为轻量级（屏幕外）组件。在此模式下，Chromium引擎可在屏幕外呈现网页内容，而Java组件仅使用标准Java图形API将呈现结果显示为图像。在此模式下，不使用Chromium引擎中的GPU加速。结果，渲染性能不如启用的GPU加速好。建议在主要要求轻量级的Java Swing / JavaFX应用程序中使用此类型配置Browser实例。例如，当应该在BrowserView组件上显示透明的JPanel时，或者将BrowserView组件嵌入到JInternalFrame或分层面板中时。

HEAVYWEIGHT

public static final BrowserType HEAVYWEIGHT

Indicates that Browser instance will be initialized as a heavyweight component. Heavyweight components represents a native window embedded into Java frame.

In this mode Chromium uses GPU acceleration to render web page content directly onto an embedded into Java frame window. Rendering performance in this case is the same as in Google Chrome.

It's recommended to configure Browser instance with this type in Java applications where rendering performance is very critical (e.g. displaying video or WebGL content). Since BrowserView represents a native heavyweight window embedded into Java application's frame, it's not recommended to display lightweight Swing/JavaFX components over heavyweight BrowserView component. The heavyweight BrowserView component will be always displayed over lightweight Swing/JavaFX components.

指示浏览器实例将被初始化为重量级组件。重量级组件表示嵌入Java框架的本机窗口。在此模式下，Chromium使用GPU加速将网页内容直接呈现到嵌入Java框架窗口中。在这种情况下，渲染性能与Google Chrome浏览器相同。建议在渲染性能非常重要的Java应用程序中（例如，显示视频或WebGL内容）使用这种类型的Browser实例进行配置。由于BrowserView表示嵌入到Java应用程序框架中的本机重量级窗口，因此不建议在重量级BrowserView组件上显示轻量级的Swing / JavaFX组件。重量级的BrowserView组件将始终显示在轻量级的Swing / JavaFX组件上。

Method Detail

values

public static BrowserType[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (BrowserType c : BrowserType.values())
    System.out.println(c);

以声明顺序返回包含此枚举类型的常量的数组。此方法可用于如下迭代常量： 对于（BrowserType c：BrowserType.values（）） 的System.out.println（C）;

Returns:

an array containing the constants of this enum type, in the order they are declared 包含此枚举类型的常量的数组，按其声明的顺序

valueOf

public static BrowserType valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

返回具有指定名称的此类型的枚举常量。该字符串必须与用于声明此类型的枚举常量的标识符完全匹配。 （不允许使用多余的空格字符。）

Parameters:

name - the name of the enum constant to be returned. -要返回的枚举常量的名称。

Returns:

the enum constant with the specified name 具有指定名称的枚举常量

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

getDefault

public static BrowserType getDefault()

Returns BrowserType provided via the "jxbrowser.browser.type" System Property. If the System Property isn't specified, this method returns HEAVYWEIGHT value.

To configure default BrowserType use the following System Property values: jxbrowser.browser.type=LIGHTWEIGHT or jxbrowser.browser.type=HEAVYWEIGHT.

返回通过“ jxbrowser.browser.type”系统属性提供的BrowserType。如果未指定系统属性，则此方法返回HEAVYWEIGHT值。要配置默认的BrowserType，请使用以下系统属性值：jxbrowser.browser.type = LIGHTWEIGHT或jxbrowser.browser.type = HEAVYWEIGHT。

Returns:

default BrowserType value. 默认值。