Write-only

Description

Removes an item from a collection of objects.

 VB Syntax

Object.Remove item

Variable

(Type) - Description

Object

Any of the following (objects)

• CalFactorSegments collection

• CalFactorSegmentsPMAR Collection

• Cal Sets collection

• Channels Collection

• ExternalDevices Collection

• GuidedCalibrationPowerSensors Collection

• Measurements collection

• NAWindows collection

• PowerLossSegments collection

• PowerLossSegmentsPMAR_Collection

• Segments collection

Note: Segments, CalFactorSegments, and PowerLossSegments  have an OPTIONAL argument [size] referring to the number of segments to remove, starting with the item parameter.

Note: Segments - When ALL segments are deleted, SweepType is automatically set to Linear because there are no segments to sweep.

item

(variant) - Collection Item number to be removed.

Note: The ExternalDevices Collection requires that you specify item as the string name of the device. For example:
extDevices.Remove ('mySource")

Return Type

Not Applicable

Default

Not Applicable

Examples

Measurements.Remove 3 'Removes the third measurement in the collection

segments.Remove 2,20 'Removes 20 segments (2 - 21)

C++ Syntax

HRESULT Remove(VARIANT index); //Measurements

HRESULT Remove(VARIANT index); //Cal Sets

HRESULT Remove(long windowNumber); //NAWindows

HRESULT Remove(VARIANT index, long size); //Segments

HRESULT Remove(VARIANT index, long size); //CalFactorSegments(PMAR)

HRESULT Remove(VARIANT index, long size); //PowerLossSegments(PMAR)

HRESULT Remove(BSTR name) //ExternalDevices

HRESULT Remove( VARIANT index) // Channels - specify collections index, not the channel number.

HRESULT Remove(VARIANT index); //GuidedCalibrationPowerSensors

Interface

All listed above

8-Feb-2011

Added GuidedCalibrationPowerSensors (9.33)

16-Sep-2010

Added channels (9.30)

31-Jul-2009

Added External Devices (9.0)