Notational Conventions

This section describes the notational conventions used for the description of commands reference.

Object Type

Object type describes different types of E5052B COM objects. The E5052B provides properties and methods as COM objects. COM objects which set (send)/read (return) the state of the E5052B using variables are defined as property and COM objects which does other processing are defined as method.

COM objects used only to read the state of the E5052B are indicated with "Read-only" and ones used only to set the state of the E5052B are indicated by "Write-only" . COM object that can both read and write data to the E5052B are indicated by 'Read-Write'.

Syntax

Syntax describes the syntax for sending a COM object from the E5052B VBA to the E5052B. The syntax consists of two parts: the object part and the set/read part, with an equal "=" inserted between them. Variables are indicated by italicized letters. Variables with () are indices. For indices with () having their preset values, you can omit "(variable)," and, if omitted, the preset values are automatically set.

The following table describes the 3 types of syntax for coding using objects:

Type

Description

"Object (property) = variable":

Set the stat of the E5052B.

variable=object (property):

Read the stat of the E5052B.

"Object (method)":

Perform some processing in the E5052B.

Description

Description describes how to use the COM object or the operation when executed.

Type

Description

Ch

Number of channels. For all measurement menus the number of channel is 1.

Tr

Number of traces.

  • For PN, SP, AM, PS and BB, number of trace is 1.

    For FP, number of trace is 3.

    For TR, number of trace is 8.

Mk

Number of markers. For all measurement menus the number of marker is 10.

Nr

Number of narrow is 2.

  • TR use only.

 

 

Variable

Variable provides description about different variables that can be used with the COM objects. It gives the description, data type, allowable range, preset value, unit, resolution, and notes for variable (italic) shown in the syntax.

The data types of the E5052B COM objects include 5 types as shown in the following table. Before using variables, declare the data type of each variable. If you do not declare the data type of a variable, it is automatically processed as a variant type.

Data type

Name

Consumed memory

Range

Long

Long integer type

4 bytes

-2,147,483,648 to 2,147,483,647

Double

Double precision floating point type

8 bytes

For a negative value:
-1.79769313486232E+308 to -4.94065645841247E-324

For a positive value:
-1.79769313486232E+308 to -4.94065645841247E-324

Boolean

Boolean type

2 bytes

For COM: True or False

(For SCPI: ON or OFF)

String

Character string type

1 byte / alphanumeric character

Up to approximately 2 billion characters

Variant

Variant type

16 bytes

No limitation

Examples

Examples provides a sample example of using the object through coding with the E5052B VBA.

Related Objects

Related objects provides information about other objects that are similar/related with the object.

Equivalent Key

Equivalent key shows the operational procedure of the front panel keys that has the same effect as this object.

Equivalent SCPI command

Equivalent SCPI command shows the SCPI command to execute from an external controller.  Its syntax, query response, and example of use are provided.