ConfigureTrigger Method
- Updated2023-02-21
- 3 minute(s) read
Configures the scan triggers for the scan list established with SwitchScan.ConfigureList.
Refer to Device Help to determine if the switch module supports scanning.
SwitchScan.ConfigureTrigger sets the location that the switch expects to receive an input trigger to advance through the SwitchScan.List. This method also sets the location where it outputs a scan advanced signal after it completes an entry in the scan list.
Namespace:
NationalInstruments.ModularInstruments.NISwitch
Assembly:
NationalInstruments.ModularInstruments.NISwitch.Fx40 (in NationalInstruments.ModularInstruments.NISwitch.Fx40.dll) Version: 19.0.0.49152 (19.0.0.49152)| Visual Basic (Declaration) |
|---|
Public Sub ConfigureTrigger ( _ scanDelay As PrecisionTimeSpan, _ triggerInput As String, _ advancedOutput As String _ ) |
| C# |
|---|
public void ConfigureTrigger( PrecisionTimeSpan scanDelay, string triggerInput, string advancedOutput ) |
Parameters
- scanDelay
- The minimum length of time you want the switch to wait after it creates a path until it asserts a trigger on the scan advanced output line. The driver uses this value to set the SwitchScan.Delay attribute. The SwitchScan.Delay is in addition to the SwitchCharacteristics.SettlingTime. Express this value in seconds. The default value is 0.0 s.
- triggerInput
- Type: System..::.StringTrigger source you want the switch module to use during scanning. The driver uses this value to set the SwitchScan.TriggerInput attribute. The switch waits for the trigger you specify when it encounters a semicolon in the scan list. When the trigger occurs, the switch advances to the next entry in the scan list. Refer to NISwitch.SwitchScanTriggerInput for a list of valid values.
- advancedOutput
- Type: System..::.StringOutput destination of the scan advanced trigger signal. NI-SWITCH uses this value to set the SwitchScan.AdvancedOutput attribute. After the switch processes each entry in the scan list, it waits the length of time you specify in the SwitchScan.Delay parameter and then asserts a trigger on the line you specify with this parameter. Refer to NISwitch.SwitchScanAdvancedOutput for a list of valid values
Exceptions
| Exception | Condition |
|---|---|
| ObjectDisposedException | The ConfigureTrigger method was accessed after the associated NISwitch.NISwitch object was disposed. |