Chromium .Net Extension

(Available from version 7.0 onwards.)

The .NET Chromium extension lets you capture .NET Chromium Control screen elements for an embedded Chromium Browser Engine in your .NET application.

With this control, you can execute JavaScript code and directly access all objects on the web page, as well as their properties and methods.

Connector Features

The built-in .NET Chromium extension provides the following features:

Configure the Connector

No configuration is required for the .NET Chromium extension. This connector is enabled by default.

Capture a Screen Element

The procedure for capturing a .NET Chromium Control screen element is the same as for all screen elements. See Capture a Screen Element.

Edit a Screen Element

The Edit Screen Element window opens after capturing a screen element. This screen allows you to customize how the screen element is treated and identified. See Edit a Screen Element.

Information specific to .NET Chromium Control screen elements is provided below.

Element Hierarchy

The element hierarchy for a captured .NET Chromium Control screen elements is as follows:

  • Root branch for the NET Process

    • NET Form

      • NET captured screen element

See View the Element Hierarchy.

Screen Element Types Supported

The screen element type values available differ between levels in the hierarchy.

Type

Screen Element Types

NET Screen Element

  • NET General

  • NET Button

  • NET Hyperlink

  • NET Check Box

  • NET Combo

  • NET Edit

  • NET Form

  • NET List View

  • NEW List Box

  • NET Radio Button

  • NET Progress Bar

  • NET Slider

  • NET Up Down

  • NET Tab

  • NET Tree View

  • NET Grid

  • NET Tool Bar

  • NET Menu Strip

NET Form

  • NET Form
NET Process

  • NET Process

Recognition Properties Supported

The recognition properties available differ between levels in the hierarchy.

Property

Description
My Window Name is A window name where Win32 physical object is hosted.
My Window Class Name is The name of the class to which the specified physical object belongs (for example, BUTTON).
My Window Text is The text displayed in the control, for example, the text on a button.
My Window Type Name is The type of control, for example, Button.
My Window Z Order is

The window position in a stack of overlapping windows.

A window stack is oriented along an imaginary axis, the z-axis, extending outward from the screen. The window at the top of the z-order overlaps all other windows. The window at the bottom of the z-order is overlapped by all other windows.

When an application creates a window, the system puts it at the top of the z-order for windows of the same type.

You can change the z-order by activating a different window. The system positions the active window at the top of the z-order for windows of the same type. When a window comes to the top of z-order, so do its child windows.
My Window Visibility is

Identifies a window based on its visibility.

When the window is visible, the physical object is recognized.

When the window is hidden, the physical object is destroyed until the window becomes visible again.
My Window Relative Location is Identifies a window based on the location of its parent window. The format for this property's value is YYYYXXXX, where YYYY indicates the Y offset and XXXX indicates the X offset (including a leading zero) from the parent window. For example, the 00640078 value (see the screenshot above) indicates that the window location has an offset of (0064,0078) from its parent window.

Property

Description
My Process Name is Process name of the process in the process tree.
My Process Level is Process level in the process tree. Useful in a scenario where the application has more than one process on different levels.
My Parent Process Name is not Self property provides the name of the process, which can’t be a parent process (the process one level higher).

Main Relation Type

The element's main relation type is displayed in the Edit Screen Element window, but cannot be changed.

This section is not displayed for the NET process.

See Identify an Element's Main Relation Type.

Multi Instance Support

The .NET Chromium extension provides support for multiple instances.

You can specify which instance of the application to relate to if multiple instance of the same application are open.

Multi instance support differs between levels in the hierarchy.

Type

Multi Instance Support

NET Screen Element

Optional, inactive by default.
NET Form Optional, inactive by default.

NET Process

Active by default, cannot be deactivated.

See Set Multi Instance Behavior

Screen Element Assets

Each screen elements has its own properties, functions, and events. These are visible in the Assets Panel.

For information on screen element assets, see here.

Monitor Screen Elements in Debug Mode

When in debug mode, you can view and modify the values of a screen element's properties.

For example, the text displayed in the Address bar is displayed in the text box's Text field.

See Monitor Screen Elements in Execution Mode.