Write-only
About Triggering

Single Method


Description

Sets the trigger count to 1 which will cause the channel to respond once to the trigger source.

How the channel responds to a single trigger depends on the trigger mode (point, trace, and so forth.)

With the exception of the 'sync' argument, this command behaves like the channel 'single' setting from the user interface.

This setting has implications on Calibration. Learn more.

 VB Syntax

chan.Single [sync]

Variable

(Type) - Description

chan

A Channel (object)

[sync]

(boolean) -Optional argument.

  • True - The PNA waits (blocks execution) until the entire acquisition process is completed.

  • False - The PNA returns immediately - does NOT wait for acquisition to complete (non-blocking). Default setting.

When trigger source is set to Manual:

  • with sync = True, trigger source automatically changes to Internal which sends AND allows one trigger signal, then changes back to Manual.

  • with sync = False, a trigger signal must also be sent using app.ManualTrigger Method.

Return Type

Not Applicable

Default

Not Applicable

Examples

sync = True
chan.Single sync

C++ Syntax

HRESULT Single(VARIANT_BOOL bWait)

Interface

IChannel