LEADTOOLS Multimedia (Leadtools.Multimedia assembly) Send comments on this topic. | Back to Introduction | Help Version 17.0.3.22
NearestSelection Property
See Also 
Leadtools.Multimedia Namespace > CaptureInputs Class : NearestSelection Property



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

Syntax

Visual Basic (Declaration) 
Public ReadOnly Property NearestSelection As Integer
Visual Basic (Usage)Copy Code
Dim instance As CaptureInputs
Dim value As Integer
 
value = instance.NearestSelection
C# 
public int NearestSelection {get;}
C++/CLI 
public:
property int NearestSelection {
   int get();
}

Property Value

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

Example

Visual BasicCopy Code
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
C#Copy Code
public bool _result = false;
public CaptureCtrlForm _form = new CaptureCtrlForm();
public void NearestSelectionExample()
{
   // reference the capture control and it's video inputs
   CaptureCtrl capturectrl = _form.CaptureCtrl;

   // set a video device first, you should use your video device 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, you should use your video device 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;
   }
}

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.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also