NearestSelection Property

Summary

Gets the index of the video capture input that was last selected in the video cross bar property page.

Syntax
C#
VB
C++
public int NearestSelection { get; } 
Public ReadOnly Property NearestSelection As Integer 
public: 
property int NearestSelection { 
   int get(); 
} 

Property Value

The zero-based index of the nearest selected item; or -1 if no item is selected.

Remarks

If the Selection is -1, despite the fact there is a selected input, then the selected video capture input does not match the selected audio input. In this case, check the value of the NearestSelection property to retrieve the index of the last selected capture input. Set the Selection property to the value in the NearestSelection property to fix the problem. Please note that if an audio-video pair are mismatched intentionally, it may be best to keep the pair mismatched. For more information on unmatched pairs of video and audio inputs, refer to the CaptureInputs object.

Example
C#
VB
using Leadtools; 
using Leadtools.Multimedia; 
using LeadtoolsMultimediaExamples.Fixtures; 
 
public bool _result = false; 
public CaptureCtrlForm _form = new CaptureCtrlForm(); 
 
public void NearestSelectionExample() 
{ 
   // reference the capture control and its video inputs 
   CaptureCtrl capturectrl = _form.CaptureCtrl; 
 
   // set a video device first.  use your video device's name here 
   if (capturectrl.VideoDevices["Analog"] == null) 
      throw new Exception("No Analog video tuner device available"); 
 
   capturectrl.VideoDevices["Analog"].Selected = true; 
 
   // set a video device first.  use your video device's name here 
   if (capturectrl.AudioDevices["Analog"] == null) 
      throw new Exception("No matching Analog audio device available"); 
 
   capturectrl.AudioDevices["Analog"].Selected = true; 
 
   try 
   { 
      // get the video inputs collection 
      CaptureInputs videoInputs = capturectrl.VideoInputs; 
 
      // select the video tuner input 
      videoInputs["Video Tuner"].Selected = true; 
 
      // select the nearest selection to the last selection 
      videoInputs.Selection = videoInputs.NearestSelection; 
 
      // set the result to what we expect 
      _result = true; 
   } 
   catch (Exception) 
   { 
      _result = false; 
   } 
} 
Imports Leadtools 
Imports Leadtools.Multimedia 
Imports LeadtoolsMultimediaExamples.Fixtures 
 
Public _result As Boolean = False 
Public _form As CaptureCtrlForm = New CaptureCtrlForm() 
 
Public Sub NearestSelectionExample() 
   ' reference the capture control and it's video inputs 
   Dim capturectrl As CaptureCtrl = _form.CaptureCtrl 
 
   ' set a video device first, you should use your video device name here 
   If capturectrl.VideoDevices("Analog") Is Nothing Then 
      Throw New Exception("No Analog video tuner device available") 
   End If 
 
   capturectrl.VideoDevices("Analog").Selected = True 
 
   ' set a video device first, you should use your video device name here 
   If capturectrl.AudioDevices("Analog") Is Nothing Then 
      Throw New Exception("No matching Analog audio device available") 
   End If 
 
   capturectrl.AudioDevices("Analog").Selected = True 
 
   Try 
      ' get the video inputs collection 
      Dim videoInputs As CaptureInputs = capturectrl.VideoInputs 
 
      ' select the video tuner input 
      videoInputs("Video Tuner").Selected = True 
 
      ' select the nearest selection to the last selection 
      videoInputs.Selection = videoInputs.NearestSelection 
 
      ' set the result to what we expect 
      _result = True 
   Catch e1 As Exception 
      _result = False 
   End Try 
End Sub 

Requirements

Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Multimedia Assembly