# :MEASure:LIST:ITEM{N}:REGion

Results Panel List Commands

- :MEASure:LIST:CLEar
- :MEASure:LIST:ITEM{N}:COUNt?
- :MEASure:LIST:ITEM{N}:COUNt:STATus?
- :MEASure:LIST:ITEM{N}:COUNt:STATus:REASon?
- :MEASure:LIST:ITEM{N}:CURRent?
- :MEASure:LIST:ITEM{N}:MAXimum?
- :MEASure:LIST:ITEM{N}:MAXimum:STATus?
- :MEASure:LIST:ITEM{N}:MAXimum:STATus:REASon?
- :MEASure:LIST:ITEM{N}:MEAN?
- :MEASure:LIST:ITEM{N}:MEAN:STATus?
- :MEASure:LIST:ITEM{N}:MEAN:STATus:REASon?
- :MEASure:LIST:ITEM{N}:MINimum?
- :MEASure:LIST:ITEM{N}:MINimum:STATus?
- :MEASure:LIST:ITEM{N}:MINimum:STATus:REASon?
- :MEASure:LIST:ITEM{N}:NAME?
- :MEASure:LIST:ITEM{N}:OCCurrences
- :MEASure:LIST:ITEM{N}:REGion
- :MEASure:LIST:ITEM{N}:SDEViation?
- :MEASure:LIST:ITEM{N}:SDEViation:STATus?
- :MEASure:LIST:ITEM{N}:SDEViation:STATus:REASon?
- :MEASure:LIST:ITEM{N}:SOURce
- :MEASure:LIST:ITEM{N}:STATus?
- :MEASure:LIST:ITEM{N}:STATus:DETails?
- :MEASure:LIST:ITEM{N}:STATus:REASon?
- :MEASure:LIST:MOVE
- :MEASure:LIST:REMove
- :MEASure:LIST:SELect
- :MEASure:RESults?

## Command Syntax

    :MEASure:LIST:ITEM{N}:REGion {DISPlay | WAVeform | REGion{1:8}}

Where {N} is a number from 1 to 64 that identifies a measurement row in the Results table. For example, `ITEM4`.

## Query Syntax

    :MEASure:LIST:ITEM{N}:REGion?

## Query Response

    {DISP | WAV | REG{1:8})

## Description

Changes, applies, or removes a region on an existing measurement that is listed in the Results table. The item number identifies the measurement in the table. The measurement's identifying item number starts at 1 at the top of table and increment down the table. If more that one measurement is displayed per row, the measurements are numbered starting at the tables top-left corner and is incremented row-column ending in the tables bottom right corner.

DISPlay
  The measurement is performed on on-screen data only.
WAVeform
  The measurement is performed on all waveform data, whether the data is displayed on-screen or not.
REGion{1:8}
  The measurement is performed across one of eight regions. Regions are defined using the `:REGions:REGion{N}:STATe` command.

This setting can affect analysis as waveforms are moved horizontally. For example, a Rise Time measurement is made on the first edge. When DISPlay is selected and a waveform is moved horizontally, as different edges become the first on the screen, the measurement moves to those different edges. When WAVeform is selected, the measurement remains on the first edge in the data even when that edge is moved horizontally off the screen.

The `:MEASure:LIST:SELect` command is not related to this task.

## Example Command Sequence

To change the region for an existing rise time measurement in the first row of the Results table. The measurement is made over region 1 and region 2.

    :REGions:REGion1:STATe ON  # create on 2 regions
    :REGions:REGion2:STATe ON  # create on 2 regions
    :REGions:REGion1:X1 6.739E-11  # define regions
    :REGions:REGion1:X2 1.4142E-10
    :REGions:REGion2:X1 7.5142E-10
    :REGions:REGion2:X2 8.5142E-10
    :MEASure:HORizontal:RTIMe:SOURce CHAN1_1  # select source
    :MEASure:HORizontal:RTIMe:REGion REGion1  # select region 1
    :MEASure:HORizontal:TEDGe:EDIRection RISing   # select rising edge
    :MEASure:HORizontal:RTIMe
    :MEASure:HORizontal:RTIMe?
    :MEASure:LIST:ITEM1:REGion REGion2  # change measurement to region 2
    :MEASure:HORizontal:RTIMe:REGion REGion2  # match results table region selection
    :MEASure:HORizontal:RTIMe?

## Related Commands

- `:MEASure:LIST:CLEar` Clears the results table.
- `:MEASure:LIST:ITEM{N}:OCCurrences` Selects between `ONE` (edge-related measurement per acquisition) or `ALL` (multiple measurements per acquisition using all edges in the acquisition).
- `:MEASure:LIST:ITEM{N}:SOURce` Changes the source of an existing measurement in the results table.
- `:MEASure:LIST:MOVE` Moves a measurement from one location to another in the results table.
- `:MEASure:LIST:REMove` Removes single measurement from the results table.
- `:MEASure:LIST:SELect` Selects single measurement in the results table.